All specs
Display · columns

columns

Side-by-side column layout for dashboards and comparisons.

When to use

Use columns when you need to display related content side by side —

server comparison, before/after diffs, multi-panel dashboards, paired

key-value groups.

Anatomy

S E R V E R   A          S E R V E R   B

CPU: 45%                  CPU: 82%
Mem: 2.1GB                Mem: 3.7GB
Disk: 120GB               Disk: 89GB

With separator:

S E R V E R   A      │   S E R V E R   B
                      │
CPU: 45%              │   CPU: 82%
Mem: 2.1GB            │   Mem: 3.7GB

API

columns({
  items: [
    { title: 'Server A', content: 'CPU: 45%\nMem: 2.1GB\nDisk: 120GB' },
    { title: 'Server B', content: 'CPU: 82%\nMem: 3.7GB\nDisk: 89GB' },
  ],
})

columns({
  items: [
    { title: 'Before', content: oldConfig },
    { title: 'After',  content: newConfig },
  ],
  separator: true,
  gap: 6,
})

### Options

KeyTypeDefaultDescription
itemsarray{ title?, content, width? } per column
gapnumber?4Characters between columns
separatorboolean?falseShow vertical gutter between columns

### ColumnItem

KeyTypeDefaultDescription
titlestring?Tracked CAPS heading above content
contentstringColumn body — may contain newlines
widthnumber?autoFixed width; auto-fits to content if omitted

Column widths

When width is omitted, each column auto-sizes to its widest line

(including the tracked title). Columns never wrap — content is

rendered as-is.

Tokens

colors.accent, symbols.structure.gutter, typography (tracking)