Tokens

01

Colour

Black, dark grey, grey, white and the dieter orange, with what each one means and where it is not allowed.

  • black

    rgb(0 0 0)

    Primary text and the frame rules. The default ink.

  • dark-grey

    rgb(96 96 96)

    Supporting text: captions, dates, labels. Never critical information.

  • grey

    rgb(200 200 200)

    The page, and everything on it. The site is not white.

  • Aa

    white

    rgb(255 255 255)

    Text on black only. Never a background.

  • dieter

    rgb(252 127 60)

    The accent. Where the reader is meant to act, and nowhere else.

  • border

    rgb(0 0 0 / 15%)

    Hairlines that separate without asserting.

02

Type

Inter, and the scale from H1 to inline code, with the sizes that change at 767px.

  • Sans

    Text and headings

    Inter

  • Mono

    Code only

    Geist Mono

  • H1 · .t-h1

    1.875rem, 2.375rem from 767px

    500 · 120%

    Page or article title

  • H2 · .t-h2

    1.375rem, 1.75rem from 767px

    500 · 120%

    Section

  • H3 · .t-h3

    1.25rem

    500 · 120%

    Sub-section

  • H4 · .t-h4

    1.1rem

    500 · 120%

    Minor heading

  • P · .t-p

    0.95rem, 1rem from 767px

    400 · 125%

    Body text, for reading at length.

  • PSmall · .t-p-sm

    0.875rem

    400 · 125%

    Secondary text, for lists and tools.

  • PXSmall · .t-p-xs

    0.75rem

    400 · 125%

    Metadata: dates, labels, captions.

  • CodeText · .t-code

    0.8rem

    400 · 125%

    const accent = "dieter";

03

Spacing

The horizontal and vertical padding tokens, read as a scale of intent rather than of size.

  • vertical-padding-body

    The page edge

    16 · 40 · 40 · 52px at 0, 475, 767, 991

  • vertical-padding-inner

    Inside a section

    16 · 36 · 32 · 44px at 0, 475, 767, 991

  • vertical-padding-gutter

    Between grid columns

    12 · 16 · 24 · 40px at 0, 475, 767, 991

  • horizontal-padding-main

    Between major sections

    120 · 140 · 160 · 180px at 0, 475, 767, 991

  • horizontal-padding-medium

    Closing a page

    40 · 56 · 64 · 80px at 0, 475, 767, 991

  • horizontal-padding-heading

    Between blocks in a section

    40 · 40 · 40 · 40px at 0, 475, 767, 991

  • horizontal-padding-paragraph

    Between paragraphs and rows

    20 · 20 · 24 · 24px at 0, 475, 767, 991

  • horizontal-padding-label

    From a label to its copy

    8 · 8 · 12 · 12px at 0, 475, 767, 991

04

Grid

4, 6, 8 and 12 columns, and the two-column splits that are allowed at each width.

1
2
3
4

The columns at this width: 4, then 6 from 475px, 8 from 767px and 12 from 991px.

Label
Content

The house section: 2 and 6 at 767px, 5 and 7 at 991px, stacked below.

Two columns are allowed as 4/4, 2/6 or 3/5 from 767px, and 5/7, 6/6 or 4/8 from 991px. Below 767px the page is one column. Columns are gap-x-vertical-padding-gutter apart, and nothing is wider than 1360px.

05

Breakpoints

475, 767, 991 and 1280px, and why hand-written CSS uses the literal pixels.

NameFromWhat changes
base0px4 columns, one column of content. The side nav is a row.This width
sm475px6 columns. The page edge and section padding grow.
md767px8 columns, and two side by side. H1, H2 and P grow. The side nav becomes a column.
lg991px12 columns. Spacing reaches its widest.
xl1280pxNothing in the tokens yet; the frame stops at 1360px.

In hand-written CSS, write the pixels: var(--breakpoint-md) does not work inside @media.

06

Rules

The 1px black frame and the 15% hairline, and the only places each one is drawn.

  • Frame · 1px black

    Where one section ends and the next begins: around the main box, along the nav edge, above a footer, and once above and below a table.

  • Hairline · black at 15%

    Under an input, and under the editor's toolbar. It separates without asserting.

07

Motion

Opacity, colour and transform only, kept short, always honouring reduced motion.

What movesHowDuration
A button on hoverDark grey to black120ms ease
The dot after the main actionGrows to 1.6 times on hover120ms ease
A disabled controlFades to 35% opacityInstant
Under reduced motionEvery transition is off—

Only opacity, colour and transform move. Under prefers-reduced-motion, nothing does.