Read this first
- These values are the system. Everything below is a token that exists in
css/hud-core.css. Use them; do not invent parallel ones. - Never add colour. The moment a hue appears, the whole encoding collapses - because form is carrying the meaning that colour usually carries, a single red breaks every other signal on the screen.
- Reach for a filled block before anything else. Emphasis, selection and active state are all one move: invert the surface.
- Both grounds, always. Blueprint and CRT are hand-authored, and nothing warns you if you only checked one. Hit Invert.
- Names are roles.
--inkis the foreground, not the colour black - on the CRT ground it is near-white. - No ad-hoc values. No raw hex, no one-off sizes, no new easing. If a token does not cover your case, that is a conversation about the system.
Colour
No chromaTen role tokens and no accent. Each swatch below shows blueprint on the left, CRT on the right, so both grounds are visible without switching - though the Invert button is there and everything on this page responds to it.
Derived - never declared twice
| Token | Derivation | Role |
|---|---|---|
| --line | ink at 15% | The hairline. Every border that is not load-bearing. |
| --line-strong | ink at 32% | Panel edges and section rules. |
| --grid | ink at 6% | The graph-paper ground, tiled behind everything. |
| --on | ink | The filled surface of an active control. |
| --on-ink | panel-2 / ground | Text sitting on that filled surface. |
ink rather than declared as their
own hex, inverting the ramp inverts every border with it. Hardcode one
hairline and it will be the single mark that stays dark on the CRT ground.
Typography
Four voicesThree stacks doing four jobs, all from system fonts - nothing to download. Mono is the default, not the exception: the body font appears only inside running prose.
| display | 2.6rem / 900 | Heroes and numerals. Tracking .02em, scaled 1.05 wide. |
| heading | 1.2rem / 700 | Mono, uppercase, tracking .2em. |
| body | 1rem / 400 | Leading 1.7, capped at 60ch. |
| caption | .72rem | Mono, uppercase, tracking .16em. |
| eyebrow | .66rem | Tracking .28em. The widest thing in the system. |
| label | .62rem | Tracking .2em. Panel and specimen labels. |
Space and layout
One columnOne measure, one gutter, four breakpoints. The grid behind the page is decoration, not a layout grid - do not snap to it.
| 4 | 4px | |
| 8 | 8px | |
| 14 | 14px | |
| 22 | 22px | |
| 26 | 26px | |
| 34 | 34px | |
| 58 | 58px |
| measure | 1120px | Max content width, centred, 22px gutter. |
| prose | 64ch | Running text never runs wider. |
| bar | 44px | Status bar height at every width. |
| break-lg | 820px | Column grids collapse to one. |
| break-md | 720px | Secondary bar segments drop. |
| break-sm | 640px | Six-up motif grid becomes three-up; tickmarks go. |
| break-xs | 520px | Bar keeps only the index and the controls. |
Form
HairlineCorners stay nearly square. The silhouette comes from line weight and from bracket furniture, not from radius.
| 1 | 1px | |
| 2 | 2px | |
| 3 | 3px | |
| 4 | 4px | |
| pill | 100px |
| hairline | 1px | Dividers, inactive edges, the grid. |
| edge | 1.5px | Panel and control borders. The default. |
| heavy | 2px | Brackets, focus, the outlined display face. |
| dashed | 1px dashed | Disabled, unsaved, in-flux. A state, not a style. |
Motion
One loopAlmost nothing moves, and what does moves instantly. There is no easing curve in this system - transitions are linear and short enough that a curve would not be visible anyway.
| Token | Value | Where |
|---|---|---|
| tint | 120ms | Background and colour on buttons and icon buttons. |
| track | 150ms | The toggle knob travelling, and its track filling. |
| press | 50ms | The 1px downward nudge on a pressed button. |
| blink | 1.4s steps(1) | The live indicator. Stepped, never faded - a CRT dot is on or off. |
steps(1) is the whole motion philosophy in one value. A
smooth fade would read as a modern web animation and break the register
instantly. Everything that changes here snaps, because the hardware this
system imitates could not interpolate.
prefers-reduced-motion kills the blink and every transition outright - there is nothing in the system whose meaning depends on movement.
Screen
Enhancement onlyOne optional surface treatment: a phosphor sweep. A beam rotates and decays across the screen, scanlines cut it, grain sits on top, and range rings lock to the pointer. The pointer is the target - move it across the right-hand panel and the reticle follows on a spring.
| Uniform | Value | What it does |
|---|---|---|
| uSweep | 0.55 rad/s | Beam rate. One revolution takes about eleven seconds, slow enough to read as instrumentation rather than as a spinner. |
| uPersist | 2.3 | Trail decay. Higher is a shorter tail - this is the phosphor, and it is the only thing that makes the sweep read as a sweep. |
| uScan | 0.14 | Scanline depth, at one cycle every two device pixels. |
| uGrain | 0.05 | Phosphor grain. Enough to kill banding, not enough to read as noise. |
| uRings / uRingGap | 3 / 0.075 | Range rings around the target, breathing on a 1.6s pulse. |
| uGround / uInk | tokens | Read from the live values, so the treatment inverts with the ground like everything else. |
| spring | k 52 / d 9 | The reticle is followed on a spring, so it has mass and settles instead of snapping. |
mix(uGround, uInk, ink) - so the only colours it is capable of
emitting are the two ground tokens and the greys between them. There is no
way to leak a hue into this panel without rewriting that line, which is a
far better guarantee than remembering not to.
Where it belongs: behind a hero, or filling an empty state or a panel that has nothing in it yet. Not behind a working surface - it is the decorative register, and it lives under the same quarantine as the gauges and the D-pad. Under prefers-reduced-motion it renders one settled frame and never starts the loop; with no WebGL2 the static panel on the left is the whole design.
Components
Live - hover themEvery state below is real. Hover the buttons, drag the slider, click the toggles. Specimen labels are deliberately generic - see STANDARD.md R1.
Motifs
Recognisable at a glanceThe marks that make the system identifiable. Icons are a single 1.7px stroke on a 24px box, with one deliberate exception - the pixel heart, which is drawn on a 9×7 grid and rendered with crispEdges.
The character

