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

The Big Manual

Everything you can do with this app, explained like a friend would explain it. No jargon, no rush — take it in pieces.

Welcome 👋

As-salamu alaykum. If you're reading this, you already know why you're here. This isn't a manual for a piece of software — it's a guide to a study companion. Take your time with it.

There's a lot in this app. Reading the Quran, listening to recitation, exploring the Arabic root system, tracing word frequencies, exporting research data. But you don't need to know everything at once. You don't need to use everything. You just need to know what's possible, so that when you have a question, you know where to look.

So here's how to use this manual:

Do the 10-minute tour first. It's a hands-on walkthrough that touches every major feature. You'll see the app work before you read about it.
Pick a path from the bridge section. After the tour, choose how you want to go deeper — by story, by reference, or by toolkit.
Come back when you have a question. The reference sections cover every feature in detail. The FAQ at the end answers the most common confusions. Keep a bookmark on this page.

A note on Arabic

This manual assumes you can read Arabic script — even just a little. Where Arabic is central, we present it first. Transliteration appears as a helper for those moments when you're reading aloud or comparing words. Every Arabic word in this manual is a real example from the Quran.

🎯 You've just seen the app. Now what?

That ten-minute tour was the whole shape of the app in miniature. Now you have three ways to go deeper — depending on how you learn best.

📖

I learn by example

Read a Real Story

Six walkthroughs, each from a different kind of user. Pick the one that sounds like you — a reader, a memorizer, an Arabic student, a researcher.

Jump to the stories →

📚

I look things up as I go

Use It as Reference

Every feature explained in detail. Skim it once, then come back whenever you're stuck on something specific. Bookmark this page.

Jump to the reference →

🔤

I want the full toolkit

Master the Arabic

Transliteration scheme, root system, grammar glossary, tajwīd basics — everything you need to read and study the Quran's Arabic on your own.

Jump to the toolkit →

🎯 A word of advice

Don't try to read this manual cover to cover. It's long for a reason — it's a reference, not a novel. Start with one of the three paths above. Come back later when you want more.

⏱️ Your First 10 Minutes

If you're brand new and want to see it work before reading a manual, do this. Literally the next ten minutes. No theory, no explanation — just click along and watch what happens.

When you finish, you'll have read a surah, heard it recited, explored a word back to its root, and looked up a frequency. And you'll understand the app's shape.

Minute 1 — Open the app

Go to /dashboard. You'll see your home overview. Look at the sidebar on the left — that's your map to everything.

Minute 2 — Read Al-Fatihah

