Elevation & depth
Four shadow tints layered onto the panel surface. Light mode uses ink-tinted black at low opacity; dark mode uses pure black at higher opacity (the same custom property tracks both themes).
Shadow scale
tint-1 is the resting panel base; tint-2 lifts a popover off the page; tint-3
floats a modal or vim-help overlay. The inset variant marks pressed states and focused
inputs.
tint-1
.06 / .45
Panel base shadow.
tint-2
.10 / .60
Lifted panel · floating popover.
tint-3
.16 / .75
Modal · vim-help overlay.
inset
.08 / .50
Pressed states, focused inputs.
Z-index layers
A small fixed set of layers — never invent ad-hoc z-indices.
| Layer | z-index | What sits there |
|---|---|---|
| Page content | 0 (auto) | Body, prose, specimens — the default plane |
| Sticky in-page chrome | [3] | Sticky <H2> headings inside the prose |
| Search backdrop | 40 | Dim/blur layer behind the cmd+K palette when open |
| Search panel | [49] | The cmd+K results card surface |
| Page chrome (topbar) | 50 | The sticky doc topbar |
| Search input (open) | [71] | The search input portals out of the topbar when the palette is open, sitting above every other layer so it's the only thing receiving keystrokes |
Component-internal stacking (the ThemeToggle puck, the ZebraRunSpecimen
selection ring) uses small ints (z-0 / z-10 / z-[1] / z-[2]) inside its own
isolate boundary. Those don't compose with the page ladder above — they're private to
the component.