← Back to the screen

Design system portfolio

Design record: Grid North

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

Distribution substation load operations. Thirty-two feeders on three transformer banks at Northgate 138/12.47 kV, live, with a replay of the 03:41 RTU outage.

Direction

What each surface answers

Every column that carries a comparable value sorts, in both feeds; the caret is drawn only for the column that is actually sorted, and a third click on one returns the table to feeder order. The Polled column is the last second each RTU answered on, which is why it is the only column with a figure in it during the outage: the eleven feeders on T3 read 03:41, and the twenty-one that answer read 03:51. The notification that names those eleven carries the control that shows them.

Interactions added in the uplift

Figures that must agree

Ratings are an assumption of the specimen: 50 MW per bank, 150 MW for the station. Live feed: station 123.4 MW; T1 43.5, T2 41.4, T3 38.5 (sum 123.42). Replay (RTU outage): 21 feeders answer, 46.9 MW, so the station chart there has no rating line and an automatic domain. Two feeders are over rating in the live feed (NG-1103 at 104.3 %, NG-1208 at 101.3 %), which is also the alarm count. The series colour on the charts is a purple token, chosen so that "over rating" red is never also the colour of an ordinary line.

Generator

The token file was produced by, verbatim:

carbon_tokens.py --all-themes

--all-themes emits colour only. The type sets, the 8px spacing scale and the motion tokens in the page's own <style> were taken verbatim from the same generator:

carbon_tokens.py --type
carbon_tokens.py --layout
carbon_tokens.py --motion

The theme audit quoted in the report is:

carbon_tokens.py --contrast --theme g100

Shipped theme: g100. The header control offers g10, and a reader whose system asks for light and who has not chosen gets g10; with no script at all the page renders the generated :root theme, which is Carbon white.

Measured contrast

Measured with contrast.py.

PairRoleRatioNeeds
#f4f4f4 on #262626text-primary on layer-01, g100, every figure in the table13.76:14.5:1
#c6c6c6 on #262626text-secondary on layer-01, g100, the load bar8.86:13:1 (SC 1.4.11)
#fa4d56 on #262626support-error on layer-01, a bar over 100 % of rating6.38:13:1
#161616 on #fffffftext-primary on layer-01, g1018.10:14.5:1
#ffffff on #0f62fetext-on-color on button-primary, both themes5.00:14.5:1

APCA reads the first pair at Lc −97.6 and still asks for 16px at weight 400. Carbon sets dense UI text at 14px ($body-compact-01); the system wins, and the disagreement is recorded on the page.

Deviations from CONTRACT.md

  1. §1, tokens the generator did not emit. --all-themes carries colour alone, so the spacing, size, motion and type-set values are held in the page's own :root. They are the verbatim output of --layout, --motion and --type of the same generator, not hand-typed, and tokens.css is untouched.
  2. §5, the theme attribute. The generated file switches on data-carbon-theme and its dark media query is guarded as :root:not([data-carbon-theme]), not data-theme. The page uses Carbon's own attribute so the generated file stays authoritative; the in-page control wins in both directions and the OS preference is honoured on first paint by a blocking <head> script.
  3. §4, no raw colour anywhere, including the favicon. The favicon is an inline data: SVG drawn in currentColor under color-scheme: light dark, so it carries no hex. No apple-touch-icon and no manifest ship, because both need a second file and §2 asks for one.

Kept findings

Round two (2026-10-29)

A cold review scored the first screen 6/10: dense, correct, nothing set large. The board now sits on the 16-column grid with 1px gutters (station 1-10, banks 11-16), and its one expressive figure is the station load, 123.4 MW in Plex Sans Light sized in cqi from its tile, over the three banks drawn end to end against the 150 MW rating (43.5 + 41.4 + 38.5, 26.6 free). The 24-hour line is 3px with a dashed threshold band at the rating; the two feeders over rating are error-striped tiles. Table headers are heading-compact-01 at 14px.