Click Quran → All Surahs. Find Al-Fatihah (it's #1) and open it. Read the seven ayahs. Notice the Arabic on top and translation below.

Minute 3 — Toggle translations off

On the same page, click the toolbar button that says Hide all meanings. Watch the translations disappear. Now read the Arabic alone. Click Show all meanings to bring them back. That's your toggle for pure-Arabic reading.

Minute 4 — Play recitation

Use the Reciter dropdown at the top — pick Mishary Alafasy. Click Play surah. Listen. Watch the page highlight the current ayah as it plays.

Minute 5 — Open the Words panel

Pause the audio. On ayah 1 (Bismillah), click the Words button. A row of word chips appears. Each chip shows an Arabic word, its meaning, its transliteration, and its root.

Minute 6 — Trace a word to its root

Find the chip for ٱلرَّحْمَٰنِ (the third word in Bismillah). Notice its root: ر ح م. Click it.

Minute 7 — Explore the root page

You're now on the root page for رحم (rHm). Look at the numbers: 339 occurrences · 313 ayahs · rank #21. Scan the word family — every word that shares this root. Scroll down to see every ayah that mentions it.

Minute 8 — Look up frequency

In the sidebar, click Study → Root Frequency. You'll see the top 100 roots ranked. Find رحم on the list. Notice that اله (divinity) is #1 with 2,851 occurrences — nearly 10× more than the mercy root.

Minute 9 — Try the word search

Click Word Frequency in the sidebar. In the search box, type رحم. Every word containing those letters — الرحمن, الرحيم, رحمة, and many more — appears. Click any one of them to see all its occurrences.

Minute 10 — Bookmark one ayah (optional)

Go back to Al-Fatihah and click the 🔖 Bookmark icon on any ayah. If you have an account, it saves. If not, you'll be prompted to create one — free, takes 30 seconds.

🎉 Done!

In ten minutes, you've touched every major feature: reading, audio, words, roots, frequency, search, bookmarks. The rest of this manual explains why each one matters and how to use it well.

🎯 Now go back to the top

Scroll up and pick one of the three paths in the bridge section — or jump straight to a Real Story below.

Story 1

📖 "What does this word mean?"

You're reading Surah Maryam. You reach ayah 45 and you hit a word you don't know — رحمن. It's not quite the same as رحيم, which you've seen before. You pause. What is it?

Let's walk through it together.

Open the surah: /surah/19. Scroll to ayah 45.

Click Words on the ayah. A row of word chips expands below the ayah. Each chip shows the Arabic word, its translation, and its transliteration.

Find the chip for ٱلرَّحْمَٰنِ. You'll see it has a root listed: ر ح م — clickable.

Click the root. You'll land on the root page for رحم (rHm). Here, you can see:

The root's core meaning: mercy, compassion
Every word that shares this root — all the way from رحم (womb) to الرَّحْمَٰن (the Most Gracious)
All 313 ayahs where a word from this root appears

Now you have the full picture. The word رحمن traces back to a root meaning "mercy" — and it's one of a whole family of mercy-words the Quran uses.

That's the whole workflow. From an unfamiliar word, to its root, to its family, to every verse that uses it. It takes about 30 seconds and it will change how you read the Quran.

💡 Try it yourself

Pick any word you don't recognize in today's reading. Trace it back to its root. Do this for a week and you'll start recognizing roots everywhere.

Story 2

🔍 "Find every verse about patience"

You're preparing a khutbah, or writing a reflection, or just studying the theme of patience — صبر (ṣabr). You want to see every verse that touches it.

Here's the workflow:

Open Search Roots & Words. This is a search that understands both Arabic and transliteration.

Type صبر in the search box. Or, if you don't have the Arabic keyboard handy, type sbr — the app will accept the transliteration too.

The results show both roots and words that match. Click the root صبر.

You're now on the root page. Scroll down and you'll see all 103 ayahs that mention patience — grouped by surah.

To save a specific ayah for later — say, the famous "Allah is with the patient" verse in Al-Baqarah — click Bookmark on that ayah. It's saved to /bookmarks.

📌 Theme studies

This workflow works for any theme. The root صبر has 103 ayahs. شكر (gratitude) has 75. عدل (justice) has 28. The frequency tells you how central a concept is to the Quran's message.

💡 Pro tip

Once you have the list of ayahs, use your browser's print function (Ctrl+P / Cmd+P) to save a PDF for offline study.

Story 3

🎧 "I'm memorizing Surah Al-Mulk"

Surah Al-Mulk — 30 ayahs, recited every night by the Prophet ﷺ. You're memorizing it. You want to use the app to help.

Here's your daily routine:

Morning: Listen and follow along

Open Surah Al-Mulk.

Pick a reciter from the dropdown. If you're memorizing, choose Al-Husary — his style is the gold standard for memorization because he recites slowly and clearly.

Click Play surah. The page will auto-scroll and highlight each ayah as it plays. Follow along with your finger, repeating each verse aloud after the qāri'.

Afternoon: Test yourself with Hifz mode

Still on the same surah page, enable Hifz from the toolbar.

Start at Level 1 — a few words are hidden. Read aloud, filling in the blanks from memory.

When Level 1 feels easy, jump to Level 2 (more hidden). Then Level 3. Then Level 4 — where most of the ayah is hidden and only the first letter of each word remains.

Evening: Track progress

As you finish memorizing each ayah, click Memorize on that ayah. A green icon appears.

View your progress at Memorization → Memorized. You'll see exactly which ayahs you've marked across all surahs.

💡 Hifz advice

The traditional advice is: new memorization in the morning (fresh mind), revision in the evening. Use the app both times — for new memorization, listen and follow along. For revision, use Hifz mode at Levels 3–4 as a self-test.

📌 Coming soon

Advanced hifz tools are on the roadmap — Spaced Repetition (SM-2 scheduling), Sabaq / Sabqi / Manzil traditional workflow, and Hifz Calendar heatmaps. See the roadmap for details.

Story 4

🌊 "What's the difference between رحمن and رحيم?"

You've been reading the Basmalah your whole life: بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ. Two mercy-words, side by side, every time. And you've always wondered: what's the actual difference?

This is one of the most beautiful explorations the app enables. Let's walk through it together.

Go to Root Frequency. Notice that اله (divinity) is #1, then قول (speech) is #2, and كون (existence) is #3. Scroll down a bit and you'll find رحم at rank #21. Click it.

On the root page, you'll see 339 occurrences across 313 ayahs. That's a lot. The page also shows the family of words from this root — scroll through the list of lemmas.

Now click into the specific word ٱلرحمن. Count the occurrences: 45. All of them, without exception, refer to Allah.

Then look at ٱلرحيم. Count: more. And here's the key observation — رحيم appears in contexts where mercy is actually being shown to someone. الرحمن describes the attribute itself, الرحيم describes its application.

Now the beautiful part. Notice how both words share the root رحم. Now look at the Arabic word رحم itself — the same three letters, but without the ال prefix or the ي suffix. It means womb. Let that sink in. The root of Allah's mercy is the same word as the place where a mother's love is born.

🕌 Classical scholarship

Ibn al-Qayyim, al-Ghazālī, and others have written extensively on this distinction. The classical summary:

الرَّحْمَٰن — a mercy that is essential to Allah's nature, encompassing all creation
الرَّحِيم — a mercy that is actualized toward the believers specifically

So الرحمن is broader in scope but الرحيم is more specific in application. The two words aren't synonyms — they're complements.

🎯 Try it yourself Pick another pair of related words you've noticed in the Quran — maybe صبر (patience) vs صابر (one who is patient), or نعمة (blessing) vs نعيم (bliss). Trace them back to their root, count their occurrences, and see if the pattern holds. This is how traditional tafsir works.

Story 5

🔬 "A small research project on mercy"

You want to write a short piece — for a blog, a khutbah, or just for yourself — on the theme of mercy in the Quran. You want real data, not vague impressions.

Here's how the app turns a hunch into a proper study:

Step 1: Get the raw data

Open Root Frequency.

Locate رحم at rank #21. Its count is 339. Its ayah count is 313.

Click into the root page. Scroll through the family of words. Count how many are divine attributes (الرحمن، الرحيم، أرحم) vs human actions (يرحم، ارحموا، رحمة). You'll notice something: almost all occurrences are divine. Mercy, in the Quran, is overwhelmingly something Allah does to us.

Step 2: Export for analysis

Open Word Frequency. Click Download CSV. You now have a spreadsheet of the top 100 words in the Quran.

Open the CSV in Excel, Google Sheets, or Numbers. Notice that the top 30 words are almost all function words — من, في, ما, الله. This is normal — grammar gets repeated. Now filter for the first content word — you'll likely hit رحم or علم.

Step 3: Cross-reference with the corpus

Visit the Quranic Arabic Corpus — the scholarly database this app's morphology comes from.

Search for any word. You'll see its full dependency tree (i'rab), its morphological segmentation, and the classical grammar analysis. The corpus gives you the linguistic depth; the app gives you the frequency and cross-referencing depth.

