← Back to the screen

Design system portfolio

Design record: Cadence

The four direction lines behind this page, the generator command that produced its tokens, and the pairs it was measured against.

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

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

Round eight (2026-10-29)

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.

Round nine, phone map

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).

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.

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.

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.

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.