---
name: FivePaths Microsite v3
description: The shared design system for FivePaths product microsites, served from cdn.fivepaths.com/microsite/v3/.
colors:
  bg: "#ffffff"
  bg-dark: "#10141c"
  bg-alt: "#f8f9fb"
  bg-alt-dark: "#161b25"
  bg-card: "#ffffff"
  bg-card-dark: "#1b212c"
  bg-blur: "rgb(255 255 255 / 0.92)"
  bg-blur-dark: "rgb(16 20 28 / 0.92)"
  ink: "#141821"
  ink-dark: "#edf0f6"
  ink-soft: "#3d4350"
  ink-soft-dark: "#b9c0ce"
  ink-mute: "#505562"
  ink-mute-dark: "#a4abbb"
  rule: "#e5e7eb"
  rule-dark: "#272e3c"
  accent: "#006060"
  accent-dark: "#4dd2d2"
  accent-strong: "#004f4f"
  accent-strong-dark: "#7fdede"
  bronze: "#6f5000"
  bronze-dark: "#ffc94d"
  bronze-strong: "#5a4100"
  bronze-strong-dark: "#ffdd8a"
  amber-wash: "#fff8e4"
  amber-wash-dark: "#231900"
  critical: "#9b1c1c"
  critical-dark: "#ff8a80"
  amber: "#ffb300"
  amber-hover: "#ffc94d"
  amber-ink: "#1a1200"
  teal-solid: "#006060"
  board: "#10141c"
  board-2: "#161b25"
  board-deep: "#0b0f16"
  board-line: "#272e3c"
  board-glow: "#1e2431"
  board-ink: "#edf0f6"
  board-soft: "#d6dbe7"
  board-dim: "#9fa5b7"
  board-accent: "#4dd2d2"
  board-accent-2: "#7fdede"
  route-blue: "#0d5b98"
  route-green: "#006640"
  route-red: "#a72925"
  route-orange: "#f5851f"
  route-purple: "#684b8b"
  route-ink: "#ffffff"
  route-ink-dark: "#221200"
  code-comment: "#a0a5b4"
  code-path: "#a7d8b6"
  code-key: "#a9bfe0"
typography:
  h1:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "clamp(2rem, 5.5vw, 3.25rem)"
    fontWeight: 800
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  h2:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "clamp(1.5rem, 3.5vw, 2.125rem)"
    fontWeight: 750
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  h3:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "1.2rem"
    fontWeight: 700
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  h4:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "1.02rem"
    fontWeight: 700
    lineHeight: 1.15
    letterSpacing: "-0.015em"
  lead:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "clamp(1.1rem, 2.2vw, 1.3rem)"
    fontWeight: 400
    lineHeight: 1.65
  body:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "1.0625rem"
    fontWeight: 400
    lineHeight: 1.65
  small:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "0.9rem"
    fontWeight: 400
    lineHeight: 1.65
  eyebrow:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "0.78rem"
    fontWeight: 700
    letterSpacing: "0.09em"
  button:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "0.98rem"
    fontWeight: 650
    lineHeight: 1.25
  nav:
    fontFamily: "Overpass, system-ui, -apple-system, Segoe UI, Roboto, Helvetica Neue, Arial, sans-serif"
    fontSize: "0.95rem"
    fontWeight: 550
  mono:
    fontFamily: "Overpass Mono, ui-monospace, SF Mono, SFMono-Regular, Menlo, Consolas, Liberation Mono, monospace"
    fontSize: "0.85rem"
    fontWeight: 400
  callout-label:
    fontFamily: "Overpass Mono, ui-monospace, SF Mono, SFMono-Regular, Menlo, Consolas, Liberation Mono, monospace"
    fontSize: "0.72rem"
    fontWeight: 600
    letterSpacing: "0.09em"
rounded:
  radius-xs: "6px"
  radius-sm: "8px"
  radius: "12px"
  pill: "999px"
spacing:
  gap: "1.25rem"
  gutter: "1.5rem"
  pad-card: "1.5rem"
  pad-panel: "2rem"
  space-head: "2.5rem"
  space-section-tight: "3rem"
  gap-wide: "3rem"
  space-section: "4.5rem"
