No. 001 · Design system
Typewheel style guide
Every design token, shown in use: the colour rows, both type ramps, spacing, corners, controls, elevation, motion and stacking.
Colour
Each name is a job, not a value. The same names resolve in the dark and contrast rows; nothing inside a section changes when the row does.
Grounds
- --color-surface-body Paper. The page ground and the reading surface.
- --color-surface-subtle Desk. One step off the page, for a separated section band.
- --color-surface-raised Sheet. A lifted card or panel, with border and shadow.
Marks
- --color-ink Every mark on the surface: text, icons, rules, strokes.
- --color-ink-muted Meta, captions and secondary marks. Never body copy.
- --color-border Decorative hairlines. Width is --border-width.
Interactive
- --color-action Ribbon red. Links, primary buttons, active states.
- --color-action-hover The action colour under the pointer.
- --color-action-subtle Quiet fill for secondary buttons and chips. Text uses ink.
- --color-focus Keyboard focus ring, on any surface.
- --color-on-action Anything sitting on a filled action surface.
Status
- --color-danger Error text and marks.
- --color-danger-bg Banner and badge fill, read with danger.
- --color-success Confirmation text and marks.
- --color-success-bg Banner and badge fill, read with success.
- --color-warning Caution text and marks.
- --color-warning-bg Banner and badge fill, read with warning.
Pairs in use
Ink on paper. The default reading pair, 15.03:1.
On-action on action. Button labels, 5.94:1.
Ink on action-subtle. Secondary buttons, 13.43:1.
Danger on danger-bg. 5.66:1.
Success on success-bg. 5.36:1.
Warning on warning-bg. 5.08:1.
Contrast row
The same token names, flipped for a dark band. A section takes the class; nothing inside it changes.
Ink on the night ground. Courier Prime at --title-sm, muted ink beneath.
Type
Four slots by job. Sizes and leadings come from the two ramps; nothing is set by hand.
Families
Courier Prime sets headings, section titles and navigation.
IBM Plex Mono sets running copy, meta and form text, 17 to 18px at 1.6 leading.
Instrument Serif italic carries one accent word: tomorrow.
const ribbon = "one accent, used once";
Title ramp
Here for today.
All in for tomorrow.
Digital services, development and hosting
For the information age
Built to last
A quieter first step
Text ramp
An introduction sets the scene before the detail starts.
A lead paragraph carries the opening argument at one step above body.
Body copy is the default for anything unstated. It scales with the viewport, so it needs no media query, and it holds the 65ch measure.
Small text carries captions, form labels and compact interface copy.
Fine print, footnotes and the smallest supporting detail.
Typewheel · 11.17.2026 · No. 004
npm run build sets in the mono face, sized in em.
Weights
Regular 400. Running copy and the base of every mark.
Medium 500. Subheads and controls that need a little more presence.
Semibold 700. Headings. The real bold face, not a synthesised 600.
Bold 700. Emphasis inside running copy.
Tracking
Tight tracking
No tracking
Wide tracking
Wider tracking
Spacing
Ten steps. The small end is fixed for hairline gaps; the large end is fluid, so bands and clusters scale with the screen.
Corners
Five house steps. Pick one per element; do not interpolate between them.
Buttons and controls
One definition, four variants. Both heights come from the control tokens, so a button and a field on one row agree.
States
Variants
Elevation
A raised surface is a sheet with a border and a shadow. Shadows stay neutral; there is no coloured glow.
Layout
Two containers and a text measure. Section padding goes on the band, never inside the capped box.
This box pads with --layout-section-block and --layout-section-inline. Section bands use the same pair.
Motion
Durations by job, never by number. Both curves decelerate; entrance is only for something arriving. Hover a track to see its step. Reduced motion keeps the colour change and drops the movement.
Stacking
- --z-base
- The document flow.
- --z-raised
- A hovered card or a badge over an image.
- --z-sticky
- A sticky header or bar.
- --z-overlay
- Menus, dropdowns and popovers.
- --z-modal
- Dialogs and off-canvas panels.
- --z-toast
- Notices above everything.
Breakpoints
- --breakpoint-sm
- Mobile-first, written inside the query as a name.
- --breakpoint-md
- The layout changes shape, not just its type.
- --breakpoint-lg
- Wide screens only.