← Back to the screen

Design system portfolio

Design record: Nightshift

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

The overnight charge plan for a last-mile delivery depot: fourteen vans, three bays, one contracted ceiling, read at 17:42 by the supervisor who is about to go home.

tesla-brand is the first of the portfolio's BRAND specimens, a published brand design language rather than a vendor's interface system. The reference is a car maker's own website, which is a showroom; this page is what that language looks like when it has to run a depot.

Where the style comes from

The reference publishes nine colours, four type sizes, two weights, one radius for controls and one duration. Everything below was transcribed from awesome-design-md/design-md/tesla/DESIGN.md, read 2026-09-16, and emitted by:

python3 tools/brand_tokens.py tesla-brand > systems/tesla-brand/tokens.css
python3 tools/brand_tokens.py tesla-brand --check
python3 tools/brand_tokens.py --self-test
DecisionTranscribed
Ramp#ffffff #f4f4f4 #eeeeee #d0d1d2 #8e8e8e #5c5e62 #393c41 #171a20
Chromaticone, Electric Blue #3e6ae1
Type ramp40 · 22 · 17 · 14 px, and that is all of it
Weights400 and 500. No bold, no light
Radius0 default, 4px controls, 12px large surfaces, 50% dots
Durationone, 0.33s, cubic-bezier(.5, 0, 0, .75)
Spacing8px base
Hold~1383px
Depthnone, no shadow on any element, no border on any card
Themeslight published; the night scheme is assembled from the same values (uplift, 2026-10-29)

What the generator SOLVES is the role assignment, and three findings came out of doing it that way. Each is asserted by --check rather than described.

  1. The palette has no legal control boundary that is not already a text colour. Silver Fog #8e8e8e, the value the reference uses for placeholder and disabled text, measures 2.98:1 against Light Ash, 0.02 under the 3:1 SC 1.4.11 asks of anything identifying a control. The next value down is Pewter, so stroke and ink-3 are the same colour here. That is a property of a nine-value palette rather than a mistake, and a tenth value invented to tidy it would be this portfolio writing the design system rather than transcribing it.
  1. The brand blue is legal on the canvas and illegal in the band beside it. #3e6ae1 reads 4.82:1 on white and 4.39:1 on Light Ash. Solving every role against the WORST ground rather than against the page is exactly what catches this; accent-text is #3c67de, a fraction darker, at 5.02:1 on the worst ground. The button keeps the published blue, because a fill owes 3:1 and clears it.
  1. White on the blue is 4.82:1, so the reference's own primary button is legal as published, unlike claude-brand's clay at 4.05:1. Nothing had to move.

The direction

The second state

The three short vans. It is the state the archetype makes hardest: a gantt draws what WILL happen, and the interesting row is the one where what will happen is not enough. Showing it required the whole colour argument above.

Deviations from CONTRACT.md

Findings kept, with reasons

The uplift (2026-10-29)

tokens.css was not touched and no generator flag changed. What the page does now:

Round two: the first screen (2026-10-29)

Critic scored the first fold 7: headline floating over a dead gap, a chart grey on grey.

Round three: Tesla's own canvas (2026-10-29)

A second critic scored the page 6: "A generic dark dashboard with no Tesla in it." Its fixes: one subject in enormous quiet, the "120" alone in a light wide grotesque, drop the eyebrow and the chart labels that repeat the chart, the blue bar the only accent, and flip the whole canvas to white with Carbon text so the theme toggle means something. Confirmed by screenshot: only the dock changed between schemes.

Round four

Round nine: the world-class pass (2026-11-09)

Scored against the reference's own energy and charging pages. Heuristics 29/40 before, 35/40 after. The moment still under 3: the plan list is long on a phone.

Round ten: the harsh second read (2026-11-09)

A cold read scored the page 27/40 against round nine's 35, and 32/40 after this round. The defect behind the gap: Send to drivers committed a plan to twelve people with one press, and any change afterwards silently cleared the "sent" state while the drivers still held the old plan. tokens.css was not touched.

Round thirteen (2026-11-10)

The independent round-eleven score (37/40, would ship) sent back one thing: the phone's sticky bar height.

Round fifteen (2026-11-10)

The independent round-fourteen score (37/40, ship with a note) named two reservations: the chart's "held back" figure and the undelivered kWh disagree, and the phone controls are 28px tall. Both reproduced before any edit.

Round seventeen (2026-11-10)

The independent round-sixteen score (36/40, ship with a note) rated one severity 2: on the first fold at 1440 and 1920 the chart read "21 kWh held back, charged later" beside "Delivered, 23 short of 666 kWh", and a reader concluded "charged later" was false for the three short vans. Reproduced before any edit at 1440 light and 1920 dark with no interaction.

Round nineteen (2026-11-10)

The round-eighteen score (33/40, ship with a note) rated one severity 2 and two severity 1s on this page.