The one figurative mark in an otherwise geometric system, and the only place a drawn image is allowed. It is desaturated to the ramp like everything else - the system has no chroma, and the character does not get an exemption.
| placement | poster stage only | Bottom-anchored, centred, standing in the stage. It belongs to the hero. |
| height | min(90%, 780px) | 86% below 640px, so it keeps its feet on the band. |
| depth | z-index 2 | Above the poster ground and below the wordmark - the type crosses in front of it. |
| filter | grayscale(1) | Forced, not assumed. A colour source file must still land on the ramp. |
| pointer | none | It never intercepts a click; the stage behind it stays reachable. |
Furniture
Beyond the icons and the character, four pieces of furniture carry the register: the corner bracket on panels, the registration cross, the scanline wash, and the viewport frame pinned to the four corners of the window. Below, the decorative register at full strength - reserved for heroes, empty states and section furniture, never for working surfaces.
Composition
SpecimenThe parts assembled into one arrangement: a framed module holding a list of units, each with a label, a value and its controls, one of them held in the inverted state. Deliberately abstract - what matters is the rhythm, not what the rows contain.
01: alpha, bravo, charlie, delta 02: echo, foxtrot, golf 03: hotel, india, juliett 04: kilo, lima, mike
alpha, bravo, charlie, delta, echo, foxtrot, golf, hotel, india, juliett, kilo, lima, mike
Anatomy
| Part | As built | Why it is that |
|---|---|---|
| Frame | panel + brk | Corner brackets on two opposing corners only. Four would close the box and lose the instrument reading. |
| Module head | caption / caption | Identity left, reference right, both in the caption voice. The head never competes with the rows. |
| Unit row | 118px / 1fr / auto | Fixed label column so the values align down the list without a table. |
| Held row | inverted | The whole surface fills. This is the only "selected" treatment the system has, and it is the same move as a solid button. |
| Controls | icon buttons | Per-row, right-aligned, outline at rest. The active one fills - matching the row's own encoding. |
| Output | two panes | Same content at two grains. Mono makes the comparison legible without labels on every line. |
| Footer action | solid button | One solid per module. A second would leave the reader with no primary. |
Rules
The refusals matter most- Encode state in form: filled is active, outline is idle, dashed is disabled or in flux.
- Reach for the inverted block for emphasis and selection. It is the whole vocabulary.
- Author and check both grounds. Blueprint and CRT are hand-written, not derived.
- Keep mono as the default and let the body face appear only in running prose.
- Let the dashed edge mean something. It is a state, and spending it as decoration costs you a signal.
- Add any hue. Not for errors, not for success, not "just this once" - form is already carrying that load.
- Add a shadow. There is no elevation model; on the CRT ground a shadow is a grey smear.
- Let the decorative register - gauges, D-pad, scanlines - onto a working surface.
- Nest panels. Two hairlines a few pixels apart read as a rendering fault.
- Give anything a radius above 4px, pills excepted. Round corners drain the instrument out of it.
- Interpolate. The live dot steps; it never fades.
- Run the phosphor sweep behind a working surface. It is decorative register, under the same quarantine as the gauges.