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.

Button

Five variants in the uppercase mono label style, mono 0.75rem, uppercase, 0.2em tracking, padding space-2 by space-4, square corners.

Variants
Hover — destructive Red carries the real signal
Default
Hover
Hover — accent The dual-accent exception
Default
Hover
  • Ghost / nav (most common): no border, muted-foreground, foreground on hover.
  • Outlined: 1px foreground border; inverts to a foreground fill on hover.
  • Filled (primary action, rare): foreground fill, background text, 90% on hover.
  • Destructive: 1px primary border and text; fills primary on hover. Red carries the real hover signal.
  • Accent: primary at rest; on hover the border and fill become highlight with highlight-foreground text. The dual-accent exception, scoped to this button and the Interactive card. Red and Turquoise are never visible on it at the same moment.
  • Disabled is always opacity 0.4. Focus is a 1px ring. Turquoise never appears on a button at rest.

Tag

Small inline badges in mono at 0.65rem, uppercase, 0.12em tracking, padding 2px by 8px. Four variants, all ink-only.

Variants
NeutralSignalOutlinedSaved

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.

Forms
Section title
Emphasized section
With a stripe marker
Semantic tokens — never a raw hex in markup

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.

Groups
·
·
·

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.

States
ConnectedWarningLoadingDisconnected

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.

Unordered — divider, not a bullet
  • Visible 1px borders everywhere
  • No shadows; elevation is a background step
  • Uppercase monospace labels
Ordered — tabular mono numbers
  1. 01Install the theme
  2. 02Pick a font flavor
  3. 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.

Data table — tabular-nums, no zebra striping
MetricValueChange
Sessions1,209,384+4.2%
Conversions18,050+0.8%
Rate1.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.

Three lengths
36px · marker before a heading
64px · under the hero title
140px · closing flourish

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.

Four touches
Icon fillDotUnderlineUnderlined labelWash · 10%Separated without a border

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.

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.

Fig. 1 — grayscale, the default treatment. Keeps the four-token palette intact.
Fig. 2 — full color, because the photograph itself is the content — a named, scoped exception.

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.

Share bars — outline ring marks the highlight slice
Governed third line — highlight for a genuine second series

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.

geist-icons, restyled — stroke 1.5, square caps, miter joins
View on GitHub
.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.