Brand

Three rules, and each one follows from how the files are made rather than from taste:

• Do not redraw them. packages/assets/ holds the vendor originals and scripts/_brand-assets.mjs derives everything above from them. A new logo from the brand is a re-run of that script, not an edit to an SVG in src/.
• Do not recolor the monochrome ink. It is currentColor, deliberately: the mark inherits the color of the text around it, so it turns with the color scheme without a second file and without asking the operating system what the reader prefers. Setting a fill breaks that. The brand gradient is a gradient and stays as drawn.
• Use the SVG unless a platform demands otherwise. The rasters exist because a browser asks for them by name - the tab icon, the touch icon, the manifest icons, the social card - and each one is generated at the size that slot wants.

Everything this site publishes now follows it: the component READMEs it renders, this page's neighbors, and the repository's own README. What still writes root is the record - the architecture decision records, the handoffs, the plan - and the comments in the source, and both are left alone on purpose. A decision record edited after the fact is not a record, and a comment is written for whoever opens the file rather than for a reader.

The two ramps above are what carries the brand: default is the accent - links, focus, the selected state - and alternate is the second voice beside it. Both mirror across light and dark on their own through light-dark(), which is why there is one token per step and not two.

• Aa Bb Cc 0123--root-t--font-familyInter, sans-serif
• Aa Bb Cc 0123--root-t--font-family--monoui-monospace, SF Mono, Cascadia Code, Fira Code, monospace

• Design system--root-t--font-weight--regular400
• Design system--root-t--font-weight--medium500
• Design system--root-t--font-weight--semibold600
• Design system--root-t--font-weight--bold700

The face is Inter, self-hosted: one variable file for the roman and one for the italic, each carrying the whole 100-900 weight axis (packages/css/foundations/lib/typography/fonts/inter/). Self-hosted rather than fetched from a font CDN - a file on somebody else's origin is a request this site cannot make any promise about - and variable rather than four static cuts of the same face.

Two things are worth knowing before copying the setup, and both are costs:

• Both files are subset to Latin. Upstream they are 344 kB and 380 kB covering every script Inter supports; what ships is the range a Western European page sets, which is where the sizes in the table above come from. The full files are in the repository (packages/assets/fonts/inter/) for whoever needs to widen that - a page setting Greek, Cyrillic or Vietnamese falls back to the reader's system font for those characters, and nothing warns it.
• font-display: block holds the text invisible until the file arrives. That is the right call for a face whose metrics differ from the fallback - it trades a flash of the wrong face for a pause - and the wrong one on a slow connection. It has not been revisited since it was written.

The monospace stack is the platform's own: ui-monospace first, then the named faces a system is likely to have. Code sets in something the reader already has and costs nothing to load.

Download tokens.json - generated by this build, from the same declarations the components consume. A light-dark() pair is one token in it and not two, because that is what it is in the CSS.