A community music school's day view. Ines Ferreiro teaches cello and musicianship at Whitethorn; this is her Friday, read on a phone while she walks between the studios.
Direction
Archetype. Feed. One time-ordered column, unbounded, read top to bottom.
Data stance. Prose-first. Each card opens with a sentence written from the record. The times, rooms, and names sit under it as evidence, in a definition list.
Density. Comfortable, touch-first. 48px day marks, 40px controls drawn inside a 48px hit area, 8px between cards.
The bold thing. Shape says state, and it says it three times: on the card, on the block that draws the same lesson in the day map, and on the bar in the week view. 0px taught, 12px settled, 28px in progress, and the lopsided 28px/0px edge for a lesson waiting on a decision. The selected day mark morphs from a circle to a 16px rounded square on the expressive spatial-fast spring. Settling a decision morphs the card and slides its block between room lanes on spatial-default; the clash halo behind it clears.
Round two, the first fold. One emphasized moment sits above the map: the Studio 2 clash as a tertiary-container hero in the lopsided 28px/0px edge, headline at the emphasized display weight (500), with a two-lane drawing of Teodor over the sectional. Settling it morphs the box to the 12px settled radius on spatial-default, drops it to a quiet surface and slides Teodor's bar into the Studio 4 lane; it is a data-item="teodor" instance, so the card, the map block, the summary and the badge settle with it. The day map leaves finished lessons off, draws 56px blocks with the start time, and the now line is inverse-surface, so it reads across the green block. From 1360px the detail pane is a fixed 440px and the list takes the rest.
Adaptive. Canonical M3 navigation across the window classes, one <nav> restyled. Compact: 80px bottom bar, extended FAB bottom right, week as a date strip. Medium (600+): 80px rail with the FAB at its head, 24px screen margins. From 960px: list-detail, with the chosen lesson open in a sticky pane and a default selection so the pane is never empty. Large (1200+): standing 280px drawer carrying the week and counts. Extra-large (1600+): the two panes get wider but stay constrained.
Deviation from M3. List-detail begins at 960px, not 840px. At 840 less the 80px rail the list would be 360px, narrower than the 440px these cards need to keep a sentence whole, so the sheet serves 600 to 959.
Components. Navigation bar, rail, drawer, extended FAB (collapses on scroll down), filter chips by room with counts and a real empty state (Saturday with Studio 4), modal bottom sheet that is a side sheet from 960px, radio list in the make-up picker, text field in the message sheet, wavy progress for the lesson in progress, badge on Open counting down, top app bar lifting on scroll.
Interactions. The three decisions settle everywhere at once: card, day map, Open view, detail, summary sentence, day dot, badge. Choosing Saturday for the make-up adds Kwame to Saturday's feed and map. Day, view and filter changes run as view transitions with the spatial spring; the reduced-motion path shortens the same durations. Every figure on the page (sentence summaries, counts, week total 13 h 45 min, Friday 4 h 15 min) is computed from the lesson cards' data attributes, so none can disagree with another.
Why this product suits this system
Shape is the system's most underused lever. It is also the one thing here that has to read at arm's length, in a corridor, without being read as words. M3 Expressive is the only system here that ships a spring scheme with real overshoot, beside a corner scale documented as a personality dial. State carried by radius is orthodox here, and would be a hack anywhere else.
The expressive scheme also moves the primary a third of the way round the wheel from the #4F5B92 seed. A slate-indigo seed became a green nothing else here owns.
Generators
md3_palette.py "#4F5B92" --scheme expressive # tokens.css, generated, never hand-edited
md3_palette.py "#4F5B92" --scheme expressive --contrast # 30 pairs, both themes, all pass
md3_spring_css.py --scheme expressive # the linear() easings and their durations
md3_spring_css.py --table # damping, stiffness, duration, overshoot
md3_dimensions.py --type --css # the 15-style type scale
md3_dimensions.py --shape --elevation # the corner and elevation ladders
md3_dimensions.py --components # component heights, icon sizes, radii
md3_dimensions.py --untokenized # the eight values that are not tokens
The hard states
The open decision. Three cards on Friday need one: a third time change, a room clash with the string sectional, and a make-up with nowhere to go. Each states the facts a teacher needs to settle it. Each resolves in one control, morphs to the settled radius, and offers Undo with focus moved onto it.
The empty day. Sunday, reached from the day strip or drawer; and a filtered day with no match, such as Saturday in Studio 4. Whitethorn shuts, so the panel names what is still outstanding rather than saying nothing, and offers the one action that clears it.
Both resolve on whichever day the reader is standing on: the same decision is rendered on more than one day, and the settle takes the instance that is on screen rather than the first in the document, so focus never lands in a hidden panel. The outcome sentence is also announced through a role="status" region, because moving focus to Undo says a button appeared and never says what happened.
The long-name case runs through the live day rather than a staged row. Marguerite Villanueva-Oyelaran appears in a lead sentence, in an evidence list, and in another day's feed.
Measured
on-surfaceonsurface-container, the lead sentence: 14.71:1 light, 12.59:1 darkon-surface-variantonsurface-container, the evidence labels: 8.06:1 light, 9.60:1 darkon-primaryonprimary, the filled button and the day mark: 6.46:1 light, 7.68:1 darkprimaryonsurface-container, the text button: 5.56:1 light, 9.56:1 darkon-error-containeronerror-container, the decision chip: 7.24:1 in both themes
Deviations from the contract
None. Every colour is a role from tokens.css. Every font size is a published type-scale token, every radius a corner token, every easing an md3_spring_css.py output. The elevation shadows draw on --md-sys-color-shadow through color-mix(). In dark they drop to none, where surface tone carries the lift, as the spec asks.
audit_page.py keeps two INFO findings, apple-touch-icon-missing and manifest-missing. Both need a second file beside the page, and the contract asks for one self-contained document.
Round four
- The side pane no longer clips its decision. At 960 wide and up the pane is tighter (12px rhythm, shorter history rows) and its action row is pinned to the foot of the pane with a hairline above it, so a short window scrolls the evidence beneath the buttons instead of cutting "Offer another time" off. At 1440 by 900 the whole pane now ends above the fold.
- Timeline chips never truncate a name. A first name longer than seven characters ("Marguerite") falls back to its initial plus the start time whenever the block is under 88px; the full name is the block's title and its accessible name. Short names (Teodor, Bea, Nadia) are unchanged.
- The phone action is an icon, always. The extended Make-up button sat over the first screen's last sentence at 390; it now rests as the icon (named for assistive tech), the sentence leaves it room, and the page reserves space at its end so the notes are never underneath it. The rail and wide layouts still show the label.
Round eight (2026-10-29)
- Action button over card text (390). Real. A fixed 56px button floated over the feed and a collapsed icon still hid words ("three-quarter"). On a phone it is now docked at the trailing end of the bottom bar (the destinations make room with
padding-inline-endon.nav), so nothing in the feed ever runs beneath it, and the page's bottom padding no longer reserves space for a floating button. From 600px the rail takes it, as before; its shadow is only drawn in the drawer. - "Moved from" sample empty (1440 dark). Real. The sample was one small label in a 112px box. It now shows the label with the value it labels, the same two lines the lesson's detail carries ("15:15 on 28 August, then 16:45 on 4 September"). The measured pair is unchanged: the 8.06:1 and 9.60:1 are the label's, and the value sits in
on-surface. - Circle clipped by the clash card (1440 light). Intended, so left. It is the hero's decorative corner shape, set 64px outside the card and clipped by
overflow: hiddenon purpose; when the clash is settled it rotates into a small rounded square, which is the page's one shape change.
Round nine (2026-11-09)
Done as the teacher on an emulated phone (touch, 3x, 360 and 390), then 1440, 1920 and dark. Heuristics 29 of 40 before, 34 after.
- Placing the make-up did nothing visible. Real, and it was the one that mattered. The choice settled behind the scrim and the sheet stayed on the two radio options. The sheet now becomes "Make-up placed" with the outcome sentence, Undo and Done, focus on its heading; Undo from inside the sheet brings the two options back.
- Sending a message left no trace. The sheet closed and only the status line, read by assistive tech, said anything. A snackbar now says "Message sent to Kofi Boateng." for four seconds above the bar (beside the rail from 600px).
- "Offer another time" sent a message that kept the time. The text to Kofi said "I can keep 16:15". It now offers another time and asks which afternoon next week suits. Each message puts the signature on its own line.
- Clipped words on a narrow phone. "Sectional" lost its first letters in the hero drawing at 360, and "15:15" ran out of its circle on the map. Block labels are now measured against the block as drawn: name and time, the name, the initial with the time, or the initial. A booking half covered by a lesson keeps its label to the part still showing. This replaces round four's seven-letter rule. The native
titleon map blocks is gone; the accessible name stays. - The bar's subtitle wrapped to two lines. It is now sentence case, one line from 320px up.
- Settling the hero left a grey diamond clipped by the card. The corner circle now comes in and becomes a small rounded square carrying a tick, the page's one shape change.
- Orphans. Lead sentences wrap with
text-wrap: pretty; "Studio 4", "grade 2" and "28 August" are held together with a no-break space. - Design notes. The bold decision now shows its four shapes (taught, settled, running, waiting) in the tokens the cards use, and sits as tall as the two lines beside it, so the laptop layout has no empty cell. The colour line moved to sit with the other two "what is" lines in three columns.
- Left, severity 1. The map's 24px blocks on a phone are below 48px wide; each lesson also has a 48px control on its card. The bar and rail come before the feed in tab order, as in the platform.
Round nine, phone map
- The bug. On a phone the map drew time across, so a 30 minute lesson was 24 to 37px wide and carried an initial ("M", "A", "T"); the teacher read the cards to learn who was where, and the blocks were under 48dp beside 48dp card controls. The tray's make-up button was 40px.
- The form now. Material's compact guidance is a list or a vertical axis, so below 550px of map the time runs down and the rooms stand across as columns, at 1.75px to the minute. A lesson is one column wide, at least 50px tall, and says its name and its time at label-medium (12px; 11px label-small under 270px of map, the 320 to 340 phones). 360: blocks 74.7 by 50.5 at the smallest, 76.8 for a 45 minute lesson; 390: 84.7 wide. The tray button is 48px.
- The clash. The sectional is drawn behind Teodor at full length with its label in the part still showing, and a lesson that clashes carries a 2px error ring in this form, so red on lavender with an outline reads at a glance. The "Clash" note below is unchanged.
- Now. The "Now 15:40" line runs across the columns behind the blocks, and its pill sits in the time gutter, wrapped to two lines, level with the line.
- Where it applies. The switch is on the map's own width (a container query), not the viewport, so it also takes the 600 to 740 medium widths and the 1000 to 1350 list-detail widths, which had the same slivers (initials, 30 to 45px blocks). The 750 to 959 and 1400-plus maps are unchanged.
- Left, severity 1. The small map inside a lesson sheet (
map--mini, one room, not interactive) still draws initials; the sheet's heading and its Before and Overlaps lines name the neighbours. - Measured. No horizontal overflow from 320 to 1920 in 10px steps; no name clipped from 350 up, and none from 320 with the label-small step.
Round ten (2026-11-09)
A second, harsher read as the teacher: phone at 360 and 390 (touch, 3x), then 820, 1440, 1920, both schemes, every state driven after the last edit. Heuristics 34 of 40 before (round nine's score), 32 on the cold read, 35 after. None is under 3. The ones held at 3: user control, error prevention and error recovery (Confirm 16:15 texts a parent; round ten later held the text behind Undo), flexibility (no way to message two parents at once), help (a first-time reader is not told what Open counts).
- The room map at medium widths (severity 2). Round nine's vertical map applied below 550px of map. From 720 to 959, and again from 1400 to 1650, the map is 552 to 640px and drew the old row of slivers: Marguerite and Amara were an "M" and an "A" in 47 to 75px blocks. The switch is now 620px of map, so the whole 600 to 959 band and the 960 to 1650 list-detail band take the named columns; horizontal returns at 1660 and above, where every name fits. Measured at 600, 680, 720, 760, 860, 959, 960, 1100, 1360, 1400, 1500, 1600, 1640, 1660, 1680, 1700, 1920: no initial, no clipped name, no horizontal overflow.
- The pane's small map (severity 2). In the list-detail pane the sectional read "S" and Amara "A". The one-room map now takes label-small, and the fit test measures the font it is actually drawn in; both now read in full. Marguerite (64px) keeps initial and time; the pane's Before line names her. Left, severity 1.
- A fact stated two ways (severity 2). Amara's card said "Needs a time" while her map block said "needs a decision"; she has a time. The chip now says "Needs a decision". Kwame's, which really has no time, still says "Needs a time".
- A commit with a side effect nobody named (severity 2). "Confirm 16:15" texts Kofi. The card now carries an "If you confirm" row saying so, above the button.
- A sent message left no trace (severity 2). The ask button now reads "Messaged Dominik, 15:40" on the hero, the card, the Open list and the pane. It still opens the message, so a second note is one press away.
- The week said state by shape alone (severity 2). A key under the bars names the four shapes where they are read.
Inventions. (1) The sent-message label and its time: the page's own clock stands at 15:40, so it reads 15:40; no record of messages exists in the brief. (2) The "If you confirm" row: the text to Kofi is the brief's own ("Kofi gets a text"), but showing it before the press is new. (3) The delayed send, the rule for Confirm 16:15: the move takes effect at once; the text to Kofi is held while a snackbar with Undo is up ("Kofi gets a text when this closes") and goes when it closes. The snackbar lasts 10 seconds, Material's long duration, and stops counting while the pointer or focus is on it (WCAG 2.2.1); a plain notice stays 4 seconds and now pauses too. Undo, on the snackbar or the card, cancels the move and the text. After the text goes the card says "Texted Kofi, 15:40" and its Undo becomes "Reopen", which opens the decision again and does not claim to recall the text. A second Confirm after a Reopen holds and sends a new text. A different notice replacing the held one closes it, so the text goes then.
Left. Severity 1: the mini map's Marguerite. Severity 1: Reopen after the text has gone leaves "Texted Kofi" true but stale on that day's record until the decision is confirmed again.
Round thirteen (2026-11-10)
Reviewer C, round 11: 37 of 40, no severity 2 or 3, six small items. All six reproduced and fixed.
- A status that was a button (honesty of controls). "Messaged Dominik, 15:40" was a focusable text button, so a record of something that happened read as plain text and acted as a control. The record is now a plain
span.sent("Sent at 15:40", not focusable, hidden with the other open-state controls once the decision settles) and the button is a verb named for who it reaches ("Message Dominik again", "Message Kofi again", "Message the office again"). The visible label contains the accessible name. - Kwame's Open row carried the wrong date. A settled make-up read "Friday 11 September" over "Saturday 12:45" (or "Wednesday 16:30"). The row's date line now follows the choice: "Saturday 12 September" or "Wednesday 16 September", with Friday returning on Undo. The two dates come from the choice sentences the page already had.
- Sectional flush against Teodor at 360 (and the rooms chart at 1920). Hero bar: the label had 4.5px between it and Teodor's ring; below 300px of chart it now takes label-small (the scale's floor, as round nine did for the map), 11.5px at 360, and at 260px or less the bar's inset is 4px (5.5px at 320). Rooms chart: the label's 8px end inset was zeroed by a container query that matches inside every block (each block is its own container), so the text touched the block edge on the wide chart. The inset now sits on the block (
padding-inline-end: 8px) and the column form resets it to 0, where the label is centred. - "If you confirm" orphan and the hairline on descenders (1440 light). "16:15 stands" no longer breaks onto its own line (a no-break space, as round nine did for "Studio 4"). The pane still scrolls at 900px tall, which is by design (the decision is pinned), so the evidence that slides under the pinned row now fades into it over 16px of
surface-container-lowinstead of being cut by the hairline. At 1920 the pane fits and nothing scrolls. Left: at 1440 by 900 the last evidence line still sits under the fade at rest, readable but dimmed; the pane's content is taller than the window. - Sunday kept a bare settled card under "Sunday is clear". Once placed, the Sunday panel now opens with "Nothing is waiting on Sunday now." before the placement sentence, so the card reads as the outcome of the clear day and not as a lesson on Sunday. The Settled chip and Undo stay (every settled card keeps its way back).
- The Make-up action outlived its job. After "Make-up placed" the FAB (rail, drawer, and the phone's bar) stayed labelled and live beside "Every make-up has a time". It now leaves when the make-up is placed and returns on Undo; on the phone the bar hands its width back to the three destinations. It waits for the sheet to close, and if the FAB held focus, focus moves to the card's Undo.
Inventions. (1) The sentence "Nothing is waiting on Sunday now." (2) "Sent at 15:40" and "Message X again" as the two halves of the old label; 15:40 is still the page's own clock. (3) The rule that the Make-up action is hidden, not disabled, when nothing needs placing; it is a page decision, not in the brief. (4) Reaching "Make-up placed" is now only possible straight after placing, from the sheet already open; its Undo is also on every card.
Round fifteen (2026-11-10)
Reviewer r14, 36 of 40: one severity 2, one severity 1. Both reproduced before editing.
- What Confirm does sat under the pinned row (severity 2). At 1440 by 900 the pane scrolls (869 against 796) and "If you confirm, Kofi Boateng gets a text saying 16:15 stands" sat at y 712 to 752 under the pinned action row, which starts at 747: half faded. At 1280 by 720 it was below the fold altogether (pane 616 tall). Round thirteen had left this as "readable but dimmed". The sentence is no longer a line of evidence: it is the first thing inside the action row (
span.ifc, a small label and the sentence), so it travels with the buttons in the card, the pane and the phone sheet, and no fade can reach it. Measured after: line 712 to 752 inside the row (699 to 884) with Confirm at 760 to 808 at 1440; 532 to 572 over Confirm 580 to 628 at 1280 by 720; whole at 1920 light and dark; in the phone sheet it sits 8px above Confirm at 390 and 360. The pane still scrolls its evidence at 1280 and 1440 (the around list sits under the row); that is the pinned-decision design and nothing key is under it now. It is hidden with the other open-state controls once the decision settles (classo), and "Kofi's text" takes its place in the evidence. - A settled card under "Sunday is clear" (severity 1). Once Kwame was placed, Sunday (count 0) still carried a Settled chip and an Undo under its heading. The chip and Undo are now hidden on the Sunday panel and its pane copy (
.blank.is-settled,.dt--blank.is-settled); the sentence stays ("Nothing is waiting on Sunday now. Kwame takes Saturday 12 September at 12:45, in Studio 2."). Undo remains on Friday's card, on Saturday's card when placed there, in Open and in the make-up sheet. Settling from the Sunday button leaves no Undo on screen, so focus moves to the "Sunday is clear" heading; undoing from elsewhere brings the two buttons back.
Inventions. None of fact. The rule that a clear day carries no settled card or Undo of its own reverses round thirteen's "the Settled chip and Undo stay" for Sunday only; it is a page decision, not in the brief.
Round seventeen (2026-11-10)
Reviewer r16, 36 of 40: three severity 1 items. Two reproduced and fixed; one did not reproduce and was not edited.
- Uneven confirmation (reproduced). Resolving Teodor showed no snackbar and resolving Kwame left Amara's up, still naming Amara. Every resolve act now raises its own snackbar through the same
toast(), which replaces whatever is showing (one at a time, as Material has it). Texts: Teodor, "Teodor moves to Studio 4 at 17:00. Dominik keeps Studio 2."; Amara, unchanged, "Amara keeps 16:15. Kofi gets a text when this closes."; Kwame, the choice sentence ("Kwame takes Wednesday 16 September at 16:30, in Studio 4." or "Kwame takes Saturday 12 September at 12:45, in Studio 2."). Each carries Undo and lasts 10 seconds, the round ten rule for a notice with Undo. It holds for the hero, the card, the pane, the phone lesson sheet, the Sunday panel and the make-up sheet. Undo, from the snackbar or a card, replaces the notice with a plain one ("Teodor is open again.", "Amara is open again, and Kofi will not be texted." if the text was still held), because the notice that offered the Undo is no longer true. - A modal sheet hides the snackbar. The snackbar sits under a modal dialog, so a notice raised inside one was never seen (Amara's, from the phone lesson sheet, never showed). Resolving from a lesson's own sheet now closes that sheet, as a confirming dialog does, and the notice shows over the card, now settled. Placing a make-up keeps its sheet ("Make-up placed", Undo, Done) and the notice is held and shown when the sheet closes; Undo inside the sheet drops it.
- Phone filter chips (reproduced, 32px). The 48px hit area was a pseudo-element inside a row that clips overflow, so the measured and real target was 32 to 44px. The button itself is now 48px tall and transparent; the 32px chip (outline, fill, radius, state colours, focus ring) is drawn by
::after, 8px in from top and bottom. The row gives up its 4px and 12px padding, so the row is the same height; the drawn chips sit 4px lower than before. - Sunday sheet lists Kwame's settled card (not reproduced). After Saturday placement by the FAB, on 1440 light, 390 dark, 360 light and 1920 dark, and with Sunday chosen before or after, Sunday shows "Sunday is clear" and "Nothing is waiting on Sunday now. Kwame takes Saturday 12 September at 12:45, in Studio 2." with no Settled chip and no Undo (round fifteen removed them). Not edited. What remains is the placement sentence, kept deliberately in round thirteen so the clear day says where the make-up went.
Inventions. (1) The two "is open again" notices. (2) Closing a lesson's sheet on resolve. (3) The Teodor notice text, a shortening of the status line. (4) A new notice ends the one before it, so resolving a second ask inside Amara's ten seconds sends her held text then; the card then reads "Texted Kofi" with Reopen.