Text integrity

Every āyah on AyaSeerah comes from a 100% verified public source

We do not keep our own copy of the Qur'an. Arabic and translation are fetched live, per āyah, from published sources you can check yourself.

  • Arabic and translation come from Quran.com's public API, live.
  • Every verse carries its verse key so you can verify it independently.
  • Seerah material is graded by the strength of its evidence, never blurred.

Don't take our word for it — check an āyah right now

Trust in a Qur'an app should be verifiable, not asserted. This runs the same request the surah pages run.

VERIFY IT YOURSELF

Enter any verse key. Your browser calls the same public endpoint AyaSeerah calls — no AyaSeerah server in between. The request URL is shown so you can paste it into your own browser and compare.

TESTING PROTOCOL

How Qur'anic apps are tested for compliance — and how that applies here

There is no single global certification for Qur'an apps. In practice, compliance means two things: the Arabic text must be provably identical to a certified muṣḥaf, and the interpretive content must be attributable to named scholarship. Regional bodies — KFGQPC in Saudi Arabia, LPMQ in Indonesia — review muṣḥaf editions on exactly those grounds, and their criteria translate directly into automated tests.

  1. 01

    Source-of-truth binding

    Text and translation are never hand-typed. Each āyah is requested by verse key (e.g. 18:10) from the Quran.com v4 API, and the verse key is printed next to the āyah so any reader can verify it against the same endpoint.

  2. 02

    Character-level diff against a reference text

    The standard compliance test for Qur'anic software: normalise (NFC), strip presentation-only marks, and diff every āyah against the Tanzil Uthmānī text. Any non-zero diff fails the build. This is the method muṣḥaf-review bodies (KFGQPC, Indonesia's LPMQ) apply to printed and digital muṣḥaf.

  3. 03

    Checksum manifest

    A per-āyah SHA-256 hash, rolled up to per-sūrah and whole-muṣḥaf root hashes. Cached or bundled text is verified against the manifest before it is displayed, guarding against corrupted downloads or tampered copies.

  4. 04

    Structural assertions

    6,236 āyāt, 114 sūrahs, correct āyah counts per sūrah, basmalah handling (present except at-Tawbah, counted only in al-Fātiḥah), and sajdah markers in the right places. These are cheap automated tests that catch the majority of real-world Qur'an app defects.

  5. 05

    Rendering and orthography checks

    Right-to-left order, diacritic stacking, small alif and hamzat al-waṣl preserved, no line-break inside a word, and no autocorrect/font substitution — verified visually per device, because a correct string can still render wrongly.

  6. 06

    Fail-safe behaviour

    If the API is unreachable, AyaSeerah shows stored text explicitly labelled as such rather than silently degrading — and never invents, paraphrases or AI-generates a single word of Qur'anic text.

  7. 07

    Tajwīd colouring is sourced, not computed

    In the tajwīd view the reader sees the same per-word muṣḥaf glyph codes the printed page uses, drawn with the QCF v4 tajwīd page fonts — the fonts behind Quran.com's own tajwīd view — in which every rule colour is baked into the letter shape itself, so colour can never spill across a joined letter. The API's annotated script (text_uthmani_tajweed) is spot-checked against a printed tajwīd muṣḥaf across a sample covering each rule type (madd, ghunnah, qalqalah, idghām with and without ghunnah, ikhfāʾ, iqlāb) and remains the coloured fallback while page fonts load, and the text screen readers, copy and search use. Where the API returns no annotation for an āyah, that Unicode text is shown with a visible 'tajwīd markup unavailable' notice rather than uncoloured text presented as complete.

  8. 08

    Attribution instead of certification

    Automation proves the Arabic string is right; it cannot prove that a tafsīr summary is faithful. AyaSeerah is not scholar-certified and does not claim a standing review board. Its safeguard is attribution: every commentary note, asbāb al-nuzūl narration and takeaway names its classical source (Ibn Kathīr, al-Qurṭubī, al-Ṭabarī, aṭ-Ṭabarānī, Bukhārī/Muslim) so a qualified reader can audit it, and reported corrections are applied.

WHERE AYASEERAH ACTUALLY STANDS

The protocol, scored honestly

Publishing a protocol is easy; claiming to have passed all of it would be dishonest. Here is what is live today and what is still to come.

