QuranFlow · The redesign hub
QURANFLOW · PRODUCT MAP · V14 · AUG 18 DECISIONS · 2026-08-19

QuranFlow · Flow Map

One app, five ways to arrive: new student, Year 1, Year-2 graduate, Year-2 direct entry, coach. Registration and payment stay on the web — the app starts at sign-in and routes by status. Every screen carries its walkthrough code, the pronounced number a coach can cite in voice-note feedback. Recut Aug 18 2026, after the review with Lejla and Sr. Yasmine: the two frames that carried PROPOSAL — DECISION NEEDED were both answered. C13, the live-class surface, is cut: sessions run in Zoom, and what survives is a backend count of Join clicks for admin reports. C12, a student's reply to feedback, is superseded — the reply channel was accepted, but as a tagged thread in the coach's one inbox rather than a screen of its own. The coach's Appointments tab (C17) merges into C07: one schedule behind an Everything · Live classes · Appointments filter, and the tab slot it freed goes to Messages, so the coach bar reads Home · Queue · Students · Schedule · Messages. The five-state submission vocabulary agreed on Aug 11 and missed in the v13 build now runs everywhere: Awaiting review → In review → Feedback ready, with Returned and Taken back as the two exits; “Practiced” and “Heard” are gone. Carried forward from Aug 11: the coach lane runs in two acts, THE COACH SIDE (her day, the queue, a review, the roster, placement) and COACH TOOLS (schedule, notes, curriculum, messages, announcements, hours); the first assessment is a recorded submission; Level 0 is a real status; appointment counts are plan-based; Year-2 lessons are per-course; Year 2 is the Year-1 mirror with availability last. Program names: Year 1 is Recitation Essentials, Year 2 is Mastery. Items marked PROPOSED are inferences from Lejla's facts — flagged for review, not decided.

designed · live in the walkthrough REVISED — Aug 18 NEW — Aug 11 REVISED — Aug 11 NEW — Jul 27 REVISED — Jul 27 BRIEF — asked for, not yet designed RETIRED — cut or superseded, kept for trace RESOLVED — both proposals answered Aug 18 DECIDED — open question closed, build it PROPOSED — for Lejla's review status branch tap / navigation system sends

The coach lane's C10–C18 and the student screens added last round come from the coach-app session of Aug 6 2026 with Lejla and Sr. Yasmine, Lejla's coach-side audit of Aug 11 2026 (written against the April 2026 coach survey, eleven responses), and the Aug 11 2026 review of the v12 change document. This recut carries the product review of Aug 18 2026 with Lejla and Sr. Yasmine, built into walkthrough v14 the same day. Frames whose filenames end -v14 are shots of that build; the rest are older captures of screens this round did not change, and their notes say when they were taken. No proposal is open. The two frames that carried PROPOSAL — DECISION NEEDED are answered and now read RETIRED: C13 was cut outright, C12 was superseded by the tagged thread that replaced it. C17 joins them, merged into C07 rather than cut. All three keep their v13 pictures, because a retired frame's job is to let an old screen number resolve to something.

STAGE 01 · ENTRY

Entry — shared spine

Nobody registers in the app. Two ways in, both off-app: web checkout, or automatic enrollment for level graduates. Sign-in is email + password from the welcome email — the system that has worked for ten years. The old “Enrollment happens at almaghrib.org” footer is removed (App Store rules restrict pointing to an external sales page).

00A · OFF-APP
Web registration & checkout
almaghrib.org · web
Not an app screen. New students, Year-2 elective sign-ups and repeat students register and pay on the web. Appointment plans are purchased here too. Then: a welcome email with credentials.
00B · OFF-APP
Automatic enrollment
email · auto-billing
Not an app screen. Level graduates roll into the next level automatically; Level-4 graduates auto-enroll into Year 2's mandatory first semester. “You've been enrolled” — no checkout.
S01
Sign in
REVISED · JUL 27 Sign in
“Need help signing in?” replaces the enrollment footer — App-Store-safe. Proposed.
S52
Complete your profile
NEW · BRIEF
Aug 2026 · every lane

Complete your profile

A hard gate for anyone who skipped the details step at checkout. Passed through silently when the record is already complete.

  • First and last name
  • Age or year of birth
  • Gender
  • Phone number, to confirm
Sits between sign-in and the status branch, so every lane passes through it once and nobody reaches a lesson with a half-empty record.
The app reads the account status and routes:
YEAR 1placed, levels 1–4
NEW STUDENTenrolled, no level yet
YEAR 2two arrivals
COACHadmin-granted role
STAGE 02 · ARRIVING — THE FIRST RECITATION

New students: a recorded first recitation, then Level 0

