Skip to main content
    Open-source platform for teaching the Quran

    Live Tajweed circles,
    with tools built for the Quran

    Run your halaqah, correct Tajweed directly on the Mushaf, and track your students' progress — in one open and free platform.

    ✓ Open source · ✓ Free forever · ✓ AGPL-3.0 · ✓ On GitHub

    سورة الفاتحةالصفحة ١
    المَقْرَأَة١

    Today's tools weren't made for the Quran

    Three problems every Tajweed teacher knows

    Zoom doesn't know the Quran

    No Mushaf, no ayah tracking, no error logging. Just a camera and a microphone.

    WhatsApp loses the history

    Messages disappear, recordings get lost, student progress is never saved.

    Spreadsheets are exhausting

    Excel and Word for attendance and grades drain your time instead of teaching the Quran.

    Three tools in one platform

    ٱلْفَاتِحَة

    بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ

    بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ ١
    ٱلْحَمْدُ لِلَّهِ رَبِّ ٱلْعَٰلَمِينَ ٢
    ٱلرَّحْمَٰنِ ٱلرَّحِيمِ ٣
    مَٰلِكِ يَوْمِ ٱلدِّينِ ٤
    إِيَّاكَ نَعْبُدُ وَإِيَّاكَ نَسْتَعِينُ ٥ ٱهْدِنَا
    👍أحسنت
    💬ملاحظة
    أعد
    خطأ

    The Madinah Mushaf, in sync with your circle

    Live interactive Mushaf

    The official QCF Mushaf with all 604 pages, with the current ayah tracked live for every student. Word-level interaction.

    Learn more about the Mushaf →

    ٱهْدِنَا ٱلصِّرَٰطَ ٱلْمُسْتَقِيمَ

    لحن خفي · التفخيم

    الطاءُ في «ٱلصِّرَٰطَ» مفخّمة — أخرجها من أقصى اللسان بعد الصادِّ المشدَّد والراء.

    Clear and subtle errors, one tap away

    One-tap Tajweed correction

    Tap a word, choose the error from 14 classical categories, add a note. Your student sees the correction instantly — without interrupting the recitation.

    Read about the methodology →
    114 surahs42 completed
    CompletedIn progressNot started

    A real Tajweed history for every student

    Track every student, ayah by ayah

    Surahs covered, pages, star ratings, grade distribution, streaks. Every recitation saved, every step visible.

    Discover the tracking system →

    Start your circle in three steps

    1. 1

      Create your circle

      Choose the circle name, its type (Tajweed / Memorization / Recitation), and the time. In under a minute.

    2. 2

      Invite your students

      Send a link or have students add themselves. Attendance is logged automatically each session.

    3. 3

      Begin the recitation

      Pick a student, open the Mushaf, mark errors, save progress. Everything in one place.

    Built by Quran teachers, for Quran teachers

    Maqraa is an open-source project, carefully built to serve Quran teachers — not to profit from them. We use a classical taxonomy of Tajweed errors drawn from the science of Tajweed (laḥn jalī, laḥn khafī), and we lean on documented Quranic tools from Quran.com (Quran Foundation).

    • Full privacy for your recitations
    • Classical Tajweed methodology
    • Partnership with Quran.com
    Read more about our mission →
    terminal
    $ git clone https://github.com/ghhamza/maqraa
    $ cd maqraa && docker compose up
    $ open http://localhost:3000
    
    # Your platform, on your server.
    AGPL-3.0

    Every line of code is open to all

    Because learning the Quran shouldn't be paywalled or closed. Every line of Maqraa is open to read, modify, and self-host. Forever.

    Integrated with the digital Quranic ecosystem

    We collaborate with Quran Foundation — the foundation behind Quran.com — to deliver a documented learning experience.

    Single sign-on

    Sign in with your Quran.com account directly.

    Progress sync

    Your Quran.com streak syncs with your Maqraa activity.

    Reference recitations

    Hear the ayah by leading reciters before recitation.

    Quran Foundation is a 501(c)(3) non-profit based in New York, founded in 2016. It runs Quran.com and 17+ digital Quranic services.

    Start your first halaqah, free

    No credit card. No limited trial. Open and free forever.

    Or self-host on your own server if you prefer.