The ambient layerQuranFlow · v6 · Aug 26 2026 · the journey verdict
v5 asked what the widgets look like; v6 asks what earns a place. The app is opened two or three times a week, but the week holds ~13 "knowing" tasks a glance can satisfy — so the board is rebuilt as the week itself, Saturday's drop to Sunday's close, showing only the surfaces that survived a journey test: what decision does this change, at what moment, without opening the app? Every v5 code is accounted for in the ledger. Evidence: the capability map, the Nov 27 audit, PRODUCT-SPEC/DATA-MODEL, the Lejla record, and a two-sided design debate on the verse.
What changed in v6
- The journey is the spine — v4's week structure returns, re-anchored on Monday's level class.
- Every v5 code gets a verdict in the ledger. Cut: the verse pair, the instrument, the numeral-turns frame; the sage square merges into W20.
- Attempts language removed everywhere — the cap was struck Aug 11 (U-176). Submissions read "Sent Wed 9:12 PM," never a counter.
- The passage citation moves onto This Week's Record row — the knowing-task the verse widget used to carry, in four words.
- Two new frames: W19 the Saturday drop (the lesson title's first ambient appearance) and W20 Today's Sessions (one design, two sizes).
- The verse becomes the Illumination (W21/W22 + SB1): a complete ayah or a designed ornament, never a clip. Kept as an opt-in choice, P2 — a brand call with Lejla.
- The This Week family and Year 2 redesigned (W19/W02/W17/W18/W05/W12 + W06/W07): checklist rows out, W20's tile grammar in — one hero row, identity disc, state in the corner (Kamran, Aug 26).
- Half the words — verdicts and laws stay; essays don't.
A widget earns its place by the decision it changes
Gold appears only where an act exists
A complete ayah or no ayah — never a clip
No counters (U-176) · no streaks · no invented urgency
Times viewer-local · Lock Screen exempt
The ledger · every v5 code, accounted for
| Code | Frame | Verdict | Why |
|---|---|---|---|
| W01The Week | small · dark | Keep | The flagship; audit #1 at zero clicks. Dec 2 asked for exactly this. |
| W02This Week | medium | Keep · redesigned | Checklist rows out, tile grammar in (Aug 26); citation rehomed; attempts copy gone (U-176). |
| W03·W04The Verse | paper · dark | Superseded | Rehearsal is in-app (mushaf script, N-ayat scroll). Successor: W21/W22. Watch verse: cut outright. |
| W05The Woken Widget | feedback ready | Keep · redesigned | The payoff beat (audit #3), now a person: her name on the gold-ground note mark. |
| W06·W07Year 2 | redesigned | Keep · redesigned | Ad-hoc booking makes forgetting the default; the old frame borrowed Y1's rows at 11px — replaced with appointment-led anatomy. |
| W08The Open Invitation | arriving | Keep | Students give up in weeks 1–2; this is that window's surface. |
| W09The Coach Queue | medium | Keep · P2 | Ships only with push-updated data; a stale SLA gauge is worse than none. |
| W10Tonight's Circle | sage square | Merged → W20 | W20's small size is this frame. One design, two sizes. |
| W11The Instrument | capsule | Cut · parked | Same job as W01's strip — a style A/B, not a second surface. |
| W12The Returned Flip | medium | Keep · redesigned | Something came back — same anatomy as W05, the deeper-wash chip, same push. |
| W13The Numeral Turns | boundary | Demoted | A behavior of W01 (numeric transition), not a surface. |
| W14–W16The Week's year | states | Keep | W14 answers the question that survived five emails — with a date. |
| W17·W18The waiting pair | states | Keep · redesigned | Buttonless on purpose; the sent submission is the hero, the chip sits in the corner. |
| LS1The Lock Screen | exempt | Keep · re-anchored | Arguably #1: the timezone failure dies on the wallpaper. Now Monday-class anchored. |
| LA1The Session Island | expanded | Keep · gated | P3, ActivityKit push. Revoke-activity copy synced too. |
| W19The Saturday Drop | NEW | New | The lesson title on an ambient surface, the weekend it lands. |
| W20Today's Sessions | NEW | New | Up to 20 sessions/week; "couldn't find a session I knew was happening today." |
| W21·W22The Illumination | NEW | P2 · a choice | The keepsake under the whole-verse contract. Opt-in; brand call with Lejla. |
The frames, named · active codes
W01The Week · small · dark
W02This Week · medium
W05The Woken Widget · feedback ready
W06Year 2 · The 1:1 · redesigned
W07Year 2 · Notes Ready · woken
W08The Open Invitation · arriving
W09The Coach Queue · medium
W12The Returned Flip · medium
W14The Week · pre-semester
W15The Week · feedback ready
W16The Week · semester complete
W17This Week · awaiting review
W18This Week · in review
W19The Saturday Drop · NEW
W20Today's Sessions · NEW · two sizes
W21The Illumination · verse state
W22The Illumination · ornament state
SB1The Bedside · StandBy · P3
LS1The Furnished Lock Screen · exempt
LA1The Session Island · gated
Codes continue from v5; cut codes are never reused. v5 stays frozen as the before/after record.
Saturday morning · The drop — "new week, what's it about?"
W19The Saturday drop NEW P1 Year 1 + Year 2
Content unlocks Saturday, two days before classes. The topic is the news, so the drop state leads with the title.
W19This Week · the drop state
Week 8 · NewDue Sun, Nov 1
Idgham with ghunnah
3 videos · 15 min · Al-Mulk, verses 1 to 3
Start the lesson ▸
W01The Week · fresh
Week
8of 15
Idgham with ghunnah
- One line carries the whole assignment: videos, honest duration, citation.
- The deadline is dated here — on Saturday, "due Sunday" would read as tomorrow. From Monday the weekday is unambiguous and the header reverts.
- Decision changed: watch this weekend, arrive at Monday's class with questions — the program's own rhythm.
- At Sunday midnight the numeral rolls 8 → 9 (system numeric transition) and the line becomes the new topic. That's the whole celebration.
Monday 9:40 AM · The anchor — "class is when, in my timezone?"
LS1The Lock Screen, re-anchored P1 Year 1 + Year 2
The week's anchor is Monday's level class. Timezone-correct countdown on the wallpaper — the "6 am Friday" failure dies here, hours before the session, where it actually happens.
Week 8 · Level class 10:00
Monday, October 26
9:40
20m
LEVEL CLASS · 10:00 AM
in 20:14
Join opens 9:45
ق QuranFlow
Level class at 10:00 AM
Idgham with ghunnah, with Ustadha Radwa. Join opens 15 minutes before start.
⚲
◉
- Vibrant material exempts this surface from the vibe pass; dynamic-date tick, zero refresh budget.
- Add-to-calendar is this frame's sibling (Lejla's ask) — plumbing on session and booking surfaces, not a widget.
LA1The session island Gated · P3 Year 1 + Year 2
When ActivityKit push lands. Join stays the gold act; the revoke activity carries over with its counter copy synced (U-176).
LA1Expanded · long-press
Level class
Monday session · 10:00 AM
13:58TO JOIN
Live at 10:00 · Join opens 9:45Join
- Android twin: a 16-era Live Update, degrading to an ongoing notification. The v5 Android annex carries forward whole.
Tuesday afternoon · The circles — "what's on today?"
W20Today's Sessions NEW P2 All journeys
Up to 20 sessions a week, and students "couldn't find a session they knew was happening today." One computed, viewer-local answer, in two sizes.
W20systemMedium · today's list
2:00 PM
7:00 PM
Today · TuesdayOct 27
Sisters' Reading Circle
with Ustadha Radwa
Level II class
with Ustadha Radwa
Nothing else today
W20systemSmall · the next one
2:00 PM
Sisters' Reading Circle
with Ustadha Radwa
- One design, two sizes — the medium lists today (three rows, then "+1 more"); the small shows the next session in W10's sage-square anatomy.
- Species color per row — sage circles, plum classes and 1:1s — the day's shape before a single word.
- No button, by law: a schedule has no single act. Inside the 15-minute window the next row grows a Join — the one moment it does.
- "Nothing else today" closes the list, so silence can be trusted; when the next session isn't today, the timebox gains the day ("Thu 7:00 PM").
Midweek · The recording — "did I record yet? what passage?"
W02This Week, corrected P1 Year 1
Redesigned to the tile grammar (Kamran, Aug 26): the checklist rows are gone. The current step is the hero — identity disc, real-size title — with the state in the corner, where W20 puts its timebox.
W02Midweek · recording next
Week 8Due Sun 11:59 PM
Idgham with ghunnah
2 of 3 watched
Then record: Al-Mulk, verses 1 to 3
Continue lesson ▸
W17Sent · awaiting review
Awaiting review
Week 8Due Sun 11:59 PM
Al-Mulk 67:1–3
Sent Wed 9:12 PM
Feedback within 48 hours of submitting
W18In review — the coach has it open
In review
Week 8Due Sun 11:59 PM
Al-Mulk 67:1–3
Sent Wed 9:12 PM
Feedback within 48 hours of submitting
- One grammar across every medium now: eyebrow · hero row · corner · one act. The corner holds the time; the state chip takes it only when there is no time to show (W07's chip sits under the name because its corner holds the ended 1:1's time).
- "2 of 3 watched" is the lost-place answer; "Then record: Al-Mulk, verses 1 to 3" is the citation, rehomed.
- The waiting pair stays buttonless — nothing asked, nothing gilded. "Feedback within 48 hours" is the app's own promise line, so she doesn't reopen to check.
- Attempts language is gone everywhere (U-176) — no counter exists to show.
Friday afternoon · The word back — the beat she isn't watching for
W05The woken widget P1 Year 1 only
The strongest beat in the program is a person replying — so the hero is the person. The note mark on the gold ground, her name at full size, the state in the corner, gold on the act.
W05Feedback ready — woken
Feedback ready
Week 8Due Sun 11:59 PM
Ustadha Amina
Al-Mulk 67:1–3
Play feedback ▸
W12Returned — wants something back
Returned
Week 8Due Sun 11:59 PM
Ustadha Amina
With a written note
See what she said ▸
- Her name replaces a status table — the widget names the relationship, not the pipeline. Both states ride the existing feedback push.
- The status word crosses the Lock Screen; her notes and the written reason never do (W6). W01's gold line (W15) flips in the same moment.
Sunday · The close — and the widget's whole year
W01The Week's year P1 Shared
Derived, never stored. Sunday answers "am I done?"; at midnight the numeral rolls and the ninth segment turns gold.
W14Pre-semester
Fall semester
Sep 7
Begins Monday
W01Sunday · closed
Week
8of 15
Practiced · week complete
W15Feedback ready
Week
8of 15
Feedback ready
W16Complete
Week
15of 15
Semester complete
- W14 answers with a date, never a countdown; the empty strip promises the shape of what's coming.
- "Semester complete" is a full strip and a fact — no badge, no share sheet.
The chosen widget · The Illumination — kept as a choice, not a default
The utility set speaks only in obligations, to an audience documented as perfectionist — and Lejla's brief is "warm, personal, not a cold hard numbers app." The Illumination is the one surface that asks nothing: devotional presence, not rehearsal — her program on the Home Screen as something she loves, not only something she owes. The opt-in second widget. P2 — a brand call with Lejla.
W21W22The two lawful states P2 · opt-in Year 1 + Year 2
A complete ayah or no ayah — the text is never harmed to fit.
W21Verse state · a complete ayah fits
W22Ornament state · no single ayah fits
Al-Mulk · 1 to 10
Week 10
Week 10
SB1The bedside · StandBy · P3 · iOS only
11:04 · Sat Oct 31
تَبَارَكَ الَّذِي بِيَدِهِ الْمُلْكُ وَهُوَ عَلَىٰ كُلِّ شَيْءٍ قَدِيرٌ
Al-Mulk 67:1 · Week 8
- The contract: one complete ayah from this week's passage, fit decided at timeline build — never an ellipsis. No ayah fits → the shamsa and the citation. Kills the lengthening-passage objection for any future curriculum.
- Concedes permanently: the rehearsal claim (practice reads in-app, on mushaf script), every watch/accessory placement, the Lock Screen.
- No counter, no button, no state; changes only at the week boundary. Read and never tapped is success.
- Tinted/clear modes: the paintings die in recoloring — fallback is the completion-shamsa template vector + citation.
- The counter-case, recorded: unmeasurable by design; warmth already lives in the utility set's chrome. Hence P2 and a choice, not P1 and a default.
The other journeys · arriving · Year 2 · coach
W08The open invitation P1 Arriving
The first-two-weeks window is where students give up. v3-correction copy untouched — no date, no countdown, no counter — now on W19's serif-hero skeleton.
Your first recitation
Whenever you're ready
The reading is here when you are.
Read it through ▸
- Post-send: "With your teachers," no button. The second lit surface is tonight's circle — W20 computes it; Level-0 sessions exist in the fixtures.
- The corner stays empty: nothing is due and nothing is counted.
W06W07Year 2, redesigned P1 · Nov phase Year 2
The old frame borrowed Year 1's checklist rows at 11px. An appointment is an identity — who, when — not a step: it now gets the session-tile anatomy, and the lesson becomes one line.
W06Booked · lesson open
Tue 9:20 AM
Week 8 · Year 2Advanced Tajweed
Your 1:1 with Ustadha Amina
Lesson first · 12 min
Continue lesson ▸
W07After the 1:1 · notes ready
Tue 9:20 AM
Week 8 · Year 2Advanced Tajweed
Your 1:1 with Ustadha Amina
Notes ready
See notes ▸
- The 1:1 is the centerpiece — disc, name, timebox at full size (13.5px title, up from 11) — because the booked slot is what gets missed.
- The timebox goes past-tone once the 1:1 ends; Notes ready wakes the surface, same as Year 1's flip.
- Unbooked week: the row reads "No 1:1 booked yet" with a gold "Book this week ▸" — a fact and an affordance, never a slot count (Q14).
W09The coach's queue P2 · role-gated Coach
The qalam mark, the plum gauge — gold is not a meter; the 48h window now sits in the corner. Ships only with push-updated data.
Review queue
48h window
6 waiting
Oldest 39h
Start reviewing ▸
- The coach's next-session countdown shares LS1's anatomy — role-gated, coach-local time, one codebase.
The ladder · rebuilt from the verdicts
P1 · ships with the app
- W01 The Week + W14–W16 + the W19 drop state
- W02 This Week + W17/W18/W05/W12 — one push, both flips
- LS1 next-event countdown, Monday-class anchored
- W08 the arriving invitation
- The Android Glance twins — one design, both platforms
Year-2 phase · Nov
- W06 / W07 — the redesigned 1:1 widget
- Appointment Lock Screen countdown (reload on booking)
- Coach next-session countdown
P2 · chosen and earned
- W20 Today's Sessions (both sizes)
- W21 / W22 The Illumination — brand call with Lejla
- W09 coach queue (push-gated)
- Revoke Live Activity, copy synced
- Intents fan-out + add-to-calendar (Lejla's ask)
P3 · evidence-gated
- LA1 session island · Android Live Updates
- SB1 the bedside (StandBy, iOS-only)
- Smart Stack · watch / Wear OS decision
- Tinted / clear / Liquid Glass placement QA
Minimum ship, if only three: W01, W02, LS1 — all three audit findings covered, Android-portable. Success: students arrive already oriented; "what week is it?" questions disappear. The Illumination's success is being read and never tapped.
Considered and set aside
| Idea | Why not |
|---|---|
| Streaks · day counters · composite percentages | Standing law — and U-176 removed even the product's own attempts counter. |
| The verse as rehearsal (old W03 contract) | Practice reads in-app; mushaf fidelity is a P0; N-ayat passages scroll — widgets can't. Succeeded by the Illumination. |
| The verse on watch / accessory | Cut unanimously: Arabic at complication scale is quotation without dignity. |
| A separate next-circle square (W10) | Folded into W20's small size. |
| The instrument as a second week surface (W11) | A style A/B of the strip, parked. |
| Multi-module dashboard / systemLarge Today | One idea per widget; the computed next action is the answer. |
| Waiting countdowns · days-waiting counters · slot nudges | No urgency the product doesn't enforce; no guilt counters (Q14 stays with Lejla). |
| Coach notes or written reasons on the Lock Screen | The status word travels; content never does (W6). |
| Dawn at full strength on widgets | Tinted/clear strips backgrounds; the whisper is the ceiling. |
Fixture note: Week 8 of 15 (Mon Oct 26 – Sun Nov 1), Monday 10:00 AM level class "Idgham with ghunnah" and Tuesday 2:00 PM Sisters' Reading Circle + 7:00 PM Level II class (Ustadha Radwa); sent Wednesday 9:12 PM, feedback Friday, due Sunday 11:59 PM viewer-local; passage Al-Mulk, verses 1 to 3 (W22's ornament example cites week 10, "Reading Al-Mulk"). Attempts language gone per U-176. Status words = the app's one-source SubStatusPill vocabulary; chrome = theme/vibe-kit.tsx / theme/vibe.tsx verbatim; marks and the shamsa/tazhib paintings are the app's own assets. Evidence: capability map · Nov 27 audit · PRODUCT-SPEC/DATA-MODEL · the Lejla record · the Aug 26 Fable debate. v5 (re-skin, before/after) and v4 (concept board) stay frozen in this folder; the Android annex lives in v5 and carries forward.