The bank series are one hue, the purple support token, stepped toward --cds-text-primary (100%, 78%, 58%), not toward the layer: stepped toward the layer the lightest step measured 2.78:1 on g10 and 2.35:1 on g90, under SC 1.4.11's 3:1; stepped toward the text every step is 3.45:1 or more on every theme's layer. tokens.css carries no Carbon data-viz palette, so the steps are a deviation from Carbon's categorical palette, and every segment is directly labelled.

Round four (2026-10-29)

Three defects from a cold critic. The lone "Apply" button beside the Live and 03:41 replay switch is gone: the two radios already apply on change, so the button had nothing to submit. The station chart's y-axis now ticks up to 160, so the dashed 150 MW rating line and its band sit inside the drawn axis instead of above its last label (the 03:41 replay keeps its own range and draws no rating).

Table rows, their controls and any :target carry a scroll-margin-block-start of the shell header plus the table header plus a spacing step, so a row or anchor scrolled to lands clear of both fixed bars. It sits on those elements, not as scroll-padding on html, because root padding also moves every scrollIntoView and flipped the bank select's panel upward with room below (the picker probe caught it). A row passing under the sticky table header mid-scroll is what a sticky header does and is left as it is.

Round eight

Round nine (2026-11-09)

Scored against the ten heuristics before and after: 31 to 34 of 40.

Deviations, in addition to those above:

  1. field-02 on layer-01, and the placeholder at text-secondary, as measured above.
  2. The 0 to 120 % table bar scale with a 100 % tick.
  3. The row's overflow menu is hidden under 42rem; the side sheet carries the same actions, so a phone has one way to each, not two.
  4. The 48px step under a coarse pointer rather than at a width, because a laptop with a touch screen and a phone both need it and a narrow desktop window does not.

Checked: station, bank and alert counts, the sums and the over-rating list all derive from one feed and agree live and held (03:41). Tested widths: 320, 360, 390, 720, 1440, 1920.

Round ten (2026-11-09)

A second, harsher read. Scores before and after: 31 to 35 of 40 (visibility 2 to 3, user control 2 to 4, error prevention 2 to 3, help 2 to 3). Still below 3: none.

Inventions, since the brief gives no rule: a bank that stops answering is an alarm of its own (so the bell reads 1 in the 03:41 view and 2 live); the toast timing; selection pruned by the filter; one draft number, SO-2041, that is never issued (the page still only drafts).

Left: the 03:41 view is a replay and still lets the operator draft an order from it (severity 1: the brief does not say whether a replay is read-only). No acknowledge action on alarms (severity 1: needs a rule the brief does not give). No explanation of the 0 to 120 % bar scale beside the table header; the key at the foot holds it (severity 1).

Driven after the last edit at 1440, 1920, 390 and 360 (touch, 3x), both schemes: batch add, Show the draft, Clear and Undo, per-line remove and Undo, panel add and remove, the alarm menu with a dark bank, live to replay with a draft held. No horizontal overflow, no console error.

Round eleven (2026-11-10)

Two severity 2 defects from the independent score, both reproduced before editing.

Invention, since the brief gives no rule: the outage was on a Tuesday. It is the minimum that separates the recording from the live Thursday; no date is given, and none is shown.

Left: the same T3 sentence appears in the notification and in the over-rating box in the replay (severity 1); the row menu ignores Arrow keys (severity 1); the Polled column is dropped on phones, so the eleven T3 rows show dashes with no poll time there (severity 1).

Driven after the last edit at 1440 light, 1920 dark, 676 light, 390 dark and 360 light (touch, 3x): replay on, its toggle, note and readout; live; a lower row ticked and the bar position; Add to switching order from the bar. No horizontal overflow, no page error.

Round thirteen (2026-11-10)

Round fifteen (2026-11-10)

Round twenty-three (2026-11-10)

Round twenty-five (2026-11-10)