Brand
Everything is considered.
Every word, line, colour, and interaction should have a reason to exist. The living reference is the style page — components, tokens, and copyable values. This page records the reasoning behind it; where the two disagree, the style page is right.
Principles
Begin with the claim
Lead with the thing that is true or useful. Context follows. Do not hide a precise idea behind scene-setting or slogans.
Go down the stack
Show the reasoning beneath the result. The visual system should suggest depth, construction, revision, and relationships between layers — all the way down to the silicon.
Remove what cannot answer for itself
Decoration needs a purpose. If a word, rule, image, or interaction does not improve meaning or orientation, remove it.
Prefer evidence to assertion
Specifics are more persuasive than superlatives. Use examples, constraints, measurements, and trade-offs wherever possible.
The metaphor
The language is silicon. The page is a substrate; sections are dies placed on it; hairlines are the traces between them. Diagrams are drawn the way an engineer draws — one pen, exact widths, mono captions — because the product's argument is engineering.
Colour
Colour lives in three layers, and the order matters. The literals — the ramps you can copy from the style page — are written in one place only. Above them sit functional families for universal meanings. Above both sit the roles (--color-substrate, --color-text, --color-panel, …), which are what components actually reference and what themes rebind. A component never names a literal.
The families
Taupe is the ground: warm, papery, unhurried — the substrate everything sits on. Kiln is ember and gold, the expressive accent. Grove is the deep green of considered growth. Aegean is a working blue. Plum takes the occasional editorial moment. Two neutral runs — light and dark — carry text, panels, and rules.
Themes
Two ship: Taupe, the default, and Dark. A theme is one construct — data-theme on the root themes the page; on a section it themes that section. A reader's choice is stored and respected.
Gradients
Two-stop pairs declared with their angle — Terrace, Ember, Tide, Shallows — one bound per theme. On the homepage, colour gradients are rationed deliberately: the hero's beam carries one, and everything else speaks in ink.
The drawn line
Diagrams and technical surfaces share one pen: the page's ink at 30%, one device pixel wide. Coincident lines are drawn once. Solid ink is reserved for data — bits, values, marks — so that what the system computes always reads darker than what merely frames it.
Typography
Instrument Sans carries titles: geometric structure with open letterforms, presence without heaviness. Barlow carries body, navigation, and interface: a slightly narrow, low-contrast grotesk balancing warmth and clarity. JetBrains Mono carries code and captions: tall x-height, consistent widths, precise alignment. Large type may be quiet; small type must be exact. Avoid unnecessary weights, ornamental italics, and artificial hierarchy.
Voice
Write plainly, specifically, and with intellectual confidence. Ask a question only when the product or the next sentence can help answer it. Avoid grand claims, vague philosophy, inflated metaphors, and language that sounds profound without saying anything.
Motion
Motion reveals structure or state; it never exists to demonstrate cleverness. Scroll-driven scenes are scrubbed, damped, and reversible — the reader owns the clock, and scrolling back plays the scene backwards. Entrances share one gesture: rise a little, sharpen from blur, settle. Ambient life runs on the wall clock, quietly, so a page at rest is never dead.