Step 4: Write

Now you have everything:

Raw numbers — 339 occurrences, 313 ayahs, rank #21
Distribution — divine vs human usage
Cross-references — every verse containing the root
Grammar depth — from the corpus

💡 A research habit

Always look at the ayah coverage alongside the raw count. رحم appears 339 times across 313 ayahs — that's a ratio of 1.08, meaning the word is spread out. Compare with اله — 2,851 occurrences across 1,879 ayahs — ratio 1.52. Denser ayahs. Density tells you about clustering: does the word appear once per ayah or several times? That's a research question in itself.

Story 6

📚 "Learning Arabic through the Quran"

You've been studying Arabic for a while. You can read the script, you know basic grammar, and now you want to build vocabulary — but not from a textbook. From the Quran itself.

Here's a daily routine that actually works:

Week 1–4: Master the top 50 roots

Open Root Frequency. The top 50 roots cover the overwhelming majority of the Quran's text. Commit to learning 10 per week.

For each root, read the root page and look at every derived word. For كتب for example, you'll see كتاب, كاتب, مكتوب. Notice the pattern of derivation. This is the language's DNA.

Now open a surah you know well (Al-Fatihah, Al-Ikhlas, Al-Falaq) and try to find the roots you've learned. You'll start seeing the pattern everywhere.

Week 5–8: Build word-level vocabulary

Open Word Frequency. This is the top 100 exact forms. Skip the function words (من، في، ما، لا) — you already know these. Focus on the first content words.