CHECKSTATUSNOTE
Source-of-truth binding (live API, no hand-typed text)In placeEvery āyah requested by verse key at read time.
Verse key shown beside each āyahIn placePrinted in the UI for reader-side verification.
Structural assertions (114 sūrahs, āyah counts, basmalah rules)In placeAll 114 sūrahs are authored and mapped to the revelation-order phases; counts come from the API's own chapter metadata, not from our files.
Labelled fail-safe fallbackIn placeIf the API is unreachable the stored text is shown and explicitly marked.
Tajwīd colour-coding from the API's annotated scriptIn placeThe tajwīd view renders Quran.com's coloured muṣḥaf: QCF v4 tajwīd page fonts with every rule colour baked into the letter shapes, addressed by the API's per-word glyph codes. The API's text_uthmani_tajweed remains the coloured loading fallback and the accessible text; a rule legend is provided.
Recitation audio (ayah-by-ayah)In placeQuran.com v4 recitations endpoint with three reciters (Mishary al-ʿAfāsy, ʿAbd al-Bāsiṭ, al-Ḥuṣarī); failures show an explicit 'audio unavailable' state. Word-highlight sync from segment timings is still to come.
Offline study pack (cached pages, text and audio)In placeA service worker caches surah pages, the fetched Qur'an.com text and recitation audio so study continues without a connection.
Character-level diff vs Tanzil referencePlannedApplies to the offline cache: today the cache stores exactly what the API returned, so a diff harness is next rather than a live gap.
Per-āyah SHA-256 checksum manifestPlannedNow relevant since text is cached for offline use; verifies cached copies before display.
Scholarly certification of tafsīr summariesNot claimedThere is no standing review board. Every note names its classical source so a qualified reader can audit it, and reported corrections are applied.
SCOPE

What AyaSeerah covers — and what it does not

A plain statement of scope, so you know what this app is for before you rely on it.

IN SCOPE

  • Canonical Arabic text and translation read live from verified public endpoints, with the verse key printed for verification
  • Study in the order of revelation, walked alongside the seerah of the Prophet ﷺ
  • Thematic sections, asbāb al-nuzūl and takeaways with their classical sources named
  • Root-word vocabulary building across the sūrahs
  • Retrieval practice: quizzes, drills, surah and phase exams with sourced answers
  • Spaced repetition for meaning and context, not only for ḥifẓ
  • Plain muṣḥaf reading with a choice of reciters and translations, offline packs and progress sync

OUT OF SCOPE

  • Recitation listening or tajwīd correction of your own voice
  • Ijāzah, certification or a standing scholarly review board
  • Fatwā, rulings or personal religious guidance
  • A replacement for your printed muṣḥaf or a qualified teacher

Anything listed as out of scope is simply not part of this app today; use your printed muṣḥaf and your teacher for it.

FAIR QUESTIONS

The questions a careful student should ask

Who reviewed the tafsīr content? Is it scholar-certified?

No — and AyaSeerah says so plainly rather than implying otherwise. The study content is a compilation, not an independent scholarly ruling. Its safeguard is attribution: every asbāb al-nuzūl narration, thematic reading and takeaway names the classical work it comes from (Ibn Kathīr, al-Ṭabarī, al-Qurṭubī, al-Saʿdī, and the ḥadīth collections), so a teacher or student can check it at the source. Study with a teacher; use this as the scaffolding between classes.

Is any Qur'anic text AI-generated or paraphrased?

Never. Arabic text and translation are fetched verbatim from the Quran.com API and rendered as returned. No model writes, completes, corrects or reformats a single word of Qur'an. AI has two roles, both outside the text: optional OCR of your own handwritten class notes, and the “Teach me” voice, which narrates the written, cited study material aloud and is instructed never to add a fact or a source that is not in that material. See the curriculum provenance page for the full account.

What if the API is down or you go offline?

The page shows the stored study text with a visible label saying it is a fallback, not the live canonical fetch. It never fails silently and never substitutes an unverified string while presenting it as verified.

How is the revelation order decided — isn't that disputed?

Yes, and the app treats it as disputed. Each sūrah carries a certainty level: mutawātir/ṣaḥīḥ-attested placements (e.g. al-ʿAlaq first), strongly-reported placements, and reconstructions where scholars differ. Where the ordering is scholarly ijtihād (al-Suyūṭī's al-Itqān, Nöldeke-influenced tables, and the Egyptian standard order), that is stated on the phase, not hidden.

Can I report an error?

Yes, and please do. Text errors are checkable in seconds against the printed verse key; content errors are checkable against the cited source. Reported corrections take priority over new features.

Start where it's meant to start

The first revelation, in its historical moment, with its themes, roots and takeaways.

Open the curriculum