04 — Patterns
Components
Nineteen patterns, each a small amount of HTML on the tokens. Every demo below is live and copyable; every guideline says what the consumer provides. One accent per component at any moment; Turquoise carries meaning in exactly two of them.
Gallery
At a glance — every pattern on the tokens · each card links to its guideline
- First item
- Second item
- Third item
| Metric | Value |
|---|---|
| Sessions | 1,209,384 |
| Conversions | 18,050 |
| Rate | 1.4931% |
Elevated surface
Depth is a background step, never a shadow.
Featured
One card in a set — never the whole grid.
Accent card
Decorative, not a state indicator.
Tip
Content-sized, never full-bleed.
Click anywhere
Red border at rest, Turquoise on hover.
Tri-part stripeTag
Small inline badges in mono at 0.65rem, uppercase, 0.12em tracking, padding 2px by 8px. Four variants, all ink-only.
Neutral is muted-foreground text. Signal inverts to a foreground fill. Outlined is a dashed foreground border at 50% with a 4px dot. Saved is a solid border at 30%, text at 50%, same dot. Never rounded-full, never primary or highlight on a tag.
Card
A bordered surface one background step above the page: 1px border, card fill, padding space-6, square corners. Four forms; one accent per card at any moment.
Elevated surface
Depth is a background step, never a shadow.
Featured
Selective red border: one card in a set.
Accent card
Turquoise border and 8% wash. Decorative.
Interactive card
Red at rest, Turquoise on hover. Click anywhere.
Emphasis card: the border swaps to primary for one card in a set, the featured, current or first one. Never a whole grid. Accent card: highlight border and an 8% wash. Stronger than Emphasis and non-semantic. Interactive card: wrap in <a> or <button>; primary border at rest, highlight border and a 5% wash on hover. The dual-accent exception applied to a card.
Input
A text field on the input surface with a 1px border, padding space-2 by space-3, mono text at 0.85rem. Focus is a 1px ring, Swiss Red.
The label above is the uppercase mono label, foreground and 700 when active. Square corners, no inner shadow. Errors are copy and weight, not a red field, and never Turquoise.
SectionHeader
A heading beside a full-width 1px rule, baseline-aligned, gap space-3, margin-bottom space-6.
Section title
Emphasized section
With a stripe marker
The rule is border by default and swaps to primary for a section that earns emphasis: a page's opening section, a featured callout, one or two per page, never every divider. Optionally a 36px tri-part stripe precedes the title.
Toggle
Two or more inline options separated by a middot. No switch chrome, no pill, no track.
The active option is foreground; the rest muted-foreground with a hover lift; the middot at 0.4 opacity. Use aria-pressed. Never a Turquoise active state.
StatusPip
An inline indicator: a 6px dot and an uppercase mono label at 0.75rem with 0.15em tracking. State lives in the dot alone.
Connected is foreground; Warning is primary; Loading is muted-foreground at 30% with a pulse; Disconnected is foreground at 25%. highlight never appears here: a turquoise dot would read as a state.
List
No round bullet glyphs. Unordered items are separated by a 1px border top rule; ordered items lead with a two-digit tabular mono number.
- Visible 1px borders everywhere
- No shadows; elevation is a background step
- Uppercase monospace labels
- 01Install the theme
- 02Pick a font flavor
- 03Build with semantic tokens
Dividers and numbers stay ink and muted-foreground only. Red or Turquoise as a list marker is a hard rule violation.
Table
A bold mono header row over a 2px border rule, 1px rows, sans cells at 0.85rem, right-aligned tabular numerals.
| Metric | Value | Change |
|---|---|---|
| Sessions | 1,209,384 | +4.2% |
| Conversions | 18,050 | +0.8% |
| Rate | 1.4931% | −0.1% |
No zebra striping, no hover fill, no accent rules. Change is a signed numeral, never green or red.
SegmentStripe
Three equal solid segments, foreground, primary, highlight, 3px tall, as a static decorative divider at any length. The one place the two accents touch.
Always three equal segments in this order. Decorative only, never interactive or meaningful, a handful of times per page. Add aria-hidden="true". See Structural Block.
HeroBand
Red's Structural Block as a horizontal band, padding space-16 by 48px, used once at the top of a page as an alternative to the Sidebar.
Structural Block · hero band
Two colors, one accent, one third.
Below the band, ink and cream take over. One strong accent as a bold word; everything else is weight, space, and contrast.
Never combined with a Sidebar; a Turquoise panel never sits adjacent to it. The bold-word accent (one word in primary) is independent and may combine with either block.
Callout
Turquoise's Structural Block at content scale: a solid highlight panel with highlight-foreground text, padding 14px by space-4, max width 60ch.
Tip
Content-sized, never full-bleed. A callout may recur a few times per page.
Note
Never adjacent to Red's block. Combined footprint stays smaller than Red's.
A mono title at 0.7rem uppercase 700 and a 0.9rem body. For tips, notes and dashboard callouts; a content-level device, not page chrome. highlight-foreground is black in both themes (9.4:1 and 10.7:1).
TurquoiseBand
Turquoise's two page-scale forms, each used once per page and each capped around 15% of viewport height, visibly smaller than Red's block.
One more moment
A genuine third color — not an occasional accent.
Two colors. One accent. One genuine third.
Second-moment panel: padding space-10, later in the page flow, never in the hero; a label at 70% and a mono 700 statement at 1.5rem, max 44ch. Closing band: padding space-7, a centered mono 0.8rem uppercase 700 statement, near the page's end. Never adjacent to Red's block. The Overview page of this site ends with both.
DecorativeAccent
The small, non-semantic Turquoise touches. Each may recur on a page; none may carry meaning.
A highlight fill on a single icon as a flourish, a 6px dot, a 2px underline beneath a heading or label, a 10% wash behind a block that wants separation without a hard border. If removing one would change what the reader understands about state, it is the wrong tool. Never on a button, tag, pip or link as its rest color; never adjacent to Red on the same element.
Modal
A backdrop that dims the page with background at 80% and a hard-bordered panel: 1px foreground border, background fill, padding space-6, max width 560px.
Page content beneath
Ink and cream, borders, no shadows. The backdrop is a dim, not a shadow.
No radius, no shadow, no blur. Actions are Buttons: Destructive for the dangerous choice, Outlined for the safe one. No Turquoise in a dialog. Use role="dialog" and aria-modal.
Figure
An image in a 1px border container at a consistent aspect ratio with a mono italic caption beneath a 1px rule. Grayscale by default.
The default is filter: grayscale(1) or a duotone toward ink and cream. Full color is a scoped exception for photography that is itself the content, never decoration in UI chrome. The demo stands in for a photograph with a swatch.
Chart
Hand-rolled SVG in foreground, muted-foreground and primary, with highlight for a genuine third series only. The full treatment is on the Charts page.
Encode categories and emphasis with fill opacity, solid versus dashed strokes and outline rings first; reach for highlight only when those are exhausted and a chart truly needs a third distinct line.
Icon
geist-icons is the single sanctioned icon set: no other library, no icon fonts, no emoji. Restyle its defaults with one CSS rule.
.icon {{ width: 20px; height: 20px; fill: none; stroke: currentColor;
stroke-width: 1.5; stroke-linecap: square; stroke-linejoin: miter; }}
Size 16 to 20px, currentColor inheriting foreground or muted-foreground; primary only in the destructive and accent cases already reserved for it; highlight only as a single decorative fill, such as the hero's circle, never a state cue. Icons augment the uppercase mono label and never replace it. In React import from geist-icons and pass the same stroke props.