Architecture Prompt — v2
QuranFlow App Architecture Prompt
The Problem (Read This First)
QuranFlow students are disoriented. They don't know:
- What week of the semester they're on
- What they should be doing right now
- When live sessions happen (schedule buried 5 clicks deep)
- Who their assigned teacher is (hidden in hamburger menu)
They email asking "when does semester start?" after receiving 5 emails. They miss sessions. Some quit in week 2.
The app must be foolproof—even users who read nothing should know what to do.
What QuranFlow Is
A 15-week semester. Each week:
- Watch a lesson video (unlocks Saturday)
- Record yourself reciting the assigned passage
- Submit to your Quran Coach
- Receive audio feedback within 48 hours
- Attend optional live sessions (Level Classes, Reading Circles)
Users: Busy adults, many older, need accessibility. Don't read manuals.
What Needs a Home
Must be ≤2 taps:
- Current week indicator ("Week 8 of 15")
- This week's lesson
- Submit a recording
- My feedback (pending + history)
- Today's/this week's live sessions
Must be findable (not hidden):
- My Quran Coach's name
- Session schedule in my timezone
- Font settings (for Quranic text)
- Support/help
- Past session recordings
Current broken structure:
Top tabs: [Home] [Lessons] [Submissions] [Live]
Hamburger ≡: Coach info, Recordings, Feedback archives, Schedule (buried), Settings, Support
Critical info is in the hamburger. Live tab is a wall of text nobody uses.
Constraints
- iOS bottom tab bar (5 tabs max, destinations only—no actions)
- Toolbar for screen-specific actions (Record, Submit)
- Mushaf font as default for Quranic text
- All times in user's local timezone
The Ask
Propose 3 distinct information architectures. Each should be a different answer to: What's the primary organizing principle?
For each proposal, provide:
1. Tab Bar (one line)
[Tab1] [Tab2] [Tab3] [Tab4] [Tab5]
2. What's Under Each Tab (bullet list, one level deep)
3. Home Screen Headlines What text does the user see? Not a wireframe—just the key messages that answer "where am I?" and "what should I do?"
Example:
"Week 8 of 15 · Level 3"
"This Week: Noon Saakinah Rules"
"⏱ Recording due"
"Next: Reading Circle in 2h"
4. One Critical Flow Pick the most important task. Show the tap-path in one line:
[Tab] → [Screen] → [Action] → [Result]
5. What This Optimizes For (one sentence)
6. What This Sacrifices (one sentence)
Format for Comparison
Keep each proposal to ~20 lines. I should be able to compare all three in under 2 minutes.
## Proposal A: "[Name]"
**Organizing principle:** [One sentence]
**Tabs:** [Tab1] [Tab2] [Tab3] [Tab4] [Tab5]
**Structure:**
- Tab1: [what's here]
- Tab2: [what's here]
- ...
**Home headlines:**
"..."
"..."
**Key flow:** [tap path]
**Optimizes:** [X] / **Sacrifices:** [Y]
Don't
- Don't wireframe pixels—this is about hierarchy
- Don't include every feature—focus on the disorientation problem
- Don't over-explain—let the structure speak