Design system

The grid provides structure, not content

Use three layout tools: a page shell with named tracks, a 12-column grid and three named splits for recurring two-column layouts.

All values come from layout.* in the token source. Widths, gaps and column counts are never set as one-off values.

Page shell: one grid, five named lines

A centred container holds one width. The named-line grid holds every system width at once, and each child selects the track it needs without another wrapper.

The default track is content, so ordinary children need no additional width class.

content · 80rem · standard
wide · 96rem · extends 8rem on each side
full · edge to edge

.id-prose holds a 68-character reading measure in the same shell. Four widths, one grid, zero wrappers.

ClassTokenWidthUse
.id-proselayout.container.prose45.29emA single reading column. The em measure follows the type size.
.id-layout-narrowlayout.container.narrow40remForms, dialog copy and login cards that need one narrow column.
.id-layout-articlelayout.container.article64remA document with figures in it: the rules page, a spec, a long decision.
(standard)layout.container.content80remDefault page content. The named token replaces a one-off width.
.id-wide, .id-layout-widelayout.container.wide96remSurfaces organised as grids of objects: the component gallery, category pages and dashboards.
.id-fullNot applicable100%Edge to edge for inverse bands, full-width images and coloured sections.

Grid: twelve columns

Twelve supports halves, thirds, quarters and sixths without a second grid. layout.gutter sets a fluid 16 to 24px gap between columns.

Set spans with Tailwind's col-span-* utilities.

1
2
3
4
5
6
7
8
9
10
11
12
col-span-6
col-span-3
col-span-3
col-span-4
col-span-4
col-span-4

Three named splits

Three recurring two-column layouts use named recipes instead of one-off definitions such as grid-cols-[1.15fr,1fr] and grid-cols-[1fr,360px]. All three collapse to one column below 1024px.

.id-split-media · 7 / 5 · the image is the argument
media
text
.id-split-side · 8 / 4 · content and rail
content
shine
.id-split-even · 6 / 6 · two things being compared
A
B

Reverse either asymmetric split with .is-reversed. Use .id-split-even for two items that need direct comparison.

Four breakpoints

The breakpoints are now the system's own and replace Tailwind's set, so 2xl: no longer exists. Four are enough: one where two columns become possible, one where a rail still costs too much width, one where a real two-pane view works, and one where the content reaches its container and stops.

A media query cannot look up a custom property, so these four appear as real numbers in the Tailwind configuration. They are still written in one place: in the token source.

PrefixFromWhat is changing
sm:640pxLarge phone. Two columns can begin.
md:768pxPortrait tablet. A rail still costs too much width.
lg:1024pxLandscape tablet and small laptop. The named splits expand.
xl:1280pxDesktop. Content reaches its maximum container width.

Subgrid when the row needs to align

Cards with different heading lengths place body copy on different rows. .id-cols-sub uses the parent grid lines so headings, copy and footers align across the row.

Use it only when every item shares the same internal structure.

Choose a layout

Start with the closest use case.

SituationUse
Standard page<main class="id-layout">
Full-width child.id-full on the child
Wider child.id-wide on the child
Long-form copy on the same page.id-prose on the child
Rules, specifications or long documents.id-layout .id-layout-article
Form or dialog.id-layout .id-layout-narrow
Gallery, category page or dashboard.id-layout .id-layout-wide
Structure inside the content.id-cols + col-span-*
Image and text.id-split-media
Content and rail.id-split-side
Two comparable items.id-split-even
Cards that align internally.id-cols-sub
No recipe fitsCreate a named component recipe. A one-off page grid becomes the next grid-cols-[1.15fr,1fr].