Corrected Jul 27: the first assessment is a recorded submission, not a booked 1:1 — four short reading stages, recorded and sent to a pooled first-assessment coach team (mechanism unchanged: “it's been working well so far”). The audience rehearses for up to two weeks, so two supportive screens land before anything is asked. “Your first recitation” — not “assessment” — is a proposed rename (Q16).

NEW STUDENTS ONLY · LEVEL 0 UNTIL PLACED
S02
You made it
NEW · JUL 27 Welcome — you made it
Supportive register, before any tutorial — signing up was the hardest step.
S03
How placement works
NEW · JUL 27 How placement works
Expectation-setting: rehearse first; placement reflects this recording. A walkthrough video is parked for later.
S04
Your first recitation — four reading stages
NEW · JUL 27 Your first recitation
Letters → words → a familiar surah → a more technical ayah.
S05
Record, at your own pace
NEW · JUL 27 Record
Practice-first: re-record freely, read without recording; nothing sends until you tap send. Proposed register.
←  the next row starts here and reads right to left  ·  S06, then S07, then S08
S08
Placement result
NEW · JUL 27 Placement result
Placed into a Year-1 level only; Year 2 is reached by graduating Level 4. Quiet “questions about your level?” affordance. Aug 2026: this screen absorbs the welcome S10 used to carry. The level on it is set by a coach on C11, in the coach lane at the foot of this map.
S58 · returning-student variant
S07
Waiting — Level 0
REVISED · AUG 11 Waiting — Level 0
Aug 2026, a real Level-0 home: a countdown to the first day of the semester, the “How QuranFlow works” video pinned until a level is set, the resource kit, the live circles and the same announcements a placed student gets. Aug 18: the pending recitation's pill speaks the new vocabulary — Awaiting review.
S59 · skipped-assessment variant, where the offer stays open
S06
Review, then send to your teachers
NEW · JUL 27 Review and send
Routes like a normal submission — to the pooled first-assessment coach team, rotating so everyone is assessed quickly. Aug 2026: placement only, no feedback comes back.
S09
Auto-placed — Level 2
NEW · JUL 27 Auto-placed — Level 2
Auto-placement after reminder emails is decided; this no-celebration variant of S08 is proposed (folded into Q16).
S69
Assignments — before a level
NEW · AUG 11 Assignments — before a level
Aug 11: no tab is hidden from an unplaced student — “we don't have to hide tabs for them.” The tab is there, and says why it is empty.
S70
Learn — before a level
NEW · AUG 11 Learn — before a level
Fifteen greyed squares, an explainer, and a quiet way back to the first recitation. Nobody should sit unplaced longer than about a day.
Level 0 is a real status, not a waiting room: signed up, not yet placed. The interface is the full app minus lessons. Placement is student-paced — days to about three weeks; many rehearse, some sit in on a live circle first. Aug 11 2026 settled what the unplaced student sees: every tab stays visible, each with an empty state that explains itself (S69, S70), rather than a stripped-down app.
STAGE 03 · ORIENTATION — EVERYONE PLACED

Onboarding for the placed, and Year 2 rebuilt as its mirror

Recut Aug 2026. Year 1 loses two screens: S10 Welcome and S11 Your level are retired — S08 absorbs the welcome, and one level curriculum overview (S53) replaces both. Year 2 is rebuilt as a mirror of the same shape, in the order Lejla asked for: welcome, then the course (S30), then the weekly rhythm and what the live component is — which the build carries on one screen, S31 — and availability last, because it makes no sense to ask when someone can join live before they know what they are being asked about. That rule now holds in every lane. Year 2 arrives two ways: Level-4 graduates are auto-enrolled (celebratory — they can unenroll, and historically only ~20% continued); direct-entry students buy a Mastery elective on the web without ever having done Year 1, which is why S54 exists.

The walkthrough's New students entrance runs S01–S16 — arriving and this onboarding in one sitting, because that is what a brand-new student actually walks through. The map keeps them in two bands on purpose: only S02–S09 is new-students-only, while onboarding is also re-entry for level graduates, who never see the arriving lane. Same screens, two ways of grouping them.

EVERYONE PLACED · ONBOARDING · YEAR 1 (RECITATION ESSENTIALS)
S53
What your level covers
NEW · BRIEF
Aug 2026

What your level covers

One screen where there were two: the level you were placed in, and what its fifteen weeks actually teach.

Replaces S10 + S11, which the review called redundant.
S10
Welcome
Retired Welcome
Cut Aug 2026 (Lejla+Yasmine review). Kept for trace.
S11
Your level
Retired Your level
Cut Aug 2026 (Lejla+Yasmine review). Kept for trace.
S12
Your coach
REVISED · JUL 27 Your coach
Aug 2026: this is where the per-level welcome audio lives — the student's own teacher, pre-recorded. It is what replaces first-assessment feedback.
S13
The weekly rhythm
The weekly rhythm
The retired “Hear back” label is gone — frame and build both say Feedback.
S14
Live circles
Live circles
“Live circle” stays student-facing; Quran reading circle is the formal name.
S15
Availability — when could you join live?
REVISED · AUG 18 Availability
Asked last, after the structure is explained. Aug 2026: one question for anything live — circles and Year-2 one-to-ones. Aug 18: the time-zone control is a real picker over fourteen zones, where the arrow used to do nothing and tapping cycled them one at a time.
S16
Reminders
REVISED · AUG 18 Reminders
Shot for the map for the first time, from the v14 build. Aug 18 reversed the default: the three reminders start on — “you kind of want everyone to turn it on” — and any of them is turned off here, or later in Settings.
CUT · JUL 27 — Choose script (was screen 07), and the settings font picker with it.
Submissions are text-based, and the Madani source script has diacritic scenarios most fonts cannot render. Lejla and Yasmeen tested ~60 fonts; exactly one renders ~98% of cases. There is no choice to offer — the current app hides this same feature for the same reason.
RETIRED · AUG 2026 — S10 Welcome and S11 Your level.
“It's redundant.” S08 already welcomes the placed student and names the level; S53 carries what the level actually teaches. Both frames stay above, muted, with their connectors intact, so anyone tracing an old screen number still finds it.
YEAR 2 · MASTERY · ONBOARDING — REBUILT AUG 2026 AS THE YEAR-1 MIRROR
YEAR 2 · TWO ARRIVALSthe account status carries which
S54
Welcome to Mastery
NEW · BRIEF
Aug 2026 · direct entry

Welcome to Mastery

The arrival for someone who bought a Year-2 course on the web and has never done Year 1. Electives are sold outside the QuranFlow ecosystem, so this cannot be assumed away.

Same chain from here on; only the welcome differs.
S29
You graduated Level 4
NEW · JUL 27 You graduated Level 4
The graduates' welcome, and the only screen that differs between the two arrivals.
S30
Your course, and the electives after it
NEW · JUL 27 What Year 2 unlocks
The curriculum beat — the Year-2 answer to S53. Core course: Advanced Tajweed Rules, in three arcs. Electives after it: Intro to Memorization, Tajweed Practice.
S31
What changes — one week, one meeting
REVISED · JUL 27 Year 2 orientation
One screen carries both Year-1 beats mirrored: the weekly rhythm (S13) as Watch / Meet / Feedback, and the live component (S14) as the twenty-minute one-to-one that replaces the recording.
Fixed Aug 2026 (U-061): this chain no longer runs into any Year-1 weekly-loop screen, and no coach node hangs off its end. The coach corridor runs down the margin to the right of this band, not through it. Availability is asked at the end of the loop below, not here. The band is two rows, not three: the build folds the weekly rhythm and the live component into S31, so no uncoded screen is drawn here.
STAGE 04 · THE WEEKLY LOOP — WHERE THE APP SPLITS

The weekly loop

The lesson surface is shared; the content is not. Year 1 follows the semester's weekly lessons; every Year-2 course has its own syllabus and lessons. The universal Year-1→Year-2 change is the feedback format: appointment notes instead of submission feedback. Recut Aug 2026: S20 Lesson is retired — tapping a week square opens the player directly; S27 and S28 are retired — there are no corrected retakes, so feedback ends at listening; the Year-2 column now begins at a real appointments destination (S57) instead of a booking screen with no way in; and Learn gains the full-semester syllabus (S55) behind a button.

Recut again Aug 11 2026. Year 1 gains the two states its lifecycle was missing — a submission that comes back (S60) and the archive where every week's feedback lives (S50) — and loses S18, the pre-semester Today. Year 2's booking is rebuilt as a run of three screens (S33 → S62 → S63) with the conflict resolution recurring booking always needed; S40 and S36 are retired into S65 and S35. And the coach column, reviewed for the first time on Aug 6 and audited on Aug 11, doubles: nine screens to eighteen, in two acts.

Aug 18 2026: the coach column gets smaller on purpose. C17's one-to-ones fold back into C07, which is now one schedule with a filter; C13 is cut; C12 is superseded by a tagged thread in C15. Fifteen codes, three retired frames, and a tab bar that reads Home · Queue · Students · Schedule · Messages. In Year 1 the five-state submission vocabulary lands on every screen that carries a status, and the week no longer ends at listening — S26 can start a conversation.

ONE LESSON SURFACE · YEAR-2 CONTENT IS PER-COURSE
S42
Learn
REVISED · AUG 11 Learn
A five-by-three grid of numbered week squares with done and overdue states, a hero showing the next lesson you owe, and no invented topic groups. Year 2 sees their own course here. Aug 11: the grid is kept as built; practice is an optional attachment on a lesson, and there are no quizzes this release. Aug 12: a Resources row lands beneath the grid — the folder’s new home, in both Learn states.
S55
Full semester syllabus
NEW · BRIEF
Aug 2026 · behind the Learn button

The whole semester, week by week

Opens from Learn's “View full semester syllabus”. Fifteen weeks in order, so a student can see the shape of the term without tapping fifteen squares.

  • Weeks 1 to 15, in order
  • Each week's lesson and topic
  • What that week asks for
Asked for on the call; the week grid alone does not carry it.
S20
Lesson
Retired Lesson
Cut Aug 2026 (Lejla+Yasmine review). “S20 makes no sense — when I click on a lesson, it goes straight to the lesson player.” What was worth keeping moves onto S21. Kept for trace; no re-shoot spent on it.
S21
Lesson player
Lesson player
Aug 2026: video first and findable, videos as a set with thumbnails and watched state, and the week's notes and resources behind their own control.
YEAR 1 · SUBMISSION LOOP
S17
Today
REVISED · AUG 18 Today
The priority screen, confirmed as built on Aug 11: a swipeable deck carrying this week's lesson, the pending submission and fresh feedback; then live sessions; then filtered announcements. The header carries the bell alone — the one inbox, announcements inside it, with the fresh-announcement preview at the foot as the second door; the Aug 11 three-circle row came back out on Aug 12, resources moving to a row on Learn. The leftover Arabic blurb at the foot is gone. Before the term starts, this same screen carries the countdown with the week's items locked — which is what S18 used to be. Aug 18: the deck speaks the five states, and a week whose feedback is ready opens the feedback itself rather than the pending screen — “Feedback ready” is an invitation to listen, so it should not cost a second tap.
S18
Today — before the semester starts
Retired Today — before the semester starts
Cut Aug 11 2026, asked for directly: the ordinary Today carries a start-date countdown bar with the locked items greyed, so a separate pre-semester screen has nothing left to do. Kept for trace.
S56
What you are recording this week
NEW · AUG 11 What you are recording this week
Designed from the v12 brief: the passage named before the recorder opens, the week's instruction, then record. It is also where the coach's one or two focus points from the last review are waiting — “From your last review”. No attempts-cap language anywhere on it.
S22
Recording — ready
Recording — ready
Multi-card recitation chunks reusing the first-assessment pattern. Aug 11: the weekly-attempts model is removed from every screen — the cap itself, not just the counter.
S22
Recording — in progress
Recording — in progress
Same screen as above — S22's recording state.
S23
Recording — review
Recording — review
Aug 18: a speed control sits beside the player here too — “everywhere where there's audio recorded” (Lejla). Checking your own take before sending it is the same time-saver a coach gets.
S24
Recording — submitted
Recording — submitted
S25
Submission — awaiting review
REVISED · AUG 18 Submission — awaiting review
The ten-minute window is gone. Take it back and record again any time until the teacher opens it — no clock on the screen. Aug 18 shipped the state model agreed a week earlier and missed in the v13 build: Awaiting review → In review → Feedback ready, with Returned and Taken back as the two ways out. One state model, the same for the student, the coach and the admin portal; opening the review is what ends the take-back, so this screen is the awaiting state and the eyebrow no longer repeats the pill.
S26
Submission — feedback ready
REVISED · AUG 18 Submission — feedback ready
One conversational note, start to finish. Each point below is a word or phrase she tapped, with her voice on it — no typed instruction, no comparison clips. Aug 11: an anchor may span a phrase, not only a single word, and the “All your feedback” link is gone — the archive below is where every week lives. Aug 18: listening is no longer the most the student can do. A “Message your coach about this feedback” action sits at the foot, and what she sends arrives in the coach's one inbox tagged “About Week 8 submission” — a thread, not a note buried under an old submission. It does not spend her weekly message allowance. Every player on the screen gains a speed control.
S50
Assignments — this week, and every week's feedback
REVISED · AUG 18 Assignments — the archive
New to this map, Aug 11: feedback finally has a destination. The Assignments tab carries this week's work above a section labelled FEEDBACK — every past week, including the ones that came back. Aug 18: the archive speaks the same five states as everywhere else. “Practiced” and “Heard” are gone — they were states of the student's study habits, never of a submission — and every row now opens the screen its state belongs to.
S60
Submission — returned
NEW · AUG 11 Submission — returned
Rejected is a first-class state now, with a screen of its own: the returned recording, the teacher's typed reason in her own words, and “Record week 6 again”. A return never counts against the week — the week stays open. Amber, never red.
S27
Practice — corrections
Retired Practice — corrections
Cut Aug 2026 (Lejla+Yasmine review). No corrected retakes — submitting a fixed take goes against how the program evaluates. Kept for trace.
S28
Practice — review take
Retired Practice — review take
Cut Aug 2026 (Lejla+Yasmine review), with S27. Kept for trace.
YEAR 2 · APPOINTMENT LOOP
NO WEEKLY SUBMISSIONS IN YEAR 2 — the 1:1 and its notes replace the recording and its feedback
S57
1:1s — upcoming, past, and book another
REVISED · AUG 11 Appointments
Designed from the v12 brief, then split on Aug 11: Upcoming and Past are unmistakably separate, with “Book a 1:1” between them and past rows showing their notes. The explainer line above is driven by the plan the student actually bought. “1:1” is the working student-facing word now, in place of “appointment” — final wording still waits on Yasmine's copy pass.
S65
Your booked semester on one calendar
NEW · AUG 11 1:1s — month calendar
The 1:1 tab's own calendar view: the whole booked semester in one month grid, running to the last week of term. Half of what S40 was for. Aug 18: this calendar knows the semester — orientation, Week 1, the mid-semester break and semester end drawn as quiet gold rules, a week rail naming every row, and a “Semester dates” card. The anchors come from the admin semester setup.
S40
Week at a glance
Retired Week at a glance
Cut Aug 11 2026: the review said rebuild it as the booked-appointments week its annotation promised, or cut it. Between them, S65 above (the 1:1 tab's own calendar) and S64 (the month behind Sessions' calendar button) do everything a rebuilt S40 would. Kept for trace.
S33
Book a 1:1 — calendar first
REVISED · AUG 18 Book a 1:1
Rebuilt from the ground up on Aug 11: a month calendar with the openings counted on each day, over three equal rows — teacher, days that work, time of day — all starting at “Any”. Teacher-first, day-first and time-first are equals; the horizon is the whole fifteen-week semester. Aug 18: teacher choice is multi-select, and the plan note has moved to the foot — “too prominent for something that's supposed to be like just a small note” (Lejla).
S62
The day's open times, and how often
NEW · AUG 11 The day's open times
The second step progressive disclosure bought us: the day's open slots, teacher chips that survive fifteen teachers, a local-or-chosen timezone control, and the choice between just this Thursday and every Thursday made here rather than after booking. Aug 18: the teacher chips are multi-select here too, so nobody meets a single-select seam one screen after choosing two on S33.
S63
When a weekly booking hits a week already taken
NEW · AUG 11 Booking conflict
Recurring booking has to survive the weeks that clash. Each collision is shown with its two nearest alternatives and the option to skip that week — the fewest taps we could get it to.
S34
Booked
NEW · JUL 27 Booked
Booked, and easy to change later. Aug 11: it adds the way into the full 1:1 list and an add-to-calendar action. The cancellation window here is still owed a policy answer.
S35
A booked 1:1, and what to prepare
REVISED · AUG 18 Appointment detail
One appointment is one screen now: S36's teacher notes are folded in. Join Zoom and Calendar sit together, the recurring-or-one-off badge is gone, and “Swap this week's time” replaces “Reschedule”. The prepare block carries what the teacher published for next time. Aug 18 made both destructive moves safe: Cancel asks first — “people do be mist clicking” (Lejla) — and a swap names what moves, from which time to which, then confirms it happened. The full date sits under Time.
S36
Appointment — teacher's notes
Retired Appointment — teacher's notes
Cut Aug 11 2026: folded into S35 above, so one appointment is one screen rather than two. The past-1:1 view (S71) is the same screen after the fact. Kept for trace.
S71
A past 1:1, and the notes that stay
NEW · AUG 11 A past 1:1
What Year 2 gets instead of feedback on a recording: date, teacher, and the teacher's numbered notes. Text, never audio — no playback of the session anywhere. Aug 18: the full date sits under Time here as well, not just the weekday.
S15
Availability — asked last
REVISED · AUG 18 Availability
Same screen as S15 in the Year-1 lane, placed second here. Asked only once the student knows what a one-to-one is — the rule that now holds in every lane. Same frame, one shot: the two placements differ only in which step of how many it says it is.
S32
Today — Year 2
REVISED · AUG 11 Today — Year 2
Mirrors S17, with 1:1s where submissions were and the teacher's notes as the third card, soonest first. Aug 11: the dead Today tab is wired, and the verse closer at the foot is gone.
S37
Second semester — the elective she chose
NEW · JUL 27 Elective intro
Moved out of the arrival, Aug 2026: it is the second-semester beat, not a way in. Intro to Memorization, chosen at checkout. Change it in the first week while enrollment is open — email the admin team.
DECIDED · WAS Q13
Book the same slot every week
Decided · build it Appointment — recurring weekly
Q13 closed, and built in v13: “book every Thursday at 6pm up until the end of the semester” is offered on S62, and S63 resolves the weeks already taken. A bulk action producing individually cancellable appointments, not a locked string. Policy still open: slot hoarding, releasing after two no-shows, the cancellation window, and whether it is offered in week 1 only.
COACH · ROLE-GATED · FIFTEEN CODES
THE COACH SIDE The work itself: her day, the queue, a review, the roster, and placement. The tab bar is five, and Aug 18 changed which five — Home · Queue · Students · Schedule · Messages. Appointments stopped being a destination and became a view of Schedule; the slot it freed went to Messages, with its unread count on the bar. You stays behind the avatar on Home. One coach app serves every coach profile: a section that does not apply to her renders blank, never gated.
C10
Coach — her day first, the queue second
NEW · AUG 11 Coach — home
Three of eleven coaches review no submissions at all, so the coach app stops opening on a queue. Home is also the hub: curriculum, hours, announcements and her own corner all open from here. Aug 18: the coach header gains the notification bell the student app has had all along, and coaches reach the announcement board; Messages left this hub for the tab bar.
C01
Coach — review queue
REVISED · AUG 18 Coach — review queue
The filter pills really re-sort now — oldest first, by level, least submitted first. First assessments have left this queue for their own screen (C11). Aug 18 fixed the waiting time: it reads days plus hours (“1d 6h”), counted from the moment the student sent it, with no weekend arithmetic and no overdue colouring — “no special signalization” (Lejla), because a number that ignores weekends cannot fairly imply lateness. Awaiting and In review are separate rows now, not one bucket.
C02
Coach — a review starts empty
Coach — a review starts empty
Where a review begins: nothing recorded, one note to speak, and any word she taps becomes an anchor. Aug 11 fixes the three that mattered — the player stays with her as she scrolls, her notes are readable and writable here, and a recording saves as it runs. Aug 18: opening a review is what moves the submission to In review and closes the student's take-back, so this screen is where that state begins.
C03
Coach — review a submission
REVISED · AUG 11 Coach — review a submission
The finished review: one voice note, one anchored word or phrase, then send — unconditional now that the private tier is gone. Her one or two focus points carry forward to the next review and to the student's S56. “Return this recording instead” is the other way out.
C04
Coach — what she owes this week
REVISED · AUG 11 Coach — what she owes this week
The roster became a workload view: five to review, one still to send, twelve days since the quietest student was heard from — plus each student's semester, feedback count and current score. Pass/fail sits padlocked until the end-of-course evaluation opens.
Still open: what coaches actually need on this screen. It is the one place the audit could not answer without them.
C05
Coach — a student's record
REVISED · AUG 18 Coach — a student's record
Submissions, feedback, one-to-ones and attendance in one chronological scroll, with tenure and mistake history. Notes are two named tiers — “Student notes — Sarah reads these” and “Coach notes — every coach assigned to her” — and the word private appears nowhere in the build. Aug 18: every note carries its date, and the identity line answers the question a coach opens the record to ask — which intake, which level, when: “3rd semester · Fall 2024 intake”, “Level I completed Dec 2024”. Students do return years later.
C06
Coach — a new student's record
Coach — a new student's record
The same record with nothing in it yet, which is what most records look like in week one. Aug 18: the empty record still answers the intake question — “1st semester · Summer 2026 intake”, “No previous level with us” — because nothing before this is itself an answer. Her intake now agrees with the roster on C04, which it had drifted from.
C11
Coach — placement is a level, not feedback
NEW · AUG 11 Coach — placement
First assessments arrive on the shared first-assessment account and leave the general queue: four stages with skips shown as skips — “Stage 4 was skipped. Skipping is allowed and noted” — and a level control. This is the screen behind S08: a coach sets the level here, and the student's semester opens.
COACH TOOLS Everything that is not a submission review: her schedule, the notes after a one-to-one, the curriculum, her inbox, announcements, hours, and her own corner. Aug 18 made this act smaller and truer — one schedule instead of two, and two frames retired into the trace row.
C07
Coach — one schedule, filtered
REVISED · AUG 18 Coach — schedule
v13 split this in half — classes here, one-to-ones on C17. Aug 18 put it back together, on a reason all three voices agreed on: a coach plans her day as one day. One schedule behind Everything · Live classes · Appointments, with Everything the default. The cohort filters are gone and the cohort is a tag on the row instead, so two cohorts teaching the same afternoon read in one view. “8 registered” is gone with them: there is no per-event opt-in, so there was nothing to count. Reminders and add-to-calendar moved to a quiet settings control in the header. My schedule / Full semester stays.
C07
Coach — the same schedule, filtered to 1:1s
REVISED · AUG 18 Coach — schedule, appointments view
The same screen with the filter set to Appointments — the walkthrough teaches C07 in two chapters for exactly this reason. Everything the retired Appointments tab carried lives here: today, coming up, and the past one-to-ones still owing their notes. Full semester does not render in this scope, because one-to-ones are only ever hers.
C17
Coach — every 1:1, past and upcoming
Retired Coach — appointments
Merged Aug 18 2026 into C07, not cut: its rows are the Appointments view above. Lejla asked for “the full schedule, but for there to be like filtering button”; Yasmine: “they could go together at this point in time.” The tab slot it freed went to Messages. The code is retired and never reissued; the frame keeps its v13 picture for trace.
C08
Coach — after the 1:1
REVISED · AUG 11 Coach — after the 1:1
Attendance and no-show are marked by the coach — Zoom is third party, so nothing is inferred from a join. The note carries what was covered, what to work on and what is next, and the next reading publishes to the student's side. No session recordings; she reads it as text.
C13
Coach — live class: roster, attendance, speaking turns
Retired Coach — live class
Cut Aug 18 2026. Lejla: “Screen isn't needed.” Sessions run in Zoom, and marking as many as 250 possible attendees is not work anyone would do. What survives is not a screen: the app records how many students tap Join on each session, and that count is reportable in the admin portal — which is what the attendance numbers were ever wanted for. On C07 the live row's Join still hands off to Zoom; the chevron that used to open a roster is gone rather than re-pointed. Kept for trace, code retired.
C14
Coach — every level, every week, and the resources
NEW · AUG 11 Coach — curriculum
Opened from a review without losing it: the whole lesson catalogue, each level's weekly topics, the week's texts and prep notes in one place, and a copy-link on every item to paste into the note in hand. It restores what coaches used to be sent by hand.
C15
Coach — her inbox
NEW · AUG 11 Coach — messages
A coach could not reach a student at the moment she most needed to. Threads with students — with or without an appointment in the way — and a channel to the program team. A main tab from Aug 18 on, carrying its unread count on the bar, because messages were what coaches named first: “the number one thing” in the collected feedback. A student's question about a piece of feedback arrives here, tagged with its week, rather than under an old submission where it goes unseen. One inbox, one thread per student, voice or text in the format it was sent.
C12
Coach — a student's short reply to feedback
Retired Coach — student reply
Superseded Aug 18 2026 — and the proposal itself was accepted. The reply channel five of eight surveyed coaches asked for is in the build; what is not is a surface of its own. A message about feedback is sent from the foot of S26 and lands in the coach's one inbox, C15 above, tagged “About Week 8 submission”. Lejla asked for “a singular inbox for the teacher”; a reply parked under its submission is precisely the pattern that loses messages today. Kept for trace, code retired.
C18
Coach — an announcement, in her own name
NEW · AUG 11 Coach — announcement
Targeted by level, gender, semester and year, with the audience counted before she posts, so a class that is running late is announced by the person who is late.
C16
Coach — hours in the app, instead of a second app
NEW · AUG 11 Coach — hours
Decided in the live session: in-app hours replace Time Clock Wizard. All three work types logged for her, correctable with a one-line reason until the period closes, with the period total, its approval state and an export for finance. The finance-side end of it is still open.
C09
Coach — you
REVISED · AUG 11 Coach — you
Reached from her home, because the bar's five slots are spoken for: You lives behind the avatar. Her own corner — hours worded off the C16 model, her profile to edit, and the way back to her student app.
STAGE 05 · SHARED SURFACES — CONVERGE, EVERY STUDENT

Shared surfaces

Identical across statuses; only Sessions is status-aware. Grown Aug 11 2026: the month calendar behind Sessions' calendar button (S64), resources and previous levels as real destinations (S61, S68), and a You tab with account substance in it — subscription and billing (S66), and a learning history that means previous enrollments rather than a list of submissions (S67). The tab bar is confirmed at five: Today, Learn, Assignments, Sessions, You.

S38
Sessions
Sessions
1:1 rows appear only for Year 2. Live classes launch Zoom; there is no in-app player.
S64
The live month
NEW · AUG 11 Sessions — the month
What the calendar button on Sessions opens. The other half of what retired S40 was for. Aug 18: the calendar knows the semester — orientation, Week 1, the break and semester end as quiet gold rules, a week rail from W4 to W15, the selected day's week in the header, and a Semester dates card.
NO CODE
Live class
Live class
Designed, but not a walkthrough chapter — so no code. S39 is Session detail, a different screen; Aug 11 stopped it promising per-session content it cannot have.
S49
Announcements
REVISED · AUG 11 Announcements
One way, no noise — and filterable by level now: All, Level II, Everyone, New students.
THE LEARNING SPACE, AND THE ACCOUNT — NEW AND REVISED AUG 11
S61
Resources, with a place of their own
NEW · AUG 11 Resources
Reached from its row on Learn (Aug 12 — the Today header circle came out with the rest of the quick-access row). This level's kit, and the ways into the full syllabus (S55) and previous levels.
S68
Previous levels
NEW · AUG 11 Previous levels
Earlier levels' videos and lessons, and every past recitation with its feedback — across semesters and years, inside the learning space rather than the account. Aug 18: a speed control beside each player, since going back through a term of your own recordings is exactly the case for it.
S45
Messages
REVISED · AUG 18 Messages
Year 1 messages the coach she was given; Year 2 messages the teachers she has booked. Aug 18 settled what had been deferred twice: voice or text, presented in the format it was sent, with transcription on demand rather than by default, and a speed control on every voice bubble. One thread per student, from either seat. A message sent from S26 rides in with its tag and does not spend the weekly allowance.
S43
You
REVISED · AUG 18 You
Real account substance: enrollment, billing, subscription, the semester. The “view the coach app” row is gone, and so is the welcome voice note — it belongs to onboarding. Aug 18: the screen reads account, then support, and support carries the two sanctioned channels — message your coach for anything academic, contact the program for everything else. The Display section, the Announcements entry and the “All versions” dev link are gone; the support wording widens beyond troubleshooting and waits on Sr. Yasmine's copy pass.
S66
Subscription and billing
NEW · AUG 11 Subscription
What she is enrolled in, what it costs, and the semester it pays for.
S67
Learning history
NEW · AUG 11 Learning history
Learning history means previous enrollments, not a list of submissions. Three terms, not three recordings.
86 frames on the map · 82 carry walkthrough codes, which is 79 distinct codes · 101 connectors drawn · 15 revised Aug 18 · 19 new Aug 11 · 9 revised Aug 11 · 11 retired and kept for trace · both proposals answered Aug 18, so none is open · 4 briefs still undesigned (S52–S55) · 4 frames carry no code (the two off-app web cards, the Live class artboard, and the Q13 decision card).
Aug 18 2026: two proposals answered, and one coach tab that turned out to be a filter. The product review with Lejla and Sr. Yasmine closed both questions the map had been carrying in amber. C13, the live-class surface, is cut — “Screen isn't needed”: sessions run in Zoom, marking 250 possible attendees is not work anyone would do, and what the attendance numbers were wanted for is served by counting Join taps in the backend. C12, the student's reply to feedback, is superseded, and the distinction matters: the reply channel was accepted. It ships as a tagged thread — a “Message your coach about this feedback” action at the foot of S26, arriving in her one inbox marked “About Week 8 submission” — because a reply parked under its own submission is exactly how messages get lost today: “we missed so many messages from students because we had no idea that they had put a message under some old feedback” (Yasmine). C17, the appointments tab, merged into C07: one schedule behind an Everything · Live classes · Appointments filter, because a coach plans her day as one day. The tab slot it freed went to Messages, the surface coaches named first, so the coach bar reads Home · Queue · Students · Schedule · Messages, five and no more. One coach app serves every coach profile; a section that does not apply to her renders blank rather than gated.
The states, take two. The one submission state model was decided on Aug 11 and missed in the v13 build — Lejla caught it on Aug 18, and Kamran: “it should have been.” It ships first in v14: Awaiting review → In review → Feedback ready, with Returned and Taken back as the two exits — one model for the student, the coach and the admin portal alike. “Practiced” and “Heard” are gone from types, fixtures, pills, filters and copy; they were states of a student's study habits, never of a submission. Alongside it: the queue's waiting time reads days plus hours from the moment the student sent it, with no overdue colouring — “no special signalization” (Lejla); booking asks before it cancels and says what a swap moved, from which time to which; the month calendar knows the semester's anchors and week numbers; coach notes carry dates and a student's record answers which intake and which level, when.
The coach lane, Aug 11 2026: nine screens to eighteen. The coach app was reviewed for the first time on Aug 6 and audited against the April 2026 coach survey on Aug 11; the verdict was that the shape was right and the surface far too small — “nine screens is not enough.” What was there survives with its P0s fixed (C01 filter pills that really re-sort, C02/C03 with a player that stays put, notes she can write in the review, and autosave; C04 as a workload view; C05 with the chronological spine and two named note tiers). What is added: C10 her home, because three of eleven coaches review no submissions at all; C11 placement, out of the general queue; C17 the 1:1 tab both reviewers asked for by name; C14 the curriculum she used to be sent by hand; C15 her inbox; C18 announcements in her own name; C16 hours in the app instead of Time Clock Wizard. That round's tab bar was Home, Queue, Students, Appointments, Schedule; Aug 18 replaced Appointments with Messages, and You has been behind the avatar on Home (C09) since.
Retired Aug 18 2026, joining the eight before them: C13 the live-class surface (cut — the screen isn't needed), C12 the per-submission reply (superseded by the tagged thread that ships in its place), C17 the appointments tab (merged into C07, which now carries it as a view). Retired Aug 11 2026: S18 Today before the semester starts (the ordinary Today carries the countdown with its items locked, so a second screen has nothing to do), S36 the appointment's teacher notes (folded into S35, so one appointment is one screen), S40 Week at a glance (rebuild it as the booked week its annotation promised, or cut it — S65 and S64 do the job between them). With S10, S11, S20, S27 and S28 from Aug 5–6 that is eleven retired codes, all still on the map, muted, each keeping one incoming connector so an old screen number resolves to something rather than dangling. A retired code is never reissued.
New student screens, Aug 11 2026. The submission lifecycle: S60, a recording that came back with the teacher's reason and a way to record it again, which never counts against the week; and S50, the archive that finally gives feedback a destination. Booking, rebuilt calendar-first: S62 the day's open times with just-this-once or every-week decided there, and S63 the conflict screen recurring booking always needed. The two month calendars retired S40 was standing in for: S64 behind Sessions' calendar button and S65 for the booked semester. The learning space: S61 resources and S68 previous levels. The account: S66 subscription and billing, S67 learning history meaning previous enrollments. Level 0: S69 and S70, the visible-but-empty tabs that settled the hide-the-tabs question, and S71, a past 1:1 whose notes stay. Two v12 briefs are now drawn screens: S56 and S57.
The submission state model is one model everywhere, student side and coach side, and as of Aug 18 the build says so too: unsubmitted → awaiting review → in review and locked → reviewed, returned or taken back. Take-back lasts until the teacher opens it, not ten minutes (S25), rejection is a first-class state (S60), and the weekly-attempts cap is gone from the model, not just from the screen.
Q13 closed Aug 6 and built Aug 11: recurring weekly booking is offered on S62 and its clashes resolved on S63 — a bulk action producing individually cancellable appointments. What stays open is policy, not the screen: slot hoarding, release after two no-shows, the cancellation window, week-1-only.
Carried from Aug 5–6: Year 2 is the Year-1 mirror — welcome (S29 for graduates, S54 for direct entry) → the course (S30) → what changes (S31) → S57 → booking → the 1:1 → availability last (S15) → S32 Today → S37 second semester. S15 appears twice on this map, S22 twice and C07 twice — one screen shown in two placements or two states — which is why 82 coded frames is 79 distinct codes. C02/C03 and C05/C06 are the same pair of habits on the coach side, and the walkthrough teaches C07 as two chapters for the same reason.
PROPOSED marks implied solutions derived from Lejla's facts, for her review: the “your first recitation” rename (Q16), the practice-first register, the auto-placed result tone, the sign-in help affordance.
What Aug 18 settled that had been open: the student reply channel is in, as a tagged thread; no live-class surface ships; messaging lives in one inbox per side, reached from a tab on the coach's bar. What is still open is listed with its register number on the open questions page: how far the hours change goes on the finance side, what coaches actually need on C04, and the rescheduling exception, which waits on Lejla's call and travels with the booking walkthrough she and Sr. Yasmine owe. All wording anywhere on this map is directional until Sr. Yasmine's copy pass; the visual-identity question is deliberately held for a separate later round.
Registration & payment stay on the web — off-app by design (no 30% App Store fee); the codes above are the pronounced screen numbers coaches cite in voice-note feedback, and the walkthrough ships as four named entrances from one build.
Eighty frames carry a screenshot; six do not — the four briefs still undesigned (S52 profile completion, S53 level curriculum, S54 Welcome to Mastery, S55 full semester syllabus) and the two off-app web cards, which are not screens. S16 Reminders is shot for the first time this round, so no coded frame is a placeholder any more. The thirty-four filenames suffixed -v14 are captures of the walkthrough v14 build (handoff/walkthrough/app/dist/, Aug 18 2026) at 393×852, one of them (availability-v14) used by both S15 placements; every frame the Aug 18 review changed is one of them, including the coach frames whose own screens did not change but whose tab bar did. Three frames deliberately keep their v13 pictures: C12, C13 and C17, whose screens no longer exist in the build — a retired frame's picture is a record of what was decided, not of what is running. The remaining -v13 and older filenames are frames this round did not change; a number of those are Sakīna artboards (handoff/mockup/) still carrying the mono face retired on Jul 27 and a drawn device bezel, so they read a little older than the shots beside them. · Map sources: Kamran × Lejla, Jul 24 2026; app review with Lejla, Jul 27 2026 (reviews/App-Review-Jul27-Lejla.md); flow-map review with Lejla and Yasmine, Aug 5–6 2026 (reviews/QF-App-Feedback-*); coach-app session, Aug 6 2026; Lejla's coach-side audit and the change-document review, Aug 11 2026 (reviews/v13-review-response/); product review with Lejla and Yasmine, Aug 18 2026 (reviews/v14-review-response/) · Open questions for Lejla →
Every coded screen is live: tap through it in the guided walkthrough or first-person in the app.