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.
.id-prose holds a 68-character reading measure in the same shell. Four widths, one grid, zero wrappers.
| Class | Token | Width | Use |
|---|---|---|---|
| .id-prose | layout.container.prose | 45.29em | A single reading column. The em measure follows the type size. |
| .id-layout-narrow | layout.container.narrow | 40rem | Forms, dialog copy and login cards that need one narrow column. |
| .id-layout-article | layout.container.article | 64rem | A document with figures in it: the rules page, a spec, a long decision. |
| (standard) | layout.container.content | 80rem | Default page content. The named token replaces a one-off width. |
| .id-wide, .id-layout-wide | layout.container.wide | 96rem | Surfaces organised as grids of objects: the component gallery, category pages and dashboards. |
| .id-full | Not applicable | 100% | 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.
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.
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.
| Prefix | From | What is changing |
|---|---|---|
| sm: | 640px | Large phone. Two columns can begin. |
| md: | 768px | Portrait tablet. A rail still costs too much width. |
| lg: | 1024px | Landscape tablet and small laptop. The named splits expand. |
| xl: | 1280px | Desktop. 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.
| Situation | Use |
|---|---|
| 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 fits | Create a named component recipe. A one-off page grid becomes the next grid-cols-[1.15fr,1fr]. |