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, Mushaf/Tajweed toggle, Jump-to, and Settings.
Mushaf mode uses the LPMQ Indonesian standard font with the Imlaei rasm. Tajweed mode renders the same text with colour-coded tajwid rules.
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 above the word with the Arabic, transliteration, and English (or Indonesian) translation. Tap anywhere outside the card to dismiss. Useful for vocabulary work without leaving your reading flow.
Long-press the verse-end marker (۝N) to open the verse detail sheet — the Arabic text inside the sheet uses the same LPMQ font as the mushaf body, paired with the translation and tafsir for that ayah. 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.

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 any recall mode is active.
Blur lines: every line is hidden. Tap a hidden line to reveal it, tap again to hide it. Verse-end markers stay visible so you can still navigate.
Audio-first: text stays hidden until the audio player reaches that verse. Functions like a teleprompter — useful for consolidating recently-memorised passages.
Word curtain: within a verse, only words you have actively tapped are visible. Forces strict left-to-right 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) still opens the verse detail sheet in every recall mode (handy when you genuinely need a reminder). Long-pressing a hidden word body does nothing on purpose — you have to reveal the word first before its meaning can pop up, so recall mode stays an honest test.

Listening to recitation

Tap a verse to play its recitation. The mini player appears at the bottom with playback controls.
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.
Background playback is supported when enabled in Settings, so the audio keeps playing when the screen locks.
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 are highlighted on every page where they appear and 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 — set the reader to Blur or Word-curtain, then open the Hafal Manager only when you need to confirm.
Switch reader modes anytime — your progress, anchor selection, and audio position survive the switch.
Section tint (Settings → Display) gently shades the top and bottom thirds of each page so they line up with the Memory Map cells.
For the most authentic look, leave the default reader mode on Mushaf and use Tajweed mode for studying tajwid colour rules.

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