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.
- Token
- --color-white
- Role
- color.ink.inverse
- base
- #ffffff
- sm
- #ffffff
- md
- #ffffff
- lg
- #ffffff
- Description
- Text on black only. Never a background.
- Never
- A background: no white cards, panels, inputs, code blocks or buttons.
- Token
- --color-black
- Role
- color.ink
- base
- #000000
- sm
- #000000
- md
- #000000
- lg
- #000000
- Description
- Primary text and the frame rules. The default ink.
- Never
- Token
- --color-dieter
- Role
- color.accent
- base
- #fc7f3c
- sm
- #fc7f3c
- md
- #fc7f3c
- lg
- #fc7f3c
- Description
- The accent. Where the reader is meant to act, and nowhere else.
- Never
- Decoration, or a filled button. More than one place per view leaves no accent.
- Token
- --color-dark-grey
- Role
- color.ink.muted
- base
- #606060
- sm
- #606060
- md
- #606060
- lg
- #606060
- Description
- Supporting text: captions, dates, labels. Never critical information.
- Never
- Critical information: its contrast on grey is too low to carry it.
- Token
- --color-grey
- Role
- color.surface
- base
- #c8c8c8
- sm
- #c8c8c8
- md
- #c8c8c8
- lg
- #c8c8c8
- Description
- The page, and everything on it. The site is not white.
- Never
- A second surface colour on top of it: cards, panels and inputs sit on the same grey.
- Token
- --color-create
- Role
- color.signal.create
- base
- #6ec480
- sm
- #6ec480
- md
- #6ec480
- lg
- #6ec480
- Description
- A Toast's icon when something was created or saved.
- Never
- Anything but a Toast's icon: not text, a fill, a border or a status label (DESIGN.md §2).
- Token
- --color-info
- Role
- color.signal.info
- base
- #78a4e8
- sm
- #78a4e8
- md
- #78a4e8
- lg
- #78a4e8
- Description
- A Toast's icon when it only informs.
- Never
- Anything but a Toast's icon: not text, a fill, a border or a status label (DESIGN.md §2).
- Token
- --color-delete
- Role
- color.signal.delete
- base
- #e86860
- sm
- #e86860
- md
- #e86860
- lg
- #e86860
- Description
- A Toast's icon when something was deleted.
- Never
- Anything but a Toast's icon: not text, a fill, a border or a status label (DESIGN.md §2).
- Token
- --color-warning
- Role
- color.signal.warning
- base
- #ecc050
- sm
- #ecc050
- md
- #ecc050
- lg
- #ecc050
- Description
- A Toast's icon when something needs attention.
- Never
- Anything but a Toast's icon: not text, a fill, a border or a status label (DESIGN.md §2).
- Token
- --color-chart-land
- Role
- color.chart.land
- base
- #f0e6b4
- sm
- #f0e6b4
- md
- #f0e6b4
- lg
- #f0e6b4
- Description
- Land on the /lancieux map, as on a nautical chart.
- Never
- Anything but the /lancieux map: not text, a fill, a border or a surface elsewhere (DESIGN.md §2).
- Token
- --color-chart-dries
- Role
- color.chart.dries
- base
- #c8dcbe
- sm
- #c8dcbe
- md
- #c8dcbe
- lg
- #c8dcbe
- Description
- Sand and rock the tide has left, on the /lancieux map.
- Never
- Anything but the /lancieux map: not text, a fill, a border or a surface elsewhere (DESIGN.md §2).
- Token
- --color-chart-shallow
- Role
- color.chart.shallow
- base
- #b4d2eb
- sm
- #b4d2eb
- md
- #b4d2eb
- lg
- #b4d2eb
- Description
- Shallow water on the /lancieux map.
- Never
- Anything but the /lancieux map: not text, a fill, a border or a surface elsewhere (DESIGN.md §2).
- Token
- --color-chart-deep
- Role
- color.chart.deep
- base
- #5a8cbe
- sm
- #5a8cbe
- md
- #5a8cbe
- lg
- #5a8cbe
- Description
- The deepest water on the /lancieux map; shallower water blends toward chart-shallow.
- Never
- Anything but the /lancieux map: not text, a fill, a border or a surface elsewhere (DESIGN.md §2).
- Token
- --color-chart-foam
- Role
- color.chart.foam
- base
- #f5f8fa
- sm
- #f5f8fa
- md
- #f5f8fa
- lg
- #f5f8fa
- Description
- Breaking waves on the /lancieux map.
- Never
- Anything but the /lancieux map: not text, a fill, a border or a surface elsewhere (DESIGN.md §2).
- Token
- --color-zone-1
- Role
- color.zone.1
- base
- #d654a0
- sm
- #d654a0
- md
- #d654a0
- lg
- #d654a0
- Description
- A saved wave type's colour on the /lancieux map (magenta): the water where that wave occurs, and its swatch in the panel.
- Never
- Anything but the /lancieux map and its wave-type swatches (DESIGN.md §2).
- Token
- --color-zone-2
- Role
- color.zone.2
- base
- #eec83c
- sm
- #eec83c
- md
- #eec83c
- lg
- #eec83c
- Description
- A saved wave type's colour on the /lancieux map (yellow): the water where that wave occurs, and its swatch in the panel.
- Never
- Anything but the /lancieux map and its wave-type swatches (DESIGN.md §2).
- Token
- --color-zone-3
- Role
- color.zone.3
- base
- #5cbe70
- sm
- #5cbe70
- md
- #5cbe70
- lg
- #5cbe70
- Description
- A saved wave type's colour on the /lancieux map (green): the water where that wave occurs, and its swatch in the panel.
- Never
- Anything but the /lancieux map and its wave-type swatches (DESIGN.md §2).
- Token
- --color-zone-4
- Role
- color.zone.4
- base
- #e2584e
- sm
- #e2584e
- md
- #e2584e
- lg
- #e2584e
- Description
- A saved wave type's colour on the /lancieux map (red): the water where that wave occurs, and its swatch in the panel.
- Never
- Anything but the /lancieux map and its wave-type swatches (DESIGN.md §2).
- Token
- --color-zone-5
- Role
- color.zone.5
- base
- #9270de
- sm
- #9270de
- md
- #9270de
- lg
- #9270de
- Description
- A saved wave type's colour on the /lancieux map (violet): the water where that wave occurs, and its swatch in the panel.
- Never
- Anything but the /lancieux map and its wave-type swatches (DESIGN.md §2).
- Token
- --color-border-rgb
- Role
- color.hairline
- base
- #000000 at 15%
- sm
- #000000 at 15%
- md
- #000000 at 15%
- lg
- #000000 at 15%
- Description
- Hairlines that separate without asserting.
- Never
- A box around a card, list item, input or button. Rules mark sections, not elements.
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";
- Token
- --font-sans
- Role
- font.text
- base
- var(--font-inter), system-ui, sans-serif
- sm
- var(--font-inter), system-ui, sans-serif
- md
- var(--font-inter), system-ui, sans-serif
- lg
- var(--font-inter), system-ui, sans-serif
- Description
- Text and headings
- Never
- Switching it to Geist: the brand type is Inter.
- Token
- --font-serif
- Role
- font.unused
- base
- Merriweather, serif
- sm
- Merriweather, serif
- md
- Merriweather, serif
- lg
- Merriweather, serif
- Description
- Declared and never loaded, and no component uses it.
- Never
Not in agent.md yet
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
- Token
- --vertical-padding-body
- Role
- space.page-edge
- base
- 16px
- sm
- 40px
- md
- 40px
- lg
- 52px
- Description
- The page edge
- Never
- Token
- --vertical-padding-inner
- Role
- space.inset
- base
- 16px
- sm
- 36px
- md
- 32px
- lg
- 44px
- Description
- Inside a section
- Never
- Token
- --vertical-padding-gutter
- Role
- space.gutter
- base
- 12px
- sm
- 16px
- md
- 24px
- lg
- 40px
- Description
- Between grid columns
- Never
- Token
- --horizontal-padding-main
- Role
- space.section
- base
- 120px
- sm
- 140px
- md
- 160px
- lg
- 180px
- Description
- Between major sections
- Never
- As bottom padding: the space above a section belongs to that section.
- Token
- --horizontal-padding-medium
- Role
- space.page-end
- base
- 40px
- sm
- 56px
- md
- 64px
- lg
- 80px
- Description
- Closing a page
- Never
- On a section: the only bottom padding is the one that closes the page.
- Token
- --horizontal-padding-heading
- Role
- space.block
- base
- 40px
- sm
- 40px
- md
- 40px
- lg
- 40px
- Description
- Between blocks in a section
- Never
- Token
- --horizontal-padding-paragraph
- Role
- space.stack
- base
- 20px
- sm
- 20px
- md
- 24px
- lg
- 24px
- Description
- Between paragraphs and rows
- Never
- A rule between the rows instead of this space.
- Token
- --horizontal-padding-label
- Role
- space.label
- base
- 8px
- sm
- 8px
- md
- 12px
- lg
- 12px
- Description
- From a label to its copy
- Never
04
Grid
4, 6, 8 and 12 columns, and the two-column splits that are allowed at each width.
The columns at this width: 4, then 6 from 475px, 8 from 767px and 12 from 991px.
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.
Not in agent.md yet
05
Breakpoints
475, 767, 991 and 1280px, and why hand-written CSS uses the literal pixels.
| Name | From | What changes | |
|---|---|---|---|
base | 0px | 4 columns, one column of content. The side nav is a row. | This width |
sm | 475px | 6 columns. The page edge and section padding grow. | |
md | 767px | 8 columns, and two side by side. H1, H2 and P grow. The side nav becomes a column. | |
lg | 991px | 12 columns. Spacing reaches its widest. | |
xl | 1280px | Nothing in the tokens yet; the frame stops at 1360px. |
In hand-written CSS, write the pixels: var(--breakpoint-md) does not work inside @media.
- Token
- --breakpoint-sm
- Role
- breakpoint.sm
- base
- 475px
- sm
- 475px
- md
- 475px
- lg
- 475px
- Description
- 6 columns. The page edge and section padding grow.
- Never
- var(--breakpoint-sm) inside @media: write 475px.
- Token
- --breakpoint-md
- Role
- breakpoint.md
- base
- 767px
- sm
- 767px
- md
- 767px
- lg
- 767px
- Description
- 8 columns, and two side by side. H1, H2 and P grow. The side nav becomes a column.
- Never
- var(--breakpoint-md) inside @media: write 767px. Two columns side by side below it.
- Token
- --breakpoint-lg
- Role
- breakpoint.lg
- base
- 991px
- sm
- 991px
- md
- 991px
- lg
- 991px
- Description
- 12 columns. Spacing reaches its widest.
- Never
- var(--breakpoint-lg) inside @media: write 991px.
- Token
- --breakpoint-xl
- Role
- breakpoint.xl
- base
- 1280px
- sm
- 1280px
- md
- 1280px
- lg
- 1280px
- Description
- Nothing in the tokens yet; the frame stops at 1360px.
- Never
- var(--breakpoint-xl) inside @media: write 1280px. Anything wider than max-w-[1360px].
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.
Not in agent.md yet
07
Motion
Opacity, colour and transform only, kept short, always honouring reduced motion.
| What moves | How | Duration |
|---|---|---|
| A button on hover | Dark grey to black | 120ms ease |
| The dot after the main action | Grows to 1.6 times on hover | 120ms ease |
| A disabled control | Fades to 35% opacity | Instant |
| Under reduced motion | Every transition is off | — |
Only opacity, colour and transform move. Under prefers-reduced-motion, nothing does.
Not in agent.md yet