Grid
Rosetta Stone: 12-Column Swiss Grid
The Swiss Grid (.grid) is a 12-column CSS Grid container with rhythm-aligned gaps (var(--gap)). Direct children default to full width (12 columns) unless given a .col-{1..12} span.
Quick Reference (Classes $\leftrightarrow$ Tokens)
| Intention | HTML Utility Class | CSS Token / Variable |
|---|---|---|
| 12-column Swiss Grid container | .grid |
display: grid; grid-template-columns: repeat(12, 1fr); gap: var(--gap) |
| Explicit N-column equal grid | .grid-2 .. .grid-12 |
grid-template-columns: repeat(N, 1fr) |
| Desktop column span (1..12) | .col-1 .. .col-12 |
grid-column: span N |
| Mobile override ($\le 768\text{px}$) | .sm:col-1 .. .sm:col-12 |
Stacks to full width with .col-4 sm:col-12 |
| Desktop override ($\ge 1024\text{px}$) | .lg:col-1 .. .lg:col-12 |
Wide-screen column refinement |
| Full-row span / Divider | .col-full, .col-row, hr.col-row |
grid-column: 1 / -1 |
| Compact / Relaxed grid gap | .grid.compact / .grid.relaxed |
Sets --gap: var(--trim) or --gap: var(--space) |
| Variable-driven free column | .free-col + .span-{n} / .startv-{n} |
Reads --start and --span custom properties |
Grid System
Layout
12-column Swiss-style responsive grid with flexible gaps and alignment. Uses CSS Grid with logical properties for RTL support. Supports nested grids, asymmetric layouts, gap variants (compact/normal/wide), and responsive column changes. All gaps align to the vertical rhythm system.
| Name | Description | Value |
|---|---|---|
.grid |
12-column Swiss-style responsive grid container with automatic column flow. | |
.grid-row |
Grid container with row flow. | |
.grid-{n} |
Explicit n-column grid container (1 to 12 columns). | |
.col-{n} |
Column span modifiers (1 to 12 columns, direct children of .grid). | |
.start-{n} |
Column start position (1 to 12). | |
.grid.no-gap |
Removes grid row gap. | |
.grid.compact |
Compact gap variant aligned to --trim. |
|
.grid.relaxed |
Relaxed gap variant aligned to --space. |
|
.sm:col-{n} |
Responsive column spans at mobile viewport (<=768px). | |
.sm:grid-{n} |
Responsive column grid count at mobile viewport (<=768px). | |
.lg:col-{n} |
Responsive column spans at desktop viewport (>=1024px). | |
.lg:grid-{n} |
Responsive column grid count at desktop viewport (>=1024px). | |
.row, |
.col-row, .col-full Spans every column of the grid (an hr.col-row also gets a divider margin). |
|
.free-col |
Column placed with the --start and --span variables instead of fixed classes. |
|
.span-{n}, |
.startv-{n} Set --span and --start (1 to 12) on a .free-col; startv avoids a clash with the .start-{n} utilities. sm: and lg: prefixes apply at a breakpoint. |
|
.free-col.sticky |
Free column that sticks while the rest scrolls (marginalia for editorial layouts). | |
.box |
Layout container whose children keep the vertical rhythm, like the grid cells do. | |
--start |
Column start of a .free-col (1 to 12, or auto). |
auto |
--span |
Column span of a .free-col (1 to 12). |
3 |
--gap |
Gap between grid items, read by the grid’s column-gap and row-gap; .compact and .relaxed set it. |
var(--gap-compact) |
// Basic 12-column grid with equal width columns
<div class="grid">
<div class="col-3">Item 1</div>
<div class="col-3">Item 2</div>
<div class="col-3">Item 3</div>
<div class="col-3">Item 4</div>
</div>
// Responsive grid layout
<div class="grid">
<div class="col-12 sm:col-6 lg:col-3">Card</div>
<div class="col-12 sm:col-6 lg:col-3">Card</div>
</div>
// Main content + sidebar layout
<div class="grid">
<div class="col-8">Main content</div>
<div class="col-4">Sidebar</div>
</div>
Twelve columns: spans add up to 12
<div class="grid">
<div class="col-8 bg-background border rounded-sm p-half">col-8</div>
<div class="col-4 bg-background border rounded-sm p-half">col-4</div>
<div class="col-3 bg-background border rounded-sm p-half">col-3</div>
<div class="col-3 bg-background border rounded-sm p-half">col-3</div>
<div class="col-6 bg-background border rounded-sm p-half">col-6</div>
</div>
Live
An explicit grid of n equal columns
<div class="grid-3">
<div class="bg-background border rounded-sm p-half">One</div>
<div class="bg-background border rounded-sm p-half">Two</div>
<div class="bg-background border rounded-sm p-half">Three</div>
<div class="bg-background border rounded-sm p-half">Four</div>
<div class="bg-background border rounded-sm p-half">Five</div>
<div class="bg-background border rounded-sm p-half">Six</div>
</div>
Live
Start position
<div class="grid">
<div class="col-4 start-3 bg-background border rounded-sm p-half">col-4 start-3</div>
<div class="col-3 start-9 bg-background border rounded-sm p-half">col-3 start-9</div>
</div>
Live
Gap variants
<div class="grid-4 no-gap"><div class="bg-background border rounded-sm p-half">no-gap</div><div class="bg-background border rounded-sm p-half">no-gap</div><div class="bg-background border rounded-sm p-half">no-gap</div><div class="bg-background border rounded-sm p-half">no-gap</div></div>
<br>
<div class="grid-4 compact"><div class="bg-background border rounded-sm p-half">compact</div><div class="bg-background border rounded-sm p-half">compact</div><div class="bg-background border rounded-sm p-half">compact</div><div class="bg-background border rounded-sm p-half">compact</div></div>
<br>
<div class="grid-4 relaxed"><div class="bg-background border rounded-sm p-half">relaxed</div><div class="bg-background border rounded-sm p-half">relaxed</div><div class="bg-background border rounded-sm p-half">relaxed</div><div class="bg-background border rounded-sm p-half">relaxed</div></div>
Live
Responsive: one column on a phone, two on a tablet, four on a desktop
<div class="grid">
<div class="col-12 sm:col-12 lg:col-3 bg-background border rounded-sm p-half">Card</div>
<div class="col-12 sm:col-12 lg:col-3 bg-background border rounded-sm p-half">Card</div>
<div class="col-12 sm:col-12 lg:col-3 bg-background border rounded-sm p-half">Card</div>
<div class="col-12 sm:col-12 lg:col-3 bg-background border rounded-sm p-half">Card</div>
</div>
Live
A row that spans every column, and a divider
<div class="grid">
<div class="col-6 bg-background border rounded-sm p-half">half</div>
<div class="col-6 bg-background border rounded-sm p-half">half</div>
<div class="col-full bg-background border rounded-sm p-half">col-full: all twelve</div>
<hr class="col-row">
<div class="col-4 bg-background border rounded-sm p-half">a third</div>
<div class="col-8 bg-background border rounded-sm p-half">two thirds</div>
</div>
Live
Free columns: span and start from variables
<div class="grid">
<div class="free-col span-4 bg-background border rounded-sm p-half">span-4</div>
<div class="free-col span-3 startv-9 bg-background border rounded-sm p-half">span-3 startv-9</div>
<div class="free-col span-12 bg-background border rounded-sm p-half">span-12</div>
</div>
Live
since 0.1.0 · see standard-04-rhythm.scss
All classes
Other
| Class | Declares |
|---|---|
.grid:not(# |
— |
.grid-row |
grid-auto-flow: row |
.row, .col-row, .col-full |
grid-column: 1 / -1 |
.grid .rhythm > * |
margin-block-end: var(--space) |
.free-col |
--start: auto |
.free-col.sticky |
position: sticky |
.grid.no-gap |
row-gap: 0 |