For each content word, click it to see every occurrence. Read through a handful of ayahs to see the word in context.

Ongoing: Read with the Words panel open

Open any surah. Click Words on any ayah. The panel shows the meaning, transliteration, and root of every word.

Read the surah slowly. When you hit a root you've learned, pause — say the root out loud. This is how memorization works best: association. Every new encounter reinforces the last.

💡 The 3-letter habit

After learning a few roots, start seeing every Arabic word as a 3-letter root + pattern. يستغفر (yastaghfir — he seeks forgiveness) is غ ف ر in the Form X pattern (استفعل). Once you know غفر and the Form X pattern, you understand every instance of this word without ever having memorized it. This is the power of roots.

⬆ That's the six stories.

You've now seen the app from six different angles. From here, the manual becomes a reference — come back to it whenever you want to look up a specific feature. Jump to the Reference →

📖 Reference — Reading & Recitation

Browse Surahs

/surahs shows all 114 chapters. Each card displays:

The surah's number (1–114)
Its name in English (e.g., "The Opening")
Its name in Arabic (e.g., الفاتحة)
Its transliteration (e.g., Al-Fatihah)
The number of ayahs
Meccan or Medinan designation

Read a Surah

Click any surah to open its reading view at /surah/{id}. Each ayah is displayed with:

The Arabic text in a beautiful Amiri serif font
The translation below it (from your preferred translation)
The ayah number, juz, and page
A row of action buttons (Play, Words, Tafsir, Bookmark, Memorize)

Toggling Translations

Per ayah: Click Hide meaning under any ayah to toggle its translation off.

All at once: Use the toolbar's Hide all meanings button for pure Arabic reading. Great for memorization practice or reading with a group.

Changing the Translation

At the top of any surah page, there's a translation dropdown. Choose from multiple English (and other language) translations. Your choice is remembered in your browser.

Reading with the Words Panel

Click Words on any ayah to expand a word-by-word breakdown. Every word chip shows:

The Arabic word
Its English translation
Its transliteration
Its part of speech (N = noun, V = verb, ADJ = adjective, PCL = particle)
Its lemma (dictionary headword)
Its root — clickable to the root page

Audio Recitation

The app includes 6 world-renowned reciters:

Mishary Alafasy — modern, melodic
Mahmoud Khalil Al-Husary — the classic for memorization; slow, precise, unembellished
Mohamed Al-Minshawi — the great Egyptian master; deep and slow
Abdurrahman As-Sudais — imam of the Grand Mosque in Mecca
Abdul Basit — legendary; deeply moving tajwīd
Saud Ash-Shuraim — imam of the Grand Mosque; measured and clear

Playing a Single Ayah

Click Play on any ayah. The verse plays. When it finishes, the page automatically advances to the next ayah — highlighting and scrolling as it goes.

Playing the Whole Surah

Click Play surah at the top. Playback starts from ayah 1 and walks through the entire chapter, verse by verse. Perfect for listening during commute, chores, or quiet time.

The Floating Audio Bar

When audio is playing, a bar appears at the bottom of the screen with:

⏮ Previous — go back one ayah
▶ / ⏸ Play / Pause — pause or resume
⏭ Next — jump forward one ayah
✕ Close — stop playback entirely

Hifz Mode (Memorization Mode)

Enable Hifz from the toolbar to hide words progressively:

Level 1 — a few words hidden
Level 2 — more hidden
Level 3 — most hidden
Level 4 — nearly everything hidden; only first letters remain

This is designed for self-testing during revision. Read the ayah aloud, filling in the hidden words.

🔥 Reference — Reading Progress & Streaks

Every time you open a surah or a mushaf page, the app remembers exactly where you stopped — down to the ayah or page. No bookmark needed. If you forget where you were, the app remembers for you.

Continue Reading

Your dashboard shows a 📖 Continue reading card for the most recent surah you were reading. It displays:

The surah name (English and Arabic)
Your current ayah (e.g., "ayah 30 / 110")
A progress bar showing how far into the surah you are
A Continue at ayah N button that jumps straight back to your position

In-Progress Surahs

The dashboard's 📚 In progress card lists every surah you've started but haven't yet completed — sorted by most recently read. Each row shows:

Surah name
Your last ayah and percentage complete
When you last read it
A Resume button to jump back

This is where a forgotten bookmark becomes a non-issue: every partial surah you've ever opened lives here, forever.

Surah & Juz Progress

Two progress counters on your dashboard:

