Tamil Quiz Help

Main quiz screen is intentionally minimal. Use Settings for all controls (respect mode, positive/negative mode, TTS fallback, and real voice clip recording/upload).

Display Modes

• Standard is the default UI.
• Low vision focus mode can be enabled in Settings -> Display.

Keyboard Shortcuts

• 1 2 3 4: pick option directly
• ↑ ↓ ← →: move option focus
• Enter: submit focused option (or next question after answer)
• L: listen audio
• R: reveal answer
• N: next question
• S: open settings drawer
• Esc: close settings drawer
• H: open this help page
• ?: toggle in-app shortcut sheet
• D: toggle Standard / Low vision mode
• M: cycle respect mode
• P: cycle phrase polarity mode
• F: cycle fallback audio mode

Settings Drawer Shortcuts

• V: start/stop recording for selected phrase
• K: play selected recorded clip
• Cmd/Ctrl + S: save cloud audio settings

Audio Priority

• Real recorded clip (if available)
• Fallback mode from Settings (Mac Basic or Cloud TTS)

Notes

• Default respect mode is With respect.
• Default display mode is Standard.
• Settings are saved in this browser (local storage).
• Recorded clips are saved in this browser (IndexedDB).

Change Summary (February 8, 2026)

• Implemented a minimal quiz loop with one English prompt and four Tamil options per round, optimized for fast repetition.
• Set defaults to Standard display and With Respect phrasing to match polite usage first.
• Added filters for Respect (with/without/mixed) and Polarity (positive/negative/mixed), both available in Settings and via keyboard cycling.
• Expanded the command bank to 76 command sets (304 generated variants) covering common daily Tamil commands in respectful and casual variants.
• Improved colloquial romanized forms based on dialect feedback (for example, Kaelu/Kaleh and Nillu/Nileh style cues).
• Moved non-essential controls out of the main quiz surface into a settings drawer, keeping the quiz area focused and uncluttered.
• Added low vision focus mode with fullscreen-style layout, larger controls, and reduced chrome while preserving full keyboard operation.
• Added complete keyboard support: answer selection (1-4, arrows, Enter), quiz actions (B, L, R, N), settings/help (S, Esc, H, ?), and mode cycling (D, M, P, F).
• Added settings-only recording shortcuts: V to start/stop recording and K to play the selected saved clip.
• Added teacher-recording-mode shortcuts: V record start/stop, X stop, K play, Delete remove clip, and ←/→ move phrase.
• Implemented real-audio workflow with local persistence: record/upload/play/delete clips and track coverage status per phrase.
• Added a dedicated Teacher recording mode (UI mode) for fast human-teacher clip capture on the main screen with sequential phrase navigation and clip-state visibility.
• Implemented fallback speech strategy with two tiers: Mac Basic TTS and upgraded Cloud TTS (OpenAI), with real recorded clips always prioritized first.
• Added reinforcement flow after correct answers: pleasant success tone, phrase playback, then automatic advance to the next question.
• Added wrong-answer spoken cue in Tamil ("try again") with a slightly negative tone, while keeping retry available.
• Changed answer feedback behavior to option-pill states only (correct/wrong/reveal), removed the bottom "Answer:" line, and enabled retry after wrong attempts instead of hard-locking immediately.
• Added quiz Back navigation with B shortcut to return to previously shown questions in the same session.
• Updated Reveal behavior so each option keeps the same layout and only swaps the bold Tamil segment for bold English, while retaining the number prefix, divider, and romanized Tamil.
• Added stronger question-level cue for respect and intentionally removed explicit polarity indicator from the quiz header (polarity remains available as a setting).
• Refined Tamil/romanized layout for zoom use: one-line presentation with explicit separator spacing so scripts do not visually merge.
• Added separate documentation surfaces (help page + shortcut overlay) so explanations are accessible without cluttering the quiz view.
• Prepared GitHub deployment with .github/workflows/deploy-pages.yml and .nojekyll for static Pages hosting.

Project overview: README.md