Building a flat white for pickup, on a phone, on the morning the shop has run out of the milk your saved drink is made with.
The fourth brand specimen, and the warm one. It is also the only page in this portfolio whose canvas is not white or near-black.
Where the style comes from
Transcribed from awesome-design-md/design-md/starbucks/DESIGN.md, read 2026-09-16, and emitted by:
python3 tools/brand_tokens.py starbucks-brand > systems/starbucks-brand/tokens.css
python3 tools/brand_tokens.py starbucks-brand --check
python3 tools/brand_tokens.py --self-test
| Decision | Transcribed |
|---|---|
| Canvas | #f2f0eb, a cream: white is what a card is made of |
| Greens | brand #006241, accent #00754a, house #1e3932, uplift #2b5148, light #d4e9e2 |
| Gold | #cba258, "never a general-purpose brand color", reserved for rewards |
| Semantics | error #c82014, warning #fbbc05 |
| Type | 80 · 58 · 45 · 24 · 19 · 16 · 14 · 13 px |
| Tracking | default negative, -0.01em, even at body size |
| Weights | 400 and 600 |
| Radii | 12px cards, 50px full pill on every button |
| Motion | published: 0.2s / 0.3s / 0.4s, ease-out, plus an overshoot curve |
| Press | scale(0.95): the signature micro-interaction |
| Depth | whispered; 0.14 and 0.24 alpha, one assertive floating button |
The finding that shaped the generator's ramp. Two of this brand's text values are published as ALPHA blacks: rgba(0,0,0,0.87) and rgba(0,0,0,0.58), and a translucent value cannot go in a ramp the solver walks, because it has no fixed contrast until you know what is behind it. Both are composited against this brand's own cream canvas and the solid result is what the ramp carries. The derivation is stated in the generator rather than the composited numbers being presented as published values.
Two measured pairs worth naming. White on the green action reads 5.76:1, so the reference's own filled CTA is legal as published. The same green as a WORD on the cream canvas reads 4.71:1 and on the recessed band 4.51:1, so accent-text is a shade deeper than the fill, the same split the other three brands here needed, arrived at independently each time.
The direction
- Archetype. Wizard.
- Data stance. Tile-first.
- Density. Comfortable, touch, every target at least 44px, pills at 48.
- The one bold decision. The shortage is stated where the choice is made, not at checkout. Most ordering apps let somebody build the whole drink and then refuse it at the till, which wastes the order and the walk. The unavailable option stays on the screen, disabled, saying why, removing it would leave somebody hunting for the thing they always choose, and the two ways out sit above the tiles: another milk, or another shop with the extra distance stated.
The second state
The out-of-stock ingredient, which is the state a mobile order actually breaks on and the one every demo of one leaves out. It is the hardest state a wizard has, because a wizard's whole promise is that the steps are answerable.
Deviations from CONTRACT.md
- §2, the typeface. SoDoSans is proprietary. Nunito Sans is substituted: the closest open-licensed humanist sans at 400 and 600 with the rounded terminals this language pairs with its pill geometry.
- §5, motion. No deviation, unusually: the reference publishes its durations and the 0.2s rung is already inside the 250ms exit cap, so nothing had to be chosen. The
scale(0.95)press is switched OFF rather than shortened underprefers-reduced-motion, which is the one place this portfolio's "shorten, never delete" rule does not apply: a transform is exactly what that setting is about, and there is notransitionendwaiting on it. - §1, one composited value family. The two alpha text values, as above.
Findings kept, with reasons
slop_scan·overshoot-easing: the reference's owncubic-bezier(0.32, 2.32, 0.61, 0.27). It is emitted because the generator carries a brand's published motion vocabulary whole, the way the other generators here carry a published ramp whole; the page itself does not use it, and leaving it out would have made this the one brand quietly edited for taste.slop_scan·default-ai-palette: a deep green and a cream. The rule allows it where the brief asked for it, and the brief is the brand.craft_lint·disabled-unstyled: the rule looks for utility-class variants; the disabled control is styled by.pill[disabled]and carriesaria-describedbynaming what would make it live.audit_page·apple-touch-icon-missing,manifest-missing: portfolio-wide.copy_lint·name-drift, seecopy-lint.ignore.
What the gates changed
craft_lint's no-primary-action caught the two recovery buttons drawn at the same weight. One of them finishes the order here and now; the other costs a nine-minute walk to a different shop. Drawing them identically made the reader decide twice, so the first is now the filled pill.
Uplift round (2026-10-29)
What changed, and why. The archetype (wizard), stance (tile-first) and the one bold decision (the shortage named at the step it breaks) are unchanged; the page now carries them harder.
- The drink is drawn, and it answers every choice. A paper cup with a window cut in the front, built from inline SVG. Size scales the cup; shots change the espresso layer (one, two, three); milk pours in and takes its own colour; vanilla sits under the espresso; cinnamon dusts the foam; steam rises only once the order is placed. Every layer is one
translateY, so each moves on the published 400ms ease-out and nothing animates a value. The coffee and milk colours arecolor-mix()of published values (warning-text brown, cream, ink, error, warning); no raw colour was added. - The shortage has a shape. With no milk the cup shows a dashed slot in the warning colour labelled "Milk goes here". Both recoveries are real: soya pours in, or Bridge Street re-enables oat, re-prices the ready time (08:04) and pours oat. "Back to Riverside" reverses it and re-raises the shortage.
- A real wizard. One step at a time with a spine (size, milk, shots, extras), a dock (Back / Continue, then "Place order" with the price) that is sticky on a phone, a review ledger on the last step, and an order-placed state. Without script every panel shows.
- The phone is the product. A sticky House Green stage holds the cup, the total and the summary while the sheet scrolls under it. Wide screens split 40/60 like the reference's hero, with the cup labelled at its layers (from 90rem).
- Reference components used: the cup-icon size row with a green ring, the numeric stepper, the option icon that ticks in on the published spring curve, the floating-label input's cousin (name on the cup), the feature band.
- Design notes recomposed in the system's own idiom: large green headline, numbered directions, the bold decision as a House Green band, visible swatches beside the two measured pairs (5.76 and 4.71).
- Dock instead of the floating order circle. The reference's round order button is replaced by a bottom bar on a phone, stated in the notes.
- Theme. The reference publishes light only, so light and dark render identically on purpose.
tools/review-shots.mjshas noSINGLE_APPEARANCEentry for this slug and reports it as pinned; the coordinator owns that file. - Fixed on the way:
::selectionread a token that does not exist.
Round four
- The cup's interior is a lifted glass (the plate's green mixed toward the pale ink) rather than the same dark green as the page behind it, and the missing milk layer carries a faint tint inside its dashed outline, so "milk goes here" reads as empty space in a cup instead of an outline on a dark ground. Once a milk is chosen the tint goes and the glass shows above the foam.
- Below the two-panel layout the cup takes the width (13rem, or 24% of the screen height if that is smaller) with the chip, price and ready time beside it, and the drink's name and its state run full width underneath, so "Medium, two shots, milk needed" is one line at 390.
Round eight (2026-10-29)
- Sticky Back/Continue bar covers "Switch to soya" (390). Real. The cup took
min(13rem, 24svh)of a phone's height, which pushed the notice's first action under the dock. The cup is nowmax(8rem, min(13rem, 18svh))below the two-panel layout: at 390 by 844 it is 152px instead of 202px, "Switch to soya" sits clear of the dock on the first screen, and "Switch to Bridge Street" begins above it. The dock stays sticky, since it is the one place the next move lives. - "Milk goes here" reads as a flat green box (1440). Real. The slot was a rectangle with an 8% tint over the cup's own green interior. It is now the shape the milk will have: a wavy top (the surface the liquid layers draw) down to the coffee, filled with whole milk's own cream at 55% so it reads as a pale ghost of milk, with the dashed warning-colour outline kept as the system's mark for what is missing. The path is rebuilt from the same height
drawCupalready computed; nothing new is tokenized (the cream is the whole-milk foam mix).
Round nine (2026-11-09)
Held against the Starbucks app's own order flow, on an emulated phone (360 and 390, 3x, coarse pointer) first, then 1440 and 1920. Heuristics, ten scored 0 to 4: 31 before, 35 after. Nothing below 3.
- Sideways scroll after any swap (phone, real). The notice that swaps in slides 24px from the right, and Chromium kept that overflow once the slide had finished: the layout viewport widened to 398px, the page zoomed out, and the dock slid 58px off the foot of the screen. The shell now clips on x. No width from 320 to 1920, in 10px steps, scrolls sideways in the shortage, extras or placed states.
- The order had no end. "Add to bag" led to "In your bag. Your flat white is on its way", which said both that nothing was paid for and that it was being made. The last step now places the order: "Place order" with the total, then "Order placed", the time, where to collect it (with the walk from Riverside to Bridge Street) and the ticket with every line and the name on the cup. The spine is locked once it is placed, the chip reads "Order placed", and "Order another drink" starts again from the shortage. The bag counter went with it.
- Continue moved between steps. On a short step (size) the dock floated mid-screen and on a long one it sat at the foot. The work column now takes the slack, so the dock rests at the foot of the screen on every step, at the thumb.
- A disabled Continue said nothing. It now reads "Choose a milk", stays focusable (aria-disabled, not disabled), and a tap or Enter moves focus to the two ways out of the shortage. The hint line above the dock is gone, so the dock no longer changes height when a milk is chosen.
- Back to Riverside threw away a milk. Choose soya, switch to Bridge Street, come back: soya is given back instead of the shortage re-raised.
- Laptop: Continue below the fold at 1440 by 900. The dock is sticky at wide widths too, and the milks are rows of disc and words from 64rem, so all five and the dock fit one laptop screen. A new step starts at the top of the page.
- Safe areas.
viewport-fit=coverwith left, right, top and bottom insets on the stage, the sheet, the dock and the notes, so the dock clears a home indicator and nothing sits under a notch in landscape. - Craft. Balanced headings and
text-wrap: pretty(the notes' lead no longer ends on "build."), no 300ms tap delay, no grey tap flash, the name field offers the given name and closes on Enter, "70 degrees" is "70 °C", the ledger's "16 oz" carries a thin space.
Left as it is: on a 640px-tall phone the sticky stage and dock leave about 275px for the choices (severity 1). The stage is the product's point, the cup answering each choice; shrinking it further would lose the cup. Light and dark render identically on purpose, since the brand publishes one appearance.
Round ten (2026-11-09)
A cold second read, held against the Starbucks app's order flow, driven at 360, 390, 1440 and 1920 (phone runs on an emulated 3x touch device, timers on a fake clock). Heuristics, ten scored 0 to 4: 27 before, 32 after. Nothing below 3.
- The commit had no way back (severity 3). Placing an order was one press and final. A placed order now carries a window to change or cancel it. Change reopens it at the last step with a "Changing your order" bar and "Keep as placed" (puts the order back exactly); the dock reads "Update order" with the difference ("pay £0.50 more", "£0.50 back") and the ledger shows "Already paid" and "To pay now" or "Back to you". Cancel opens a confirm that names the drink, the store and the refund, then a "Nothing to collect" state with "Rebuild this drink". When the window ends the card reads "This order is final" and "Order another drink" appears.
- The result landed under the sticky stage (severity 3). The new panel's top was 300px up under the cup on a phone. The scroll anchor is now the panel where the spine is hidden, so the heading and both buttons sit in view at 360 by 640 and 390 by 844. Focus goes to the heading.
- Where, when and how much came after the button (severity 2). The review ledger now opens with "Collect at Riverside, ready about 08:00" (Bridge Street adds the walk), then the lines, then "Total to pay" (the receipt says "Paid"). The stage's price note follows the act: "so far", "paid", "was £3.60", "refunded".
- The price consequence sat under the buttons (severity 2). "Soya costs the same" and the Bridge Street time now come before "Switch to soya"; the body sentence is cut so the soya button still clears the dock at 390 by 844.
- The spine is hidden once an order is placed or cancelled (it was a row of dead controls).
- Flexibility: "Order my usual". At the start, above the spine, one card shows the saved drink (medium flat white, oat milk, two shots, £3.60, from the page's own "Morning usual") and goes straight to the review step. Oat is still out, so the review opens with the shortage and the same two ways out, "Place order" reads "Choose a milk" until one is picked, and a tap on it moves focus to the first way out. The milk step is not marked done, since no milk was chosen. The card goes once anything is changed from the usual.
- Controls under the dock (severity 2). The page's scroll padding was the dock's height; it is now the dock's height plus 12px (the dock's own padding already holds the safe-area inset), so a focused control scrolls clear. Measured by Tab and by forcing focus, the shortage buttons sit at least 73px above the dock at 360 by 640, 161px at 390 by 844 and 283px at 1440.
Inventions, named: the window is two minutes with one note at one minute ("Under a minute left"); two timers, no polling. A change keeps the original deadline and the order reverts if the window ends mid-change. Payment is taken at placing, and a cancel refunds the full amount. After the window the fallback is "ask at the counter". "Order another drink" is hidden while the order can still be changed, so a pending order is never forgotten by the page.
No new product fact: the usual is the drink the page already carries. Left: light and dark are identical on purpose (the brand publishes one appearance).
Round eleven (2026-11-10)
- "Order my usual" dropped the reader mid-wizard (severity 2). Reproduced at 1440 and 390: the tap landed on "Step 4 of 4, Anything on top?" with the Milk segment neither done nor current, the oat shortage under an Extras heading and a grey "Choose a milk" button on a step that is not the milk. It now stays on the Milk step ("Step 2 of 4, Which milk?"), the card leaves, focus goes to "Switch to soya", the Milk segment is current, Shots and Extras read "not yet", the price reads "so far" and the button reads "Choose a milk" (the step it names). Once a milk is chosen, Continue reads "Continue to review" and goes to the last step, past Shots, which the usual already answers (two shots, medium, Riverside kept as the usual had them); Back from there goes to Shots. Soya and Bridge Street both carry on this way. The carry-on is a flag set by the card and cleared by arriving on any other step, so going Back to Size and forward again is the ordinary flow.
- No-shortage usual. Not reachable: the usual is only offered at Riverside with no milk chosen, and oat is out there. The handler still sends a usual with a milk in hand straight to the review.
- Dock over "Your order" at 1440 (severity 1). Not edited. The dock is sticky at the foot of the screen on purpose (round nine) and the review card simply starts under it until the reader scrolls; the usual no longer lands on that step, so the first view of it is by Continue.
Invention, named: the label "Continue to review" on the Milk step while the usual is carrying on. No product fact added.
Round thirteen (2026-11-10)
- The usual was labelled a one-tap order it cannot be (severity 1, reviewer round 12). Reproduced at 1440, 390, 360 and 1920: the card read "Order my usual" with the oat drink at £3.60, and the tap landed on the Milk step with "Choose a milk" in the dock. Chosen from the brief: the flow cannot place in one step. The card is only offered at Riverside, where oat is out, so a one-step order would place a drink the shop cannot make, and the brief puts the confirmation, the ready time and the two-minute change window at the review step, after the shortage. So the label now says what happens: "Start from my usual", with "Medium flat white, oat milk, two shots. Riverside is out of oat, so you choose another milk, then review." The price stays £3.60, the usual's own, and the page already states that soya costs the same and Bridge Street is the same price.
- Usual available. Not reachable: the card is hidden at Bridge Street (where oat is in stock) and once anything is changed. Driven instead: switch to Bridge Street from the card, Continue to review, Place order, with its price, ready time and Change or cancel. The old branch that sends a usual with a milk in hand straight to the review is untouched.
Invention, named: the card sentence is the only new copy; it restates the page's own shortage, no new price, store or policy fact.