stnd.build

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.

.col-4 .sm:col-12
.col-8 .sm:col-12
.col-6
.col-6

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

col-8
col-4
col-3
col-3
col-6

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

One
Two
Three
Four
Five
Six

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

col-4 start-3
col-3 start-9

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

no-gap
no-gap
no-gap
no-gap

compact
compact
compact
compact

relaxed
relaxed
relaxed
relaxed

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

Card
Card
Card
Card

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

half
half
col-full: all twelve

a third
two thirds

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

span-4
span-3 startv-9
span-12

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