components:
  button-primary:
    backgroundColor: "{colors.amber}"
    textColor: "{colors.amber-ink}"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: "0.7rem 1.3rem"
    height: "44px"
  button-primary-hover:
    backgroundColor: "{colors.amber-hover}"
    textColor: "{colors.amber-ink}"
  button-secondary:
    backgroundColor: "transparent"
    textColor: "{colors.ink}"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: "0.7rem 1.3rem"
    height: "44px"
  button-secondary-hover:
    backgroundColor: "{colors.bg-alt}"
    textColor: "{colors.ink}"
  button-ink:
    backgroundColor: "{colors.ink}"
    textColor: "{colors.bg}"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: "0.7rem 1.3rem"
    height: "44px"
  button-ink-hover:
    backgroundColor: "{colors.ink-soft}"
    textColor: "{colors.bg}"
  button-teal:
    backgroundColor: "{colors.teal-solid}"
    textColor: "#ffffff"
    typography: "{typography.button}"
    rounded: "{rounded.pill}"
    padding: "0.7rem 1.3rem"
    height: "44px"
  button-teal-hover:
    backgroundColor: "{colors.accent-strong}"
    textColor: "#ffffff"
  card:
    backgroundColor: "{colors.bg-card}"
    textColor: "{colors.ink-soft}"
    rounded: "{rounded.radius}"
    padding: "{spacing.pad-card}"
  chip:
    backgroundColor: "{colors.bg-card}"
    textColor: "{colors.ink-soft}"
    typography: "{typography.mono}"
    rounded: "{rounded.pill}"
    padding: "0.25rem 0.7rem"
    height: "44px"
  chip-hover:
    textColor: "{colors.accent}"
  input:
    backgroundColor: "{colors.bg}"
    textColor: "{colors.ink}"
    typography: "{typography.body}"
    rounded: "{rounded.radius-sm}"
    padding: "0.45rem 0.75rem"
    height: "44px"
  nav-link:
    textColor: "{colors.ink-soft}"
    typography: "{typography.nav}"
    height: "44px"
  nav-link-hover:
    textColor: "{colors.ink}"
  callout:
    backgroundColor: "{colors.bg-alt}"
    textColor: "{colors.ink-soft}"
    rounded: "{rounded.radius-sm}"
    padding: "1rem 1.15rem"
  callout-warning:
    backgroundColor: "{colors.amber-wash}"
  dialog:
    backgroundColor: "{colors.bg-card}"
    textColor: "{colors.ink}"
    rounded: "{rounded.radius}"
    padding: "{spacing.pad-panel}"
    width: "34rem"
  route-blip:
    backgroundColor: "{colors.route-blue}"
    textColor: "{colors.route-ink}"
    typography: "{typography.mono}"
    rounded: "{rounded.radius-xs}"
    padding: "0.1rem 0.5rem"
---

# Design System: FivePaths Microsite v3

This file describes release 3.7.1 of the v3 sheet for agents generating pages against it. Its source is the root of the fivepaths-cdn repository, and it is published unchanged at <https://cdn.fivepaths.com/microsite/v3/DESIGN.md>. It is derived from, and subordinate to, three sources:

- [tokens.json](https://cdn.fivepaths.com/microsite/v3/tokens.json): token values, surface groups, override policy and the contrast pairings. Where this file and the manifest disagree, the manifest is right and this file is stale.
- MARKUP.md, in the repository: which element goes where. v3 styles elements and position, so markup is most of the design.
- [The v3 reference page](https://cdn.fivepaths.com/microsite/v3/): every component, rendered and listed with its markup.

Copy rules are in WRITING_GUIDE.md, in the repository. Hand-authored sites use v2 and its spec, DESIGN_GUIDE.md.

## Overview

A structural framework for small product sites: one shape, many brands. The components, spacing and type roles, the dark-band machinery and the accessibility floor are the system. The palette and the typeface are tokens a site replaces; the FivePaths values in the frontmatter are the default brand, not the system.

The look is restrained and informational. White and near-white paper bands alternate with near-black "board" bands (hero, proof strip, closing band, footer), and that light/dark alternation is the shared signature across sites. Color is spent sparingly: one amber fill for the primary ask, one teal for text accents, and everything else in neutral inks. Density is moderate, prose is held to a readable measure, and every interactive element is at least a 44px target.

Accessibility is a hard floor, not a goal: every text and background pairing clears WCAG AAA (7:1) against the least favorable ground the token can land on, and `npm test` measures it.

**Key Characteristics:**
- Elements and position carry the design; five classes survive (`ghost`, `ink`, `teal`, `tld`, `visually-hidden`).
- Two brand hues with one job each: amber fills, teal accents.
- Dark bands are a token remap, so components have no dark-specific rules.
- AAA contrast (7:1) on every pairing, 44px targets, drawn markers instead of glyphs.
- Light and dark schemes from one declaration per token via `light-dark()`.

## Colors

Neutral inks on white paper, a near-black board for dark bands, one amber fill and one teal accent. Values with a `-dark` key are the same token's dark-scheme arm.

### Primary
- **Amber** (`amber`, `--fp-amber`): the fill. The primary button and the skip link. Always a ground with `amber-ink` on it; hover goes to `amber-hover`. It is 1.9:1 on white, so it is never text on a light ground.
- **Teal** (`accent`, `--fp-accent`): every text accent. Links, eyebrows, list markers, step rings, focus outlines, the current-page underline in the nav. `accent-strong` is its hover. On dark grounds it lightens automatically through the remap.
- **Teal solid** (`teal-solid`, `--fp-teal-solid`): the accent as a fill, with white ink, for the `teal` action variant.

### Secondary
- **Bronze** (`bronze`, `--fp-bronze`): the amber family as text on a light ground, and the warning callout's rule. `bronze-strong` is exported for site sheets.
- **Amber wash** (`amber-wash`, `--fp-amber-wash`): the warning callout's ground. Links on it take `accent-strong`, since `accent` falls under 7:1 there.

### Tertiary
- **Critical** (`critical`, `--fp-critical`): state, not brand. Error borders, error messages, the critical callout's rule. Clears 7:1 on every ground in both schemes, so it holds as text. Always repeats words that already say it.
- **Route blips** (`route-blue`, `route-green`, `route-red`, `route-orange`, `route-purple`): data only. Route badges and series keys. White ink on all but orange, which takes `route-ink-dark`.

### Neutral
- **Paper** (`bg`, `bg-alt`, `bg-card`): page ground, the alternating band, cards. `bg-blur` is the sticky header's translucent ground.
- **Ink** (`ink`, `ink-soft`, `ink-mute`): headings and strong text, body prose, secondary text and control borders.
- **Rule** (`rule`): hairlines and card borders.
- **Board** (`board`, `board-2`, `board-deep`, `board-line`, `board-glow`, `board-ink`, `board-soft`, `board-dim`, `board-accent`, `board-accent-2`): the near-black palette that dark bands remap the neutrals to. `board-deep` is the footer; `board-glow` is the radial light in the hero and closing band.
- **Code** (`code-comment`, `code-path`, `code-key`): syntax colors in a listing, on the board ground.

**Amber is a fill, never text on a light ground.** When the amber family must be text, use bronze. The board is the one ground where amber as text clears AAA.

**Multicolour is data, never chrome.** Route blips mark data series and routes; no border, button or background takes one.

**Override a surface group wholly or not at all.** `tokens.json` lists the groups (light, board, fill, type). Changing `--fp-accent` without its group leaves pairings like `accent` on `bg-alt` unmeasured.

**A tint is `color-mix()` against a token, never a new literal**, so it follows a site's override and the dark-band remap.

## Typography

**Body Font:** Overpass, variable 100 to 900, self-hosted (SIL OFL 1.1), falling back to `system-ui`.
**Mono Font:** Overpass Mono, variable 300 to 700, for code, chips, step numerals, callout labels and data-flavoured chrome.

**Character:** one family at several weights. Hierarchy comes from weight steps (800, 750, 700, 650, 550) and size, with slightly tightened tracking on headings.

### Hierarchy
- **h1** (800, `clamp(2rem, 5.5vw, 3.25rem)`, 1.15): the page title, once, in the hero. Capped at 16em wide there.
- **h2** (750, `clamp(1.5rem, 3.5vw, 2.125rem)`, 1.15): section headings.
- **h3 / h4** (700, 1.2rem / 1.02rem): card titles and sub-groups.
- **Lead** (400, `clamp(1.1rem, 2.2vw, 1.3rem)`, `ink-soft`): the `p` directly after a heading in a section `header`, or after the hero `h1`.
- **Body** (400, 1.0625rem, 1.65): running text, held to the 52ch measure (about 73 characters in Overpass).
- **Eyebrow** (700, 0.78rem, 0.09em tracking, uppercase, `accent`): a `p` first in a section `header` with a heading after it. Use on few sections.
- **Small** (400, 0.9rem, `ink-mute`): fine print, via `<small>`.

Headings take `text-wrap: balance`, paragraphs `text-wrap: pretty`. Tables and `<output>` use tabular figures; running text keeps proportional ones.

**`--fp-label-lean` travels with the face.** Every label centered in a padded box (buttons, nav links, chips, step numerals) leans down by 0.12em so the cap center, not the line box, lands in the middle. A site that swaps `--fp-sans` sets the lean for its face; don't nudge labels ad hoc.

## Layout

Each `main > section` is a grid with named tracks: `content` (70rem), `wide` (90rem) and `full` (viewport edge), with a 1.5rem minimum gutter. A section's direct children sit in `content`; a `figure` asks for more with `data-width="wide"` or `"full"`. Content wrapped in an extra `div` falls out of the track silently.

The header and footer use padding instead of the grid, collapsing to the gutter on narrow screens and centering the 70rem column on wide ones.

Vertical rhythm comes from the spacing tokens: `space-section` above and below each band (`space-section-tight` with `data-tight`), `space-head` under a section header, 2.5rem above a heading that follows content, 2rem after a component grid. Component grids use `gap`.

Layouts are attributes: `data-layout="split"`, `"feature"` (with `flip`, `uneven`, `top`), `"shots"`, `"grid"`, `"hero"`. Card and grid counts come from `data-cols`. Breakpoints are a convention from `tokens.json`: two-column arrangements stack below 56rem, the header wraps below 45rem, `data-cols="2"`/`"3"` engage at 52rem and `"4"` at 68rem. A site sheet uses these rather than coining its own.

The sticky header clears anchors with `scroll-padding-top: 6.5rem`; a sticky sub-element sits at `top: 5.5rem` (`--fp-sticky-top`).

## Elevation & Depth

Mostly flat, with two shadows and tonal banding doing the rest. Depth between sections comes from the paper/board alternation, not from shadows.

### Shadow Vocabulary
- **Rest** (`box-shadow: 0 1px 2px rgb(20 24 33 / 0.05)`, dark `rgb(0 0 0 / 0.4)`): cards on the alternating band.
- **Lift** (`box-shadow: 0 16px 42px rgb(20 24 33 / 0.10)`, dark `rgb(0 0 0 / 0.4)`): framed screenshots, dialogs, floating menu panels.

A linked card responds to hover with a 2px rise and a darker border, removed under `prefers-reduced-motion`. The hero and closing band carry one soft radial glow in `board-glow`. Modal backdrops are `board-deep` at 70%.

## Shapes

Rounded but not soft. Cards, framed images and dialogs take 12px; fields, fieldsets, callouts, menu panels and popovers 8px; menu items and route blips 6px; buttons, chips and the nav call to action are pills. Callouts are squared on the left where their 3px rule runs. Borders are 1px `rule` on containers, 1px `ink-mute` on form controls, 1.5px on outlined buttons.

List markers, ticks, checks, the listing's three title-bar dots and a disclosure's triangle are drawn in CSS at a 3.5px stroke or as borders, never glyphs.

## Components

### Buttons
- **Shape:** pill (999px), at least 44px tall, 1.3rem inline padding, weight 650.
- **Primary:** the first link in a `[data-actions]` group, or any `button`. Amber fill, amber ink. Hover lightens to `amber-hover` and adds an underline.
- **Secondary:** every link after the first in a group, or `.ghost`: transparent with a 1.5px `ink-soft` outline, `ink` text; hover fills `bg-alt` and darkens the outline.
- **Ink:** `.ink`, ink fill with paper text. The header's call to action.
- **Teal:** `.teal`, `teal-solid` fill with white text, for emphasis where amber would overwhelm.
- **Transitions:** 120ms ease on color and border.
- **Busy:** `aria-busy="true"` adds a spinner before the label and blocks a second press.

### Chips
- **Style:** `ul[data-list="chips"]`. Mono 0.85rem, `ink-soft` on `bg-card`, 1px `rule` border, pill.
- **State:** hover turns border and text `accent`. In a `nav` (a pager), `aria-current` marks the page in weight and ink, not color.

### Cards / Containers
- **Markup:** `ul[data-list="cards"] > li`. A whole-card link is the item's only child; the closing `span` is the "read more" affordance in `accent`, weight 600.
- **Corner Style:** 12px.
- **Background:** `bg-card` with a 1px `rule` border; on the alternating band they take the rest shadow.
- **Internal Padding:** 1.5rem.

### Inputs / Fields
- **Scope:** styled only inside `form[data-layout="stack"]` or `"filters"`. An unmarked form is untouched in 3.x.
- **Style:** `bg` ground, 1px `ink-mute` border, 8px radius, 44px minimum height. A field is `label`, optional hint in `small`, optional error, then the control.
- **Focus:** the global 3px `accent` outline at 3px offset.
- **Error:** `aria-invalid="true"` adds a second pixel of `critical` border, drawn inside. The message is `small[data-severity="critical"]` between label and control; a `critical` callout first in the form links to each field.
- **Disabled:** `bg-alt` ground, `ink-soft` text.
- **Switch, range:** `role="switch"` on a checkbox, `input[type="range"]` with an `output`; both in the accent.

### Navigation
- **Header:** sticky, `bg-blur` with a 10px backdrop blur, 1px `rule` bottom border. Brand first (lockup at 3.2rem, `--fp-logo-height`), then `nav`.
- **Links:** `ink-soft`, weight 550, 0.95rem, no underline at rest; hover to `ink` with an underline. `aria-current` draws a 2px `accent` bar under the link.
- **Call to action:** the last item, `a.ink`, as a small pill.
- **Mobile:** below 45rem the row wraps and the nav aligns left.

### Footer
`body > footer` on `board-deep`. The slim row is the site's inverse lockup, "is a", the white FivePaths mark with "FivePaths", "product.", and the copyright pushed right. Privacy and terms links follow under the logo, then disclosures in `small`.

### Callouts
`aside`: 3px left rule in `accent` on `bg-alt`. `data-severity="warning"` takes a `bronze` rule on `amber-wash`; `"critical"` a `critical` rule. The first `p` is the label, mono 0.72rem uppercase in `ink-mute`, so severity is in words as well as color.

### Steps
`ol[data-list="steps"]`: a grid of items under a 1px `rule`, each numbered by a plain numeral in a 2.5px `accent` ring that widens to a pill at two digits. No leading zero.

### Figures
Told apart by content. An image is a screenshot: 1px `rule` border, 12px radius, lift shadow. A `table` scrolls sideways in its own box. A `blockquote` has a 3px `rule` down the left. A `pre` is a listing on the board with its `figcaption` as a title bar.

### Dialogs, menus, popovers
`dialog`: `bg-card`, 12px radius, 2rem padding, lift shadow, up to 34rem wide, rising in over 160ms. `details[data-menu]`: the summary is a pill, the panel floats below. `[popover]`: a short note opened by a press, never a hover; its trigger inside a sentence is a dotted-underlined word.

### Route blips
`[data-route="blue|green|red|orange|purple"]`: mono 0.78rem, weight 600, 6px radius, white ink (dark on orange). For data only.

## Do's and Don'ts

### Do:
- **Do** write every color as a `--fp-*` token, and every tint as `color-mix()` against one.
- **Do** put the page's primary ask first in a `[data-actions]` group, one primary per view. A second primary needs a second group.
- **Do** use `data-band="dark|hero|proof|cta"` for dark sections and let the remap recolour the components inside.
- **Do** keep every interactive element at 44px (`--fp-target`), and mark a standalone link with `data-target`.
- **Do** wrap media in a `figure`, even with no caption; the frame is keyed on it.
- **Do** honor `prefers-reduced-motion` in any new animation, and keep transitions at 120 to 160ms.
- **Do** check both schemes. A site should need no dark-mode CSS of its own.
- **Do** prefix a site's own names (`[data-gtfs-board]`, `--gtfs-route-ink`); unprefixed names belong to the framework.

### Don't:
- **Don't** use amber as text on a light ground, or invent a button color or a `-dark` button variant.
- **Don't** use route colors for chrome.
- **Don't** hardcode a color or write dark-band override rules.
- **Don't** override half a surface group; set the whole group or none of it.
- **Don't** add a class where an element, position or attribute carries the meaning, or a class that repeats its element.
- **Don't** wrap a section's children or a heading in a `div`; structural selectors stop matching with no error.
- **Don't** suppress the `:focus-visible` outline, remove the underline from links in running prose, or restyle a `summary` without drawing its triangle back.
- **Don't** draw markers, ticks or checks with glyphs.
- **Don't** style form controls outside `form[data-layout]`.