📖 Surah progress — X / 114. Increments when you finish a surah (read to its final ayah).
📄 Juz progress — Y / 30. Increments when you open the last page of a juz in mushaf mode.

Both counts include a progress bar and the number of units currently in progress.

Completion Log

Visit /completions to see your full reading history. Three tabs:

📚 All — completed surahs + completed juz + everything in progress
✅ Completed — chronological list of every surah and juz you've finished, with dates
⏸ In progress — every partial read, sorted by recency

Completed surahs show the surah number, name, date, and mode used (surah reader or mushaf). Completed juz show the juz number and date.

Reading Streak

The dashboard shows a 🔥 Day streak card. It counts the consecutive days you've read anything — whether via the surah reader or the mushaf reader.

Day 1: "First day — keep going!"
Day 2+: "Keep it up! 🔥"
Miss a full day → streak resets to 0 on the next visit
Yesterday's read counts until midnight tonight (grace period)

How It All Records

Every reading event stores itself automatically:

Opening a surah → position saved, streak day logged
Scrolling through a surah → position updates at ~1.25 second intervals (debounced)
Reaching the last ayah → surah marked completed
Opening a mushaf page → position saved, juz progress logged
Scrolling a mushaf page past 30% → streak day logged (prevents accidental refresh from counting)
Opening the last page of a juz → juz marked completed

No Bookmark Required

Bookmarks (the 🔖 button on each ayah) are still useful for saving specific verses you want to return to. But for "where was I?", the app tracks it automatically. You never have to remember to bookmark anything just to be able to resume.

💡 Multi-surah tracking

You can read five different surahs in one day — each keeps its own position. The "In progress" card shows all five. Click any to resume at exactly where you stopped in that specific surah. This is a small detail with a big impact: no more "I was reading Al-Kahf two weeks ago but now the app thinks I'm on Al-Baqarah."

📌 For members only

Reading progress, streaks, and the completion log require a free account. Anonymous reading works normally but isn't tracked.

🌳 Reference — Roots & Dictionary

What Is a Root?

In Arabic, almost every word is built from a 3-letter root (rarely 4). The root carries a core meaning, and different patterns applied to the root produce different words.

Example — the root ك ت ب (k-t-b, "writing"):

كَتَبَ · كِتَاب · كَاتِب · مَكْتُوب

كَتَبَ (kataba) — he wrote
كِتَاب (kitāb) — a book
كَاتِب (kātib) — a writer
مَكْتُوب (maktūb) — written

All four words share the root and the semantic field of "writing". Learn the root, and you understand the whole family.

The Root Detail Page

/root/{translit} — e.g., /root/rHm. Each root page contains:

The Arabic root and transliteration
Frequency rank — e.g., "#21 of 1,501"
Total ayahs containing the root and total occurrences
The family of words — every lemma derived from the root, with POS and usage counts
Every ayah containing a word from this root, with the specific word highlighted

Word Detail Pages

/word/{arabic} — e.g., /word/ٱلرحمن. Each word detail page shows:

Total occurrences and distinct ayah count
Root — linked to the root page
Lemma — the dictionary headword
Part of speech — NOUN, VERB, PCL, etc.
Every ayah containing this exact form

📊 Reference — Frequency Pages

Root Frequency Page

/roots/frequency — the top 100 roots by total word count. Each row shows:

