Documentation · Hafidz

Reading the mushaf

Open the Quran tab and tap any surah to jump to its first page. The mushaf is rendered using the standard 15-line Madani layout.
The Quran tab app bar is intentionally minimal — just Mushaf (jump straight to page 1) and Settings. The verse-end ayah markers (۝) render in primary green for clear visibility on both light and dark themes.
Swipe left or right to flip between pages inside the reader. Page numbers and surah titles appear in the page header.
Reader top bar: Mark memorised (bookmark+) on the left, More actions (⋮) on the right — the menu holds Active recall, Jump-to, and Settings.
The mushaf renders the actual printed Madinah 1441 AH page images, layered with word-level tap coordinates from the official Quran.com ayahinfo database. Pixel-perfect at every zoom — what you see is what the physical mushaf prints.
Pinch to zoom in or out on any page; your scale is saved automatically and follows you to the next page and the next app launch. Single-finger taps, long-presses, and page swipes still work — the pinch is the only two-finger gesture.
Tap the ornate banner at the top of a surah opening to play the whole surah from verse 1, end to end. No menu — the banner itself is the button.
The mushaf page card stays paper-coloured in both light and dark themes — warm cream by day, dim sepia by night. A subtle binding shadow runs along the spine edge of every page (left on odd pages, right on even pages) so you can feel which side of the open mus'haf you're on.
Tap More actions (⋮) → Jump to page to navigate by Juz, Surah, or Page with a Cupertino picker. Tapping a Memory Map cell also jumps straight here.
Long-press a word to look up its meaning. A small card pops up with the Arabic, transliteration, and English (or Indonesian) translation, with an amber highlight on the tapped word so you can verify the match. Tap anywhere outside the card to dismiss.
Long-press the verse-end marker (۝N) to open the verse detail sheet. The Arabic text inside the sheet uses the LPMQ Isep Misbah Quranic font (renders every diacritic and stop mark cleanly), with optional simplified tajwid colours layered on top — toggle in Settings → Reading → Tajwid colours. Translation and tafsir for that ayah sit below the Arabic, with Prev/Next buttons to step through verses without leaving the sheet. If the verse belongs to a known recurring pattern (e.g. the refrain of Ar-Rahman), a "similar verses elsewhere" card lists the siblings with one-tap navigation.
The surah list in the Quran tab packs each tile with the practical info a memoriser plans around: page range in the mushaf (e.g. "Page 2–49"), juz range (e.g. "Juz 1–3"), verse count, and a chronological "Revealed #N" chip. Surahs that contain a verse of prostration get a small ۩ marker next to the title (14 surahs total). Once you start memorising a surah, a thin progress bar appears showing "42% memorised · 120 / 286" so the depth you've built is visible without opening anything.

Active recall mode

Tap the More actions menu (⋮) in the reader top bar and choose Active recall. The eye-off icon turns green in the menu when recall is active.
Word curtain — the lone on-mode — paints a paper-coloured mask over every body word on the page, with a hairline border so you can still see "there is a word here" without reading it. Tap any hidden word to reveal it and every earlier word in the same verse: strict left-to-right recall, with optional jump-ahead to validate at any point.
Verse-end rosettes (۝N) are NEVER masked. Navigation, audio playback, and range-selection still work normally even while practising recall.
The picker sheet has a "Reset reveals" button so you can re-test yourself without leaving the mode.
Long-pressing the verse-end marker (۝N) opens the verse detail sheet (translation, tafsir, mutashabihat) — handy when you genuinely need a reminder. Long-pressing a hidden word body still pops the word-lookup card on purpose: an escape valve when you're stuck on a single word, without breaking the rest of the recall flow.

Listening to recitation

