← Back to the screen

Design system portfolio

Design record: Ridgeline

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

One completed route: its elevation profile, its map and its eight splits, as one screen that changes shape. On a phone it is an iPhone screen: a large title that collapses into the bar on scroll, three views (Route, Splits, Log) behind a floating tab bar. From 1024 px it is the iPad and Mac split view: the splits as a sidebar, the route filling the pane beside it.

Direction

What changed in the uplift (2026-10-29)

  1. Composition. A one-column document became a large title, a distance figure with three supporting figures, a topographic map and the profile. The elevation profile is the lead and the splits table became a list.
  2. The scrub. The profile is a slider: pointer drag, arrow keys, Home, End and Page keys, aria-valuetext carrying kilometre, altitude, grade, clock time and split. A lens follows the finger. The readout, the map position and the highlighted split all follow the same value. A row click or a map click glides to that point; under reduced motion it jumps.
  3. The map. Drawn in SVG at the size it is shown, so strokes are never scaled. Contours come from marching squares over a terrain built as the upper envelope of cones around the route, so the contours agree with the profile. Gap in the signal: a dotted line, as on the profile.
  4. Liquid Glass, only where the HIG puts it. The bar once content passes under it, the tab bar, the text-size sheet and the lens under a finger. The cards, the map and the rows are plain surfaces. It is a browser blur, not Apple's material, and it falls back to an opaque surface without backdrop-filter, under prefers-reduced-transparency and under prefers-contrast: more.
  5. Large title. An IntersectionObserver collapses it into the bar; the bar title fades in.
  6. Data. Distance, ascent, moving time and clock time add up: 18.4 km, 1,240 m up, 3:38:30 moving of 5:15:00, with four stops that sum to the 1:36:30 between them. The old Iron Creek to Marsh Bench pace read 9:41 and was arithmetically 9:40.
  7. Entry motion (rise and route draw) only under prefers-reduced-motion: no-preference.

Generator

hig_type.py --responsive     # tokens.css

hig_type.py writes tokens.css. The page links it and never edits it.

The AX3, AX5, and xxxLarge overrides inside index.html come from the same script, one run per size, and the checks behind the layout come from three more:

hig_type.py --size xxxLarge   # and --size AX3, --size AX5
hig_type.py --all-sizes --format table
hig_type.py --targets
hig_type.py --concentric 16 8

Colour

hig_type.py emits no colour, and Apple publishes no colour token values. The HIG's first rule on colour is that the documented ones "may fluctuate from release to release", so nobody may transcribe them. The page's semantic set therefore comes from the web's own system colours, Canvas and CanvasText, with color-mix() for the three label levels and the separator, modelled on the HIG's label and grouped-background hierarchies. One custom accent carries both appearances through light-dark(), and it is the only literal pair. The appearance switch sets color-scheme, and that flips all of them together.

Measured on rendered pixels in this uplift (computed foreground against the painted background pixel, WCAG relative luminance):

Apple's own secondaryLabel and tertiaryLabel are lighter than 4.5:1 by design. The three levels here are set by measurement: the shallowest mixes that clear AA against the worst ground on the page. The selected split row is an opaque mix of the accent over the card, not a translucent wash, so a measurement of its text has one background to read.

The hatch over the gap is deliberately faint. It is a texture behind a fact the dotted line, the notice, the list row and the readout each state in full, and giving it enough weight to pass would put more ink on the absence of data than on the data.

Two overrides on the generated type

Both live in the page, never in tokens.css, and both leave size, family and weight with the token:

The second state

The 1.9 km where the watch held no fix. The profile draws a hatched band with a dotted line between the last and first known points, and the map dots the same stretch. The split row reads No data for ascent and a dash for pace, the scrub handle reads "No data" for altitude and grade there, and the day's total leaves the gap out and says so. Three marks that must not look alike sit on screen together: a measured 0, a No data, and the dash.

Dynamic Type

Built at Large, then measured at Large, xxxLarge, AX3 and AX5 across phone, tablet and desktop widths: no horizontal overflow at any pair. Layout changes at the accessibility sizes follow Apple's guidance rather than patching around it:

Deviations, stated

Round four

Round eight

Round nine (2026-11-09)

Looked below the fold, at 360 and 390, in dark, at 1920, with the sheet and a scrub driven. Found and fixed:

Round ten (2026-11-09)

A cold second read, scored 31/40 against round nine's 34 (see the report). Found and fixed:

Invention: the "Show km N on the route" action and its wording. It adds no data and no state beyond the existing marker. Left: the scrub line passes through "No signal" (taste, from round nine).

Round eleven (2026-11-10)

Scored 33/40 by an independent reviewer. One severity 2 defect, fixed:

The dim behind the phone sheet and the scroll shade read --scrim and --scroll-edge, which use light-dark(): a fixed CanvasText mix lightened the page in the dark scheme instead of dimming it. Measured: the backdrop is near-black at 60% in dark and black at 32% in light.

Round thirteen (2026-11-10)

Scored 35/40 by an independent reviewer ("Yes, ship"); one severity 1 nit.