Rank (#1–100)
The Arabic root
Its transliteration
Total word count
Number of distinct ayahs
A visual relative-frequency bar

Word Frequency Page

/words/frequency — the top 100 exact word forms. Same layout as root frequency. Includes:

A search bar (Arabic or transliteration)
CSV export via Download CSV
Clickable Arabic words → word detail page

Revelation Filter

Both frequency pages support a Revelation filter:

All — the full Quran (default)
Meccan — only surahs revealed before the Hijrah
Medinan — only surahs revealed after the Hijrah

Switching the filter recomputes counts for that revelation period — so you can see, for example, that موسىٰٓ (Moses) ranks much higher in the Meccan list than in the overall list.

Exporting to CSV

On the Word Frequency page, click Download CSV. You'll get a spreadsheet with columns: Rank, Word, Transliteration, Count, Ayahs. UTF-8 encoded so Arabic displays correctly in Excel.

🔍 Reference — Search

Root & Word Search

/roots/search — the specialized search for Arabic linguistic study. Searches across both roots and lemmas.

Searching by Arabic

Type رحم. The app:

Strips your query of diacritics
Normalizes alif variants (أ إ آ → ا)
Matches against both raw and stripped forms in the database

Searching by Transliteration

Type rHm or rahma. The app matches your query against the transliteration fields. Capital letters indicate emphatic consonants.

General Quran Search

/search — full-text search across the Quran translations. When you type a query, the app searches across all active translations and shows you tabs for each language, with match counts.

🔤 The Arabic Toolkit

Everything you need to read, understand, and trace Arabic words in the Quran. Bookmark this section — it's the one you'll come back to.

1. The Transliteration Scheme

Arabic has sounds that don't exist in English. Scholarly transliteration uses specific letters to represent these sounds. This app uses the standard scheme from Quranic studies.

Consonants

Arabic	Translit	Sound	Example
ء	`'`	glottal stop	أَخ → 'akh
ب	`b`	as in "book"	بيت → bayt
ت	`t`	as in "top"	توب → tawb
ث	`v`	as in "think"	ثوب → vawb
ج	`j`	as in "jam"	جنة → jannah
ح	`H`	heavy h, from the throat	حمد → Hamd
خ	`x`	as in Scottish "loch"	خير → xayr
د	`d`	as in "door"	دين → dīn
ذ	`*`	as in "this"	ذكر → *ikr
ر	`r`	rolled r	رب → rabb
ز	`z`	as in "zebra"	زيت → zayt
س	`s`	as in "sun"	سلام → salām
ش	`$`	as in "ship"	شمس → $ams
ص	`S`	emphatic s	صبر → Sabr
ض	`D`	emphatic d	ضلال → Dalāl
ط	`T`	emphatic t	طيب → Tayyib
ظ	`Z`	emphatic dh	ظلم → Zulm
ع	`E`	ʿayn — from deep in throat	علم → Elm
غ	`g`	gh — like French r	غفر → gafar
ف	`f`	as in "fine"	فعل → fEl
ق	`q`	deep k	قلب → qalb
ك	`k`	as in "king"	كتاب → kitāb
ل	`l`	as in "light"	ليل → layl
م	`m`	as in "moon"	ملك → malik
ن	`n`	as in "night"	نور → nūr
ه	`h`	as in "house"	هدى → hudā
و	`w` / `ū`	"w" or long "oo"	وعد → waEd
ي	`y` / `ī`	"y" or long "ee"	يوم → yawm

Vowels

Arabic	Translit	Sound
◌َ	`a`	short "a" as in "cat"
◌ِ	`i`	short "i" as in "sit"
◌ُ	`u`	short "u" as in "put"
◌َا	`ā`	long "a" as in "father"
◌ِي	`ī`	long "ee" as in "see"
◌ُو	`ū`	long "oo" as in "moon"

2. The Root System

Almost every Arabic word has a 3-letter root (rarely 4). The root carries a core meaning, and patterns applied to it create specific words.

Example: The Root ص ب ر (S-b-r, patience)

صَبَرَ · صَابِر · صَبُور · صَبَّرَ · اِصْطَبَرَ

صَبَرَ (Sabara) — he was patient
صَابِر (Sābir) — one who is patient
صَبُور (Sabūr) — extremely patient (intensive)
صَبَّرَ (Sabbara) — he encouraged patience in others
اِصْطَبَرَ (iSTabara) — he was steadfast (Form VIII)

Same root. Different patterns. Same core meaning, different nuances.

3. Parts of Speech

Every word in the app's database is tagged with its part of speech:

Tag	Meaning	Examples
`N`	Noun	كتاب (book), رحمة (mercy)
`PN`	Proper Noun	محمد (Muhammad), مكة (Mecca)
`V`	Verb	كتب (write), قال (say)
`ADJ`	Adjective	كريم (generous), عظيم (great)
`PRON`	Pronoun	هو (he), نحن (we)
`PCL`	Particle	في (in), من (from)
`CONJ`	Conjunction	و (and), أو (or)
`DET`	Determiner	ال (the)

🔬 The Researcher's Desk

If you're doing serious study — writing, teaching, or pursuing academic research — this section covers the tools that go beyond casual reading.

1. Frequency Analysis Workflows

Comparing Two Related Words

Find the first word's root (via Word Detail or Search)
Note its frequency rank, occurrence count, and ayah count
Repeat for the second word
Compare the ratios: what does the difference tell you?

Example: رحمن appears 45 times; رحيم appears more. Both share the root رحم. The difference in frequency tells you how each is used in context.

2. API Access

For automated research, the app exposes a JSON API:

Endpoint	Returns
`GET /api/ayah/{id}/words`	Morphological breakdown of an ayah — every word with root, lemma, POS
`GET /api/ayah/{id}/tafsir`	Tafsir for an ayah
`GET /api/ayah/{id}/audio`	Audio URL for an ayah
`GET /api/v1/surah/{id}`	Full surah as structured JSON

3. Cross-Referencing with the Corpus

The app's morphological data maps directly to the Quranic Arabic Corpus reference IDs.

❓ Frequently Asked Questions

Do I need an account to use the app?

No. Reading, audio, roots, word frequency, and search all work without an account. An account is only required for bookmarks, memorization tracking, and personalized settings.

Is the audio free to use?

Yes. Audio streams from everyayah.com, which offers free Quranic recitations for personal and educational use.

Which translations are available?

Multiple English (and other language) translations are available — including Bahasa Melayu, Bahasa Indonesia, and Urdu. Your preferred translation is remembered per device.

How accurate is the Arabic morphology?

Very accurate. Root, lemma, and part-of-speech data comes from the Quranic Arabic Corpus — the leading scholarly morphological database used in academic Quranic research worldwide, developed at the University of Leeds.

Can I use the app offline?

You can save surahs for offline reading via the Save offline button on any surah page. Audio requires an internet connection.

Why do some words show no root?

Particles (و "and", بِ "with", من "from") and pronouns don't have roots. This is a feature of Arabic grammar, not a data issue.

What does the "frequency rank" mean?

Every root is ranked from 1 (most frequent) to 1,501 (least frequent) by how many times words from that root appear in the Quran.

Why do numbers like ٢ ٣ appear in some lists?

Those are Arabic-Indic numerals used as verse markers. The Word Frequency page filters them out automatically so you only see real words.

How do I search by root if I don't know Arabic?

Use transliteration. Type rHm for the root of mercy, ktb for writing, Elm for knowledge.

What's the difference between a root, a lemma, and a word?

Root — the 3-letter core meaning (ر ح م).
Lemma — the dictionary form of a specific word (رَحِمَ, "to show mercy").
Word — the exact form as it appears in a verse (يَرْحَمُ, "he shows mercy").

How do I find every verse about a topic?

Search for the topic's root. For patience, search صبر. For gratitude, شكر.

Can I export the data?

Yes. On the Word Frequency page, click Download CSV.

Are there Meccan / Medinan filters?

Yes — both frequency pages support it. Use the Revelation filter row: All, Meccan, or Medinan.

If I forget to bookmark, can I still find where I was?

Yes. Every surah you open is tracked automatically. Visit your dashboard and look at the 📖 Continue reading card (most recent) or the 📚 In progress card (all partial surahs). You never need to bookmark to resume — the app remembers for you. Bookmarks are still useful for saving specific verses you want to return to.

📋 One-Page Cheat Sheet

Everything on one page. Print it if you like. Tape it to your desk.

📍 Quick URLs

/dashboard — continue reading, streaks, progress
/surahs — all 114 surahs
/surah/{id} — read a surah
/completions — reading log (completed + in progress)
/roots — browse all 1,501 roots
/root/{translit} — one root (e.g., /root/rHm)
/roots/frequency — top 100 roots by usage
/words/frequency — top 100 words + search + CSV
/roots/search — search roots and lemmas
/search — full-text search across translations
/settings — theme, translation, tokens
/manual — this page

🔤 Transliteration Quick Reference

H — ح (heavy h)
S — ص (emphatic s)
D — ض (emphatic d)
T — ط (emphatic t)
Z — ظ (emphatic dh)
E — ع (ʿayn)
g — غ (gh)
x — خ (kh)
v — ث (th)
* — ذ (dh)
$ — ش (sh)

Final Thoughts

The Quran is not a text to be skimmed — it's a text to be lived with. The tools in this app exist to help you do that more deeply.

Don't try to use every feature at once. Start with reading. Add audio when you want to listen. Explore a root when a word catches your eye. Study frequency when you're curious about the Quran's structure. The app grows with you.

وَقُل رَّبِّ زِدْنِى عِلْمًا

"And say: My Lord, increase me in knowledge." — Ṭāhā 20:114

↑ Back to top ❤️ Support the project