Tap a verse to play its recitation. The mini player appears at the bottom with playback controls — surah name, current verse number, and a loop badge when looping is on.
To play a range of verses, tap the first verse to set the anchor, then tap the last verse in the same surah. The selection auto-plays.
Tap a surah title banner to start playback from verse 1 of that surah. The basmalah is recited first automatically — except for Al-Fatihah (where it is verse 1) and At-Tawbah (which by convention opens without it).
Tap the small page-number footer to play every verse on the current page. If the page contains the start of a new surah, the basmalah is inserted before that surah's first verse so the recitation flows naturally across the boundary.
As the recitation moves between verses on different pages, the reader auto-flips to follow the playhead — no manual swiping needed during a long surah.
Settings → Display → Word tracker (off by default) tints the word currently being recited so your eyes can follow the reciter. Pick a colour from the picker that appears once the toggle is on — Auto follows your theme preset, or pin a fixed colour (Forest green, Amber gold, Sky blue, Rose, Lavender, Coral).
Background playback is supported when enabled in Settings, so the audio keeps playing when the screen locks. The lock-screen artwork is the Hafidz mosaic logo.
Change the reciter from Settings → Audio. The verse cache refreshes so the new voice loads on next play.

Marking what you memorise

In the reader, tap the bookmark icon in the top app bar to open the Hafal Manager for the current page.
Check or uncheck each verse to mark or unmark it as memorised. Changes save instantly to the local database.
Each memorised verse carries a strength: Fresh (light pill), Firm (medium), or Mutqin (solid). New entries start at Fresh; review ratings move them up or down automatically.
A second pill shows when the verse was last reviewed (e.g. "reviewed 3d ago"). Tap the bookmark icon any time to see both pills next to every verse on the page.
Memorised verses get a soft green highlighter wash behind the text on every page where they appear, so you can spot your territory at a glance while flipping. They're also counted on the Today tab and the Memory Map.
Long-press the verse-end marker (۝N) for the verse detail sheet (translation + tafsir); long-press a word body for the word-meaning lookup card. Tap stays free for audio playback, so reading and marking stay out of each other's way.

Today: sabaq, sabqi, manzil

The Today tab is your daily hifz hub. A "Continue where you left off" card sits at the top whenever you have a saved position — tap it to jump straight back to the surah, verse, and page you last opened. The card disappears on a fresh install.
Below that the streak card shows your current consecutive-day streak; the daily ring tracks today's new memorisation against your "Daily ayat target" (Settings → Memorisation goal).
Three queues sit below. Sabaq — verses you marked memorised today. Tap "Add a new lesson" to jump to the Quran tab and use the Hafal Manager to record your new lesson.
Sabqi — recently memorised verses (within the last 7 days) that are due for review now. Tap "Start review" to open a session.
Manzil — older portions on rotating review. Tap "Start review" to drill any verses that have aged past their interval.
In a review session each verse appears one at a time. Tap "Listen" to play the recitation, "Show translation" to peek, then rate yourself: Again (1d) / Hard (3d) / Good (7d) / Easy (14d). Ratings reschedule the verse and adjust its strength — Again drops a level, Good and Easy bump up.
A small flag button beside Listen lets you mark "I stumbled here". Flagged verses jump to the top of the Manzil queue next time so weak passages get more rehearsal. Long-press the red "⚠ N stumbles" chip in the Hafal Manager to clear the flag once the verse is mastered.
At the bottom of the tab, the yearly activity heatmap (52 weeks) colours each day by how much you memorised + reviewed. Tap a cell for the date and exact counts. Scroll horizontally to see older months.
Finish a session and the queue + heatmap + streak refresh immediately. Closing mid-session is fine; remaining verses stay due, and the streak keeps as long as you logged any activity today.

Memory Map

Open the Memory Map tab to see your hifz from three angles. The segmented selector switches between Grid, Surah, and Juz views.
Grid view: 604 × 3 cells (one per page, three thirds each). Cells use a green heat ramp that combines coverage with strength. Fresh tops out around 1/3 saturation; Firm reaches 2/3; Mutqin renders at full primary green.
Surah view: 114 cards with name, translation, and a progress bar. Tap a card to jump to the first page of that surah.
Juz view: 30 cells with percentage and verse range (e.g. Juz 16 · 18:75 — 20:135). Fully-mastered juz get a checkmark. Tap to jump to the juz's first page.
Long-press any grid cell to see a quick tooltip with the page number, third label, and memorised count.
All three views derive from a bundled static dataset, so they render instantly on cold start — no network required. Pages 1 and 2 are illuminated frontispieces, so their bottom thirds stay empty by design.

