Tehfīz: Feedback Logger

Key	Action
↑ / ↓	Scroll Quran text up / down
PgUp / PgDn	Scroll one full screen up / down
→ / ←	Previous / Next Juz
t	Toggle translation on/off
c	Toggle compact/expanded mode
+ / −	Increase / decrease font size
Esc	Close whatever's open (modal, sessions list)
When marking a mistake
Esc	Cancel / close form
Enter	Confirm & add mistake
1 – 5	Select mistake type by position in the current category tab (Tehfiz/Tajweed)
Shift	Hold to show the other category's types without leaving your tab. On a phone, each button shows its counterpart in small grey text \u2014 press and hold to pick that instead.
Shift + 1 – 5	Pick from that other category directly. The tab switches to it for that one mistake and hands back once you Add or Cancel \u2014 unless you tapped the tab yourself, which sticks.
6	Focus the "Other" mistake type field
q	Lvl 1 · Repeat
w	Lvl 2 · Hint
e	Lvl 3 · Taught
r	Focus the "Other" correction field

Auto-scroll
a	Toggle auto-scroll on / off
Shift + A	Turn the auto-scroll setting on (and start it) or off, from anywhere
s	Slower
d	Faster

Spot Testing
Shift + S	Toggle Spot Testing on / off
Shift + P	Toggle Spot panel open / closed
[	← Previous spot
]	→ Next spot

A segment is one passage covered in a session, and how it was covered. A sitting can hold several — a new lesson and an old revision are different things and shouldn't be judged by the same standard, so they're recorded separately.

📖 Recite — the student reads it all The range is an output: the app fills it in for you. The start is captured when you begin the timer (or log your first mistake), the end when you save. Both show dashed until you confirm them — tap either to correct it.
Because every verse was actually recited, these earn a strength score and a clean-verse count.

🎲 Spot test — you sample it The range is an input: set it first, choose how many spots, then Populate spots. The app picks evenly-spaced starting points across the range and you ask the student to continue from each.
Only a fraction was recited, so there's no verse rate — the honest measure is the pass rate.

The active segment One segment is active at a time, marked with ● and a gold edge. New mistakes are logged against it, and it's the one that stretches if recitation runs past its end. Tap any other segment to switch — inactive ones collapse to a single line to save room.

Setting a range Tap a range chip for the picker: Juz, Page, Surah or Ayah. Type a number, a span like 2-3, or a surah name — "kahf", "Al-Kahf" and "yaseen" all work. Or choose ⌖ Tap words instead and tap the first and last word in the mushaf.

⚠ Every mistake must belong to a segment. If one can't be placed — outside the active spot segment's range, or inside a spot segment whose spots aren't generated yet — it won't be logged, and you'll be offered the ways to fix it. Deleting a segment deletes its mistakes with it.

Instead of saving a .qrs file and passing it on by hand, you can send a finished session straight to a student. They open their viewer and it is there. Files still work exactly as before — this is an extra route, not a replacement.

1 · Sign in Tap 👥 Students in the top bar and sign in with Google. A new account starts on a waiting for approval screen — everything else in the app keeps working while you wait; only sending is held back.

2 · Add a student Type the student's name in the session panel and choose ＋ create code from the dropdown, or use ＋ New student in the Students panel. Each student gets a code like HUDHUD-S6PX. The code is their identity — there is nothing else to set up.

3 · Give them the code Write it down for them, or send it to a parent. Ask them to open the student viewer, tap Log in, enter the code and choose “This is my first time”. They pick a 4-number PIN and type it twice. That PIN is theirs — you never see it, and they should not share it with anyone.

4 · Send a session Finish the session and tap ☁ Send to student in the footer, or Send on any saved session. Nothing goes automatically — you decide when a session becomes visible, so a half-finished one never reaches anyone.

✓ No signal in the masjid? Sending still works. The session is queued and goes out by itself once you are back online. The button reads Queued until it does.

Checking a student's progress In the Students panel, Open in viewer loads that student's whole history into the mushaf view. There you can Hide a session — reversible, the student stops seeing it — or Delete it, which erases the record for good. For a session logged by mistake, hide it first; you can always change your mind.

If a code goes astray Tap Manage on their row. Reset PIN is for a student who has forgotten theirs — their code stays the same and they pick a new PIN next time they log in. Change code is for a code that has been shared or seen by others; it issues a new one and also clears the PIN, because a code and its PIN are handed over together, so a code worth changing has to be assumed to have taken the PIN with it. Both sign out every device, and after either the student logs in again choosing “This is my first time”. Sessions are never affected. A student who mistypes a PIN five times waits fifteen minutes.