Skip to main content
    About the project

    Maqraa — a platform for teaching the Quran

    An open-source project serving Quran teachers, everywhere.

    Maqraa is an open-source platform for managing remote Quran-teaching halaqat, with a particular focus on learning Tajweed. It was built to meet the needs of teachers who teach Tajweed online — for whom the available tools were either generic (Zoom, WhatsApp), closed, or paid.

    The platform brings together an interactive Mushaf (using the official QCF font from the King Fahd Complex), a correction system grounded in the classical Tajweed error taxonomy, and a permanent record of every student's progress. All in a single platform — open source, usable for free on app.maqraa.org or hostable on a private server.

    Project values

    Fully open

    The code is on GitHub under the AGPL-3.0 license. Every update, every technical decision, every change — visible to everyone.

    Free for teachers

    The core platform is free, forever. Optional institute services are separate and never affect the platform's free access.

    Faithful to the tradition

    We use the classical Tajweed taxonomy. No invention, no oversimplification — full respect for the scholarly tradition.

    Acknowledgments

    Maqraa stands on the shoulders of many institutions and projects

    Quran Foundation

    For providing a documented Quranic data API, OAuth integration, and reference recitations from leading reciters.

    King Fahd Complex for the Printing of the Holy Quran

    For the QCF V2 fonts that the Mushaf rendering relies on.

    Tanzil.net

    For the documented Uthmani text, the most important digital reference for the Holy Quran.

    DigitalKhatt

    For pioneering work in digitizing the Mushaf with typographic precision. Our early experimentation with DigitalKhatt helped shape the project's direction, even though we ended up using QCF V2.

    Classical Tajweed scholars

    For a scholarly heritage spanning centuries, which laid the foundation our platform stands on.

    Contact

    Have a question, a suggestion, or want to contribute? We'd love to hear from you.