Foundations
The component catalog documents what each piece does. Foundations documents why: the token architecture underneath every color and space, the accessibility substrate every interactive component is built on, the naming grammar that keeps props predictable, the deviations we chose to keep against Untitled UI's shipped source, the platform rules a web-only reference can't express, and the branding contract that keeps every component neutral until told otherwise.
The six pillars
Each page is a short, calm read — start wherever your question came from, or work through them in order.
Tokens
How primitive color and spacing ramps become the bg*/text*/fg*/border* aliases every component consumes, and when to reach for fg* instead of text*.
Accessibility
The headless behavior hooks — toggle state, single- and multi-select state, roving focus — that every interactive component is built on, before any visual styling.
Prop grammar
The twelve rules that keep state, configuration, selection, and slot props spelled the same way across every component.
Deviations
The places this library departs from Untitled UI on purpose, and the reasoning that would otherwise only live in source comments.
Platform
The adaptivity rules a web-only reference cannot express: touch-first defaults, sheet-vs-popover, no hover-dependent affordances.
Branding
Why the library stays neutral until a brand ramp says otherwise, and how the token editor proves it live.