Feature Request: Hifz Mode (Memorization) Hide / Unhide verses to help in memorization

[Yousef-AHH]

Feature Request: Hifz Mode (Memorization) Hide/Unhide verses to help in memorization

Summary

A memorization-focused mode that hides all verse text while keeping verse number markers visible, with controls to progressively reveal or re-hide content word-by-word or verse-by-verse. This is a common need for Quran memorization (hifz) and would make the app significantly more useful for people who are memorizing the Quran.

Use Case

When memorizing the Quran, a common technique is to read a page, then try to recall it from memory. Currently, users have no way to test themselves within the app — they have to look away from the screen or use a separate tool. This feature would let users hide the text and then check their recall progressively, either one word at a time or one verse at a time, directly within the app.

Proposed Interaction

Toggle Button

• An eye icon button is placed at the bottom of the screen, near the page number.
• Pressing it activates Hifz Mode (text hidden). Pressing it again deactivates it (text fully visible).

Hidden State Visual

• When activated, all verse text on the page is replaced with blank space and a horizontal line indicating where each verse was (see reference screenshots below).
• Verse number markers remain visible in their original positions so the user can orient themselves on the page.

Navigation Controls (appear in Hifz Mode)

When Hifz Mode is active, 4 directional buttons appear next to the eye button — 2 on the left and 2 on the right:

Button	Position	Icon	Action
Reveal Word	Right of eye	>	Reveals the next hidden word (forward, one word at a time)
Reveal Verse	Right of eye	>>	Reveals the next hidden verse (forward, one full verse at a time)
Re-hide Word	Left of eye	<	Re-hides the last revealed word (backward, one word at a time)
Re-hide Verse	Left of eye	<<	Re-hides the last revealed verse (backward, one verse at a time)

Direct Tap

• Tapping on a hidden verse area reveals that entire verse directly, without needing to use the navigation buttons.

Behavior & Edge Cases

• Global scope: Once Hifz Mode is activated, it persists across all pages as the user navigates. It remains active until the user toggles it off or closes and reopens the app.
• Audio playback: Audio mode is disabled while Hifz Mode is active, to prevent the user from hearing the answer while testing themselves.
• Page navigation: When swiping to a new page, the new page should also appear in hidden mode (all text hidden, verse markers visible).
• Reveal state is preserved: If the user reveals some words/verses on a page, then navigates away and comes back, the reveal state on that page is preserved (not reset).
• Dual-page (landscape) mode: Hifz Mode works in horizontal/two-page view as well. The progressive reveal starts from the right page (since Arabic is read right-to-left), and once all content on the right page is revealed, it continues to the left page. The re-hide controls work in reverse — starting from the left page and going back to the right.

Visual Reference

Below are reference screenshots from another app showing the hidden state (blank lines with verse markers) vs. the normal state for comparison:

• Image 1: Hidden mode — text replaced with blank lines, verse markers visible
• Image 2: Normal mode — full text visible for comparison

Technical Notes

I'm happy to discuss implementation approaches before starting any code. Some initial thoughts:

• This would likely involve a new overlay or rendering mode in the page display logic.
• Word-level and verse-level boundaries would need to be mapped to the page image coordinates (or handled via the text-based rendering if available).
• The bottom bar UI would need to accommodate the additional controls conditionally.

I'd love to hear the maintainers' thoughts on the approach before beginning implementation. Looking forward to feedback!

Jazakum allah Kheir wa al salam alaykum