Tasbih counter

Open the Tasbih tab and tap the large counter to increment. The count is saved automatically.
A subtle vibration fires every N counts (configurable in Settings → Tasbih) so you can keep your eyes closed.
Long-press the counter to reset. If "Confirm reset" is on in Settings, you will be asked to confirm before clearing.

Language & translations

The app interface is English. The "Translation & Tafsir language" setting only controls Quran content shown alongside the Arabic.
English uses Sahih International translation and abridged Ibn Kathir tafsir. Indonesian uses Kemenag translation and Tafsir Ringkas Kemenag via equran.id.
Arabic content language hides the translation block in the verse sheet and shows only the Muyassar tafsir, rendered right-to-left.

Offline mode

Open Settings → Offline → Download for offline to fetch all 604 mushaf pages and 114 surah tafsirs in one go. The download runs in your currently-selected language and reciter, so switching settings later may require a re-download.
The Offline tile shows a live status line — "X / 604 pages · Y / 114 tafsirs cached". When everything is in, it flips to "All content cached · works offline" with a ✓ marker.
The progress sheet shows live download progress and can be cancelled at any time. Resume later if you stop midway — existing pages are skipped.
Once downloaded, the reader, Memory Map, and tafsir work without a network connection. Audio still streams on demand unless cached separately by your OS.
Settings → Offline → Refresh content force-fetches the surah list and clears the cached translations on demand. Useful if you suspect a translation source updated — most of the time you do not need it, since changing reciter or language already invalidates the relevant caches.

Privacy & your data

Hafidz is offline-first. Everything you mark — memorised verses, strength levels, review history, stumble flags, daily target, streak, last-position, and preferences — lives in a local SQLite database on this device. None of it is sent anywhere.
There is no Hafidz account. We do not have a sign-up flow, an analytics SDK, or a crash reporter. We do not know how many people use the app or which features they use, by design.
The app does fetch Quran content (verses, translations, tafsir, recitation audio) from public sources — Quran.com, equran.id, and the selected reciter's audio CDN. These are normal HTTP requests; we do not add tracking headers or log them on our side.
Deleting the app from your device removes everything — there is no server-side copy to request. The fuller policy lives at hafidzquran.com/privacy.

Tips & shortcuts

Daily flow: open Today → tap "Continue where you left off" if you were mid-session, then run Sabqi, then Manzil, and finish with a fresh sabaq. The Memory Map deepens in colour as your verses age into Firm and Mutqin.
Pair Active recall with a review session — switch the reader into Word curtain, then open the Hafal Manager only when you need to confirm.
Section tint (Settings → Display) draws a single theme-coloured bar on the spine-side margin of every page, marking the middle third (lines 6-10 of the 15-line grid). Lines up with the thirds-based memorisation tracking on the Memory Map, so spatial cues stay consistent across surfaces.
When you tap the back arrow from the reader, the surah list animates back to the surah you were reading and softly highlights the matching row — no manual scroll to find your place again.
Settings → Display → Theme picks the app's colour palette: Madinah (default mushaf green), Manuscript (burgundy), Midnight (indigo), or Mihrab Gold (amber). Each preset bundles a primary colour plus matched paper tones for both brightness modes — pair Midnight × Dark for night reading or Mihrab Gold × Light for a festive Ramadan / Eid feel.
Settings → Display → Word separators turns on a soft alternating tint behind every other word. Non-native Arabic readers — the connected Madinah script can make it hard to feel where one word ends and the next begins; the zebra tint snaps the word boundaries back into focus without modifying the calligraphy.
Pinch the page with two fingers to zoom in or out. Your scale is saved on release and applied to every other page — no settings trip needed.

Ready to start?

Hafidz is free, works offline, and stores everything on your device. The fastest way to learn the rest is to try a verse.

Get the app