Skip to content

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.

Paper, ink and one ribbon. Courier Prime sets the headings, IBM Plex Mono sets the body, Instrument Serif is saved for a single accent word.

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.

Secondary line in --color-ink-muted.

Type

Four slots by job. Sizes and leadings come from the two ramps; nothing is set by hand.

Families

--font-title

Courier Prime sets headings, section titles and navigation.

--font-text

IBM Plex Mono sets running copy, meta and form text, 17 to 18px at 1.6 leading.

--font-display

Instrument Serif italic carries one accent word: tomorrow.

--font-mono

const ribbon = "one accent, used once";

Title ramp

--title-display

Here for today.

--title-xl

All in for tomorrow.

--title-lg

Digital services, development and hosting

--title-md

For the information age

--title-sm

Built to last

--title-xs

A quieter first step

Text ramp

--text-xl

An introduction sets the scene before the detail starts.

--text-lg

A lead paragraph carries the opening argument at one step above body.

--text-md

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.

--text-sm

Small text carries captions, form labels and compact interface copy.

--text-xs

Fine print, footnotes and the smallest supporting detail.

--text-label

Typewheel · 11.17.2026 · No. 004

--text-code

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.

--space-3xs
--space-2xs
--space-xs
--space-sm
--space-md
--space-lg
--space-xl
--space-2xl
--space-3xl
--space-4xl

Corners

Five house steps. Pick one per element; do not interpolate between them.

--radius-none
--radius-sm
--radius-md
--radius-lg
--radius-full

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

Default Primary action
Disabled

Variants

Default uses --control-height; small uses --control-height-sm. The focus ring is ink at double --border-width, offset two hairlines.

Elevation

A raised surface is a sheet with a border and a shadow. Shadows stay neutral; there is no coloured glow.

--shadow-sm
--shadow-md
--shadow-lg

The hairline is --border-width. Every border on the site uses it.

Layout

Two containers and a text measure. Section padding goes on the band, never inside the capped box.

--layout-max
--layout-wide
--layout-content

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.

--duration-fast · --curve-standard
--duration-base · --curve-standard
--duration-slow · --curve-entrance

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.