Files
pipelines/web/design/tokens/styleguide.html
T
alan f3c00f9ce5 web: visual system tokens, styleguide and application notes
Role-named tokens (colour, 8px spacing, radii, type scale, elevation, focus,
state tints, motion) with a styleguide built from the app's real components and a
short application guide, including what to remove from the current CSS.
2026-10-19 17:25:01 +01:00

945 lines
48 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Pipelines web — visual system styleguide</title>
<link rel="stylesheet" href="./tokens.css" />
<link rel="stylesheet" href="./styleguide.css" />
</head>
<body>
<svg class="icon-sprite" aria-hidden="true" focusable="false" width="0" height="0">
<symbol id="i-branch" viewBox="0 0 24 24">
<circle cx="6" cy="5" r="2" fill="currentColor" stroke="none"></circle>
<circle cx="6" cy="19" r="2" fill="currentColor" stroke="none"></circle>
<circle cx="18" cy="12" r="2" fill="currentColor" stroke="none"></circle>
<path d="M6 7v10M8 12h8" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-clock" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="8" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 8v4l3 2" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-chat" viewBox="0 0 24 24">
<path d="M4 6.5A2.5 2.5 0 0 1 6.5 4h11A2.5 2.5 0 0 1 20 6.5v7a2.5 2.5 0 0 1-2.5 2.5H10l-6 4V6.5Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-settings" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="3" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 3v2M12 19v2M3 12h2M19 12h2M5.6 5.6 7 7M17 17l1.4 1.4M18.4 5.6 17 7M7 17l-1.4 1.4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-info" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="8" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 11v5M12 8h.01" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-graph" viewBox="0 0 24 24">
<circle cx="6" cy="6" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<circle cx="18" cy="9" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<circle cx="10" cy="18" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="m8 7 8 1M8 8l1 8M16 11l-5 6" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-code" viewBox="0 0 24 24">
<path d="m8 8-4 4 4 4M16 8l4 4-4 4M13 5l-2 14" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-search" viewBox="0 0 24 24">
<circle cx="11" cy="11" r="6.5" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="m16 16 4 4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-paperclip" viewBox="0 0 24 24">
<path d="M9 12.5 15.5 6a3.5 3.5 0 0 1 5 5L11 20.5a5.5 5.5 0 0 1-7.8-7.8l9-9" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-shield" viewBox="0 0 24 24">
<path d="M12 3 5 6v5.5c0 4.3 2.9 8.2 7 9.5 4.1-1.3 7-5.2 7-9.5V6l-7-3Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
<path d="M12 8v4M12 15h.01" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-send" viewBox="0 0 24 24">
<path d="m4 12 16-7-7 16-2.4-6.6L4 12Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
</symbol>
</svg>
<div class="guide">
<aside class="guide-rail" aria-label="Styleguide contents">
<div class="guide-brand">
<span class="guide-mark" aria-hidden="true"></span>
<span class="guide-brand-text">
<span class="guide-brand-name">Pipelines</span>
<span class="guide-brand-sub">visual system</span>
</span>
</div>
<nav class="guide-nav" aria-label="Sections">
<p class="guide-nav-label">Contents</p>
<a href="#foundations"><span class="guide-nav-index">01</span>Foundations</a>
<a href="#type"><span class="guide-nav-index">02</span>Type</a>
<a href="#space"><span class="guide-nav-index">03</span>Space and depth</a>
<a href="#navigation"><span class="guide-nav-index">04</span>Rail</a>
<a href="#lists"><span class="guide-nav-index">05</span>Lists and toolbar</a>
<a href="#data"><span class="guide-nav-index">06</span>Key/value and code</a>
<a href="#overlays"><span class="guide-nav-index">07</span>Dialog and sheet</a>
<a href="#conversation"><span class="guide-nav-index">08</span>Conversation</a>
<a href="#content"><span class="guide-nav-index">09</span>Artifacts and empty</a>
</nav>
<div class="guide-rail-footer">
<span>Tokens v1 · dark identity</span>
<span>1440 × 900 capture</span>
<span>Status hues unchanged</span>
</div>
</aside>
<main class="guide-main">
<header class="guide-header">
<p class="eyebrow">Design deliverable</p>
<h1>Visual system</h1>
<p class="guide-lead">
The Pipelines web client keeps the app's dark identity, its mint accent and its
run-status vocabulary. This guide refines the layer model, the spacing and type
scales, and the component shapes so every area reads from one set of roles
instead of repeating its own chip, border and shadow.
</p>
<div class="guide-meta-row">
<span><strong>Contrast</strong> body ≥ 4.5:1 · UI edge ≥ 3:1</span>
<span><strong>Focus</strong> 2px ring, 2px offset</span>
<span><strong>Motion</strong> 80 / 120 / 180 / 240 ms</span>
<span><strong>Grid</strong> 8px with 4px half-steps</span>
</div>
</header>
<!-- ── 01 Foundations ─────────────────────────────────────────────── -->
<section class="guide-section" id="foundations" aria-labelledby="foundations-title">
<div class="section-head">
<h2 id="foundations-title">Foundations</h2>
<span class="section-index">01 / 09</span>
</div>
<p class="section-note">
Colour is assigned by layer, not by file. The page is <code>bg</code>;
a pane or card is <code>surface</code>; a control, row or code body is
<code>surface-2</code>; anything that floats is <code>elevated</code>.
Borders mark interactive edges. Dividers separate content inside one surface.
</p>
<div class="swatch-group">
<p class="swatch-group-label">Canvas and surface layers</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-bg)"></span>
<span class="swatch-name">--color-bg</span>
<span class="swatch-value">#0e1513</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-surface)"></span>
<span class="swatch-name">--color-surface</span>
<span class="swatch-value">#161d1b</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-surface-2)"></span>
<span class="swatch-name">--color-surface-2</span>
<span class="swatch-value">#1a211f</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-elevated)"></span>
<span class="swatch-name">--color-elevated</span>
<span class="swatch-value">#252c2a</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-elevated-2)"></span>
<span class="swatch-name">--color-elevated-2</span>
<span class="swatch-value">#2f3634</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-scrim)"></span>
<span class="swatch-name">--color-scrim</span>
<span class="swatch-value">black 58%</span>
</div>
</div>
</div>
<div class="swatch-group">
<p class="swatch-group-label">Text, lines and focus</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-text)"></span>
<span class="swatch-name">--color-text</span>
<span class="swatch-value">#dee4e1</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-muted)"></span>
<span class="swatch-name">--color-muted</span>
<span class="swatch-value">#a9bab5</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-faint)"></span>
<span class="swatch-name">--color-faint</span>
<span class="swatch-value">#8b9b96</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-divider)"></span>
<span class="swatch-name">--color-divider</span>
<span class="swatch-value">#2c3a36</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-border)"></span>
<span class="swatch-name">--color-border</span>
<span class="swatch-value">#6a7874</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-border-strong)"></span>
<span class="swatch-name">--color-border-strong</span>
<span class="swatch-value">#889391</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-focus)"></span>
<span class="swatch-name">--color-focus</span>
<span class="swatch-value">#a9f0dd</span>
</div>
</div>
</div>
<div class="swatch-group">
<p class="swatch-group-label">Accent and outcome</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-accent)"></span>
<span class="swatch-name">--color-accent</span>
<span class="swatch-value">#7fd1bb</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-accent-strong)"></span>
<span class="swatch-name">--color-accent-strong</span>
<span class="swatch-value">#a3e4d3</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-ok)"></span>
<span class="swatch-name">--color-ok</span>
<span class="swatch-value">#6bd39a</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-warn)"></span>
<span class="swatch-name">--color-warn</span>
<span class="swatch-value">#e6c268</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-bad)"></span>
<span class="swatch-name">--color-bad</span>
<span class="swatch-value">#ef8a8a</span>
</div>
</div>
</div>
</section>
<!-- ── 02 Type ────────────────────────────────────────────────────── -->
<section class="guide-section" id="type" aria-labelledby="type-title">
<div class="section-head">
<h2 id="type-title">Type</h2>
<span class="section-index">02 / 09</span>
</div>
<p class="section-note">
Eight sans roles and two mono roles. A screen title is
<code>title</code>; a section header is <code>title-small</code>; a row name is
<code>body</code> at semibold; meta is <code>meta</code>. Nothing picks a size
directly.
</p>
<div class="type-table">
<div class="type-row">
<span class="type-token">--type-eyebrow</span>
<span class="t-eyebrow">Workspace</span>
<span class="type-spec">11 / 14 · 600 · 0.06em</span>
</div>
<div class="type-row">
<span class="type-token">--type-label</span>
<span class="t-label">v5</span>
<span class="type-spec">11 / 16 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-meta</span>
<span class="t-meta">id 24 · v5 · 6 stages</span>
<span class="type-spec">12 / 16 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-body-small</span>
<span class="t-body-small">This asks the server to stop the active run.</span>
<span class="type-spec">13 / 18 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-body</span>
<span class="t-body">Plan and land</span>
<span class="type-spec">14 / 20 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-title-small</span>
<span class="t-title-small">Waiting for your decision</span>
<span class="type-spec">16 / 22 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-title</span>
<span class="t-title">Pipelines</span>
<span class="type-spec">20 / 26 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-display</span>
<span class="t-display">Visual system</span>
<span class="type-spec">24 / 30 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-code</span>
<span class="t-code">sha256:9f2c41e8a7</span>
<span class="type-spec">12 / 18 · mono</span>
</div>
<div class="type-row">
<span class="type-token">--type-code-small</span>
<span class="t-code">run 458 · 12m</span>
<span class="type-spec">11 / 16 · mono</span>
</div>
</div>
</section>
<!-- ── 03 Space and depth ─────────────────────────────────────────── -->
<section class="guide-section" id="space" aria-labelledby="space-title">
<div class="section-head">
<h2 id="space-title">Space and depth</h2>
<span class="section-index">03 / 09</span>
</div>
<p class="section-note">
One 8px grid with 4px half-steps. Padding inside a component is smaller than
the gap between components; the gap between blocks is smaller than the gap
between sections. Radii collapse to five roles, and only floating surfaces
carry a shadow.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Spacing scale</h3>
<span class="specimen-caption">8px grid · 4px half-steps</span>
</div>
<div class="space-table">
<div class="space-row">
<span class="space-token">--space-3xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-3xs)"></span></span>
<span class="space-value">2px</span>
</div>
<div class="space-row">
<span class="space-token">--space-2xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-2xs)"></span></span>
<span class="space-value">4px</span>
</div>
<div class="space-row">
<span class="space-token">--space-xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-xs)"></span></span>
<span class="space-value">8px</span>
</div>
<div class="space-row">
<span class="space-token">--space-s</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-s)"></span></span>
<span class="space-value">12px</span>
</div>
<div class="space-row">
<span class="space-token">--space-m</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-m)"></span></span>
<span class="space-value">16px</span>
</div>
<div class="space-row">
<span class="space-token">--space-l</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-l)"></span></span>
<span class="space-value">24px</span>
</div>
<div class="space-row">
<span class="space-token">--space-xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-xl)"></span></span>
<span class="space-value">32px</span>
</div>
<div class="space-row">
<span class="space-token">--space-2xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-2xl)"></span></span>
<span class="space-value">40px</span>
</div>
<div class="space-row">
<span class="space-token">--space-3xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-3xl)"></span></span>
<span class="space-value">48px</span>
</div>
<div class="space-row">
<span class="space-token">--space-4xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-4xl)"></span></span>
<span class="space-value">64px</span>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Radii</h3>
<span class="specimen-caption">one family, five roles</span>
</div>
<div class="radius-grid">
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-xs)"></span>
<span class="swatch-name">--radius-xs</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-s)"></span>
<span class="swatch-name">--radius-s</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-control)"></span>
<span class="swatch-name">--radius-control</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-card)"></span>
<span class="swatch-name">--radius-card</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-sheet)"></span>
<span class="swatch-name">--radius-sheet</span>
</div>
<div class="radius-cell radius-cell--pill">
<span class="radius-box" style="--radius: var(--radius-pill)"></span>
<span class="swatch-name">--radius-pill</span>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Elevation</h3>
<span class="specimen-caption">floating surfaces only</span>
</div>
<div class="elevation-grid">
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-1)">--elevation-1</div>
<span class="swatch-value">menu item, sticky edge</span>
</div>
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-2)">--elevation-2</div>
<span class="swatch-value">menu, toast</span>
</div>
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-3)">--elevation-3</div>
<span class="swatch-value">dialog</span>
</div>
</div>
</div>
</section>
<!-- ── 04 Rail ────────────────────────────────────────────────────── -->
<section class="guide-section" id="navigation" aria-labelledby="navigation-title">
<div class="section-head">
<h2 id="navigation-title">Rail</h2>
<span class="section-index">04 / 09</span>
</div>
<p class="section-note">
Destinations and sections share one item shape. The active item changes its
surface, its weight and adds a 2px inset accent bar, so selection is never
colour alone. Hover is a wash, not a new layer. Width belongs to the layout
track; the rail never sizes itself from its labels.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Destinations and sections</h3>
<span class="specimen-caption">200px track · 44px items</span>
</div>
<div class="stage stage--bare">
<div class="rail">
<div class="rail-brand">
<span class="rail-mark" aria-hidden="true"></span>
<span>Pipelines</span>
</div>
<nav aria-label="Destinations">
<a class="rail-item is-active" href="#navigation" aria-current="page">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-branch"></use></svg>
<span>Pipelines</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-chat"></use></svg>
<span>Chat</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-settings"></use></svg>
<span>Settings</span>
</a>
</nav>
<div class="rail-divider" role="presentation"></div>
<p class="rail-heading">Sections</p>
<div role="tablist" aria-label="Sections" aria-orientation="vertical">
<button class="rail-item is-active" type="button" role="tab" aria-selected="true">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-info"></use></svg>
<span>Summary</span>
</button>
<button class="rail-item" type="button" role="tab" aria-selected="false">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-graph"></use></svg>
<span>Graph</span>
</button>
<button class="rail-item" type="button" role="tab" aria-selected="false">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-code"></use></svg>
<span>Source</span>
</button>
</div>
<div class="rail-footer">
<span class="live-dot" aria-hidden="true"></span>
<span>Connected</span>
</div>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Item states</h3>
<span class="specimen-caption">default · hover · active</span>
</div>
<div class="rail-state-grid">
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">default</span>
</div>
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item is-hover" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">hover · wash 5%</span>
</div>
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item is-active" href="#navigation" aria-current="page">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">active · accent inset 2px</span>
</div>
</div>
</div>
</section>
<!-- ── 05 Lists and toolbar ───────────────────────────────────────── -->
<section class="guide-section" id="lists" aria-labelledby="lists-title">
<div class="section-head">
<h2 id="lists-title">Lists and toolbar</h2>
<span class="section-index">05 / 09</span>
</div>
<p class="section-note">
A row is one control, not a box around a box. Name, status and meta share one
two-column grid; hover is a wash and selection adds the accent bar. The toolbar
uses the same 36px control height as every other button and field.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Toolbar</h3>
<span class="specimen-caption">filter · sort · search · live</span>
</div>
<div class="toolbar">
<button class="btn" type="button">Filter</button>
<button class="btn" type="button">Sort: Newest first</button>
<label class="search">
<svg class="search-icon" aria-hidden="true" focusable="false"><use href="#i-search"></use></svg>
<input type="text" placeholder="Search pipelines, runs and artifacts" aria-label="Search pipelines, runs and artifacts" />
</label>
<span class="live-badge"><span class="live-dot" aria-hidden="true"></span>live</span>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Rows</h3>
<span class="specimen-caption">default · hover · selected</span>
</div>
<div class="stage">
<div class="row-list">
<button class="row is-selected" type="button" aria-current="true">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row is-hover" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Nightly audit</span>
<span class="chip chip--running"><span class="chip-glyph" aria-hidden="true">▶</span>running</span>
<span class="row-meta">id 12 · v9 · 5 stages</span>
</button>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Density</h3>
<span class="specimen-caption">light · compact</span>
</div>
<div class="density-grid">
<div class="density-panel">
<div class="density-head">
<span class="density-title">Light density</span>
<span class="density-meta">row 12px block</span>
</div>
<div class="row-list">
<button class="row" type="button">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Docs site</span>
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="row-meta">id 18 · v3 · 3 stages</span>
</button>
</div>
</div>
<div class="density-panel" data-density="compact">
<div class="density-head">
<span class="density-title">Compact</span>
<span class="density-meta">row 8px block</span>
</div>
<div class="row-list">
<button class="row" type="button">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Docs site</span>
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="row-meta">id 18 · v3 · 3 stages</span>
</button>
</div>
</div>
</div>
</div>
</section>
<!-- ── 06 Key/value and code ──────────────────────────────────────── -->
<section class="guide-section" id="data" aria-labelledby="data-title">
<div class="section-head">
<h2 id="data-title">Key/value and code</h2>
<span class="section-index">06 / 09</span>
</div>
<p class="section-note">
Facts use one two-column table with the label in <code>meta</code> and the value
in <code>body-small</code>; hashes, sessions and paths take the mono role. A code
block is a single framed surface with its own header, never a bordered box
inside another bordered box.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Key/value table</h3>
<span class="specimen-caption">Summary</span>
</div>
<div class="stage">
<dl class="kv">
<div><dt>Content hash</dt><dd><code>sha256:9f2c41e8a7</code></dd></div>
<div><dt>Started</dt><dd>19 Oct 2026 14:20</dd></div>
<div><dt>Finished</dt><dd>19 Oct 2026 14:32</dd></div>
<div><dt>Duration</dt><dd>12m</dd></div>
</dl>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Monospace code</h3>
<span class="specimen-caption">one frame, one label</span>
</div>
<div class="code-card">
<div class="code-head">
<span>Shell</span>
<button class="btn btn--ghost btn--small" type="button">Copy</button>
</div>
<pre class="code-body"><code><span class="tok-cmd">node</span> serve.mjs <span class="tok-arg">--port 8095 --pipelines 127.0.0.1:8080</span>
<span class="tok-comment"># http://127.0.0.1:8095/</span>
<span class="tok-cmd">PIPELINES_WS_URL</span>=<span class="tok-arg">ws://127.0.0.1:8095/connect</span> <span class="tok-cmd">node</span> test/smoke.mjs</code></pre>
</div>
</div>
</section>
<!-- ── 07 Dialog and sheet ────────────────────────────────────────── -->
<section class="guide-section" id="overlays" aria-labelledby="overlays-title">
<div class="section-head">
<h2 id="overlays-title">Dialog and sheet</h2>
<span class="section-index">07 / 09</span>
</div>
<p class="section-note">
Anything above the page uses <code>elevated</code>, the sheet radius and one
elevation. The scrim carries the separation; the panel does not add a second
border around its content. Actions sit on one row, with the primary last.
</p>
<div class="density-grid">
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Confirm dialog</h3>
<span class="specimen-caption">Cancel run 458?</span>
</div>
<div class="overlay-demo">
<div class="scrim" aria-hidden="true"></div>
<div class="dialog" role="dialog" aria-modal="true" aria-labelledby="cancel-title">
<h3 class="dialog-title" id="cancel-title">Cancel run 458?</h3>
<p class="dialog-message">This asks the server to stop the active run.</p>
<div class="dialog-actions">
<button class="btn" type="button">Keep</button>
<button class="btn btn--danger" type="button">Cancel run</button>
</div>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Bottom sheet</h3>
<span class="specimen-caption">Needs you</span>
</div>
<div class="overlay-demo overlay-demo--sheet">
<div class="scrim" aria-hidden="true"></div>
<div class="sheet" role="dialog" aria-modal="true" aria-labelledby="needs-title">
<div class="sheet-head">
<h3 class="sheet-title" id="needs-title">Needs you</h3>
<button class="btn btn--ghost btn--small" type="button">Close</button>
</div>
<div class="sheet-body">
<div class="sheet-row">
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="sheet-row-text">
<span class="sheet-row-title">Server</span>
<span class="sheet-row-meta">Server · failed · needs you</span>
</span>
<button class="btn btn--ghost btn--small" type="button">Dismiss</button>
</div>
<div class="sheet-row">
<span class="chip chip--waiting"><span class="chip-glyph" aria-hidden="true">…</span>waiting</span>
<span class="sheet-row-text">
<span class="sheet-row-title">Nightly audit</span>
<span class="sheet-row-meta">Nightly audit · waiting for your decision</span>
</span>
<button class="btn btn--ghost btn--small" type="button">Dismiss</button>
</div>
<button class="btn btn--ghost btn--small" type="button">Clear all</button>
</div>
</div>
</div>
</div>
</div>
</section>
<!-- ── 08 Conversation ───────────────────────────────────────────── -->
<section class="guide-section" id="conversation" aria-labelledby="conversation-title">
<div class="section-head">
<h2 id="conversation-title">Conversation</h2>
<span class="section-index">08 / 09</span>
</div>
<p class="section-note">
The operator gets a bubble; the agent gets a full-width turn. The transcript is
the page surface, so the agent turn does not need a second card. The composer
shares the control radius and focus ring, and the approval card is the one
place where a warning edge is warranted.
</p>
<div class="chat-stage">
<div class="turn turn--user">
<div class="bubble-user">Show me why run 458 needed the decision, and what changed in the last stage.</div>
</div>
<div class="turn turn--agent">
<span class="agent-name">Agent</span>
<div class="markdown">
<p class="md-paragraph">
Run 458 waited on the review stage. The landing step then completed and
recorded four artifacts.
</p>
<ul class="md-list">
<li>Review requested a decision on the land stage.</li>
<li>The decision was recorded, then the run finished.</li>
<li>Four files changed in the last stage.</li>
</ul>
<div class="md-code-block">
<div class="md-code-label">bash</div>
<pre class="md-pre"><code>git diff --stat HEAD~1
4 files changed, 86 insertions(+), 21 deletions(-)</code></pre>
</div>
</div>
</div>
<div class="composer">
<button class="icon-button" type="button" aria-label="Attach file" title="Attach file">
<svg class="icon icon--inline" aria-hidden="true" focusable="false"><use href="#i-paperclip"></use></svg>
</button>
<textarea class="composer-input" rows="1" placeholder="Message the agent… or / for commands" aria-label="Message the agent… or / for commands"></textarea>
<button class="send" type="button" aria-label="Send" title="Send">
<svg class="icon icon--inline" aria-hidden="true" focusable="false"><use href="#i-send"></use></svg>
</button>
</div>
<section class="approval" aria-label="Approval request">
<div class="approval-head">
<svg class="approval-shield" aria-hidden="true" focusable="false"><use href="#i-shield"></use></svg>
<span class="approval-titles">
<span class="approval-headline">Approve bash</span>
<span class="approval-status">Waiting for your response</span>
</span>
</div>
<pre class="approval-resources">docker build -t pipelines:dev .</pre>
<div class="approval-risk">
<span class="approval-risk-head">
<svg class="icon icon--small" aria-hidden="true" focusable="false"><use href="#i-shield"></use></svg>
<span class="approval-risk-label">RISK REVIEW</span>
</span>
<span class="approval-risk-text">This writes an image tagged pipelines:dev on this machine.</span>
</div>
<div class="approval-actions">
<button class="btn btn--primary" type="button">Allow once</button>
<button class="btn" type="button">Always allow</button>
<button class="btn btn--ghost" type="button">Reject</button>
</div>
</section>
</div>
</section>
<!-- ── 09 Artifacts and empty ─────────────────────────────────────── -->
<section class="guide-section" id="content" aria-labelledby="content-title">
<div class="section-head">
<h2 id="content-title">Artifacts and empty</h2>
<span class="section-index">09 / 09</span>
</div>
<p class="section-note">
A tile is one framed surface; the media fills it and the actions sit over it.
An empty state is a sentence and, when there is a way out, one action — never a
dashed box or an illustration competing with the text.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Artifact tiles</h3>
<span class="specimen-caption">image · video · PDF · JSON</span>
</div>
<div class="artifact-grid">
<div class="artifact-tile">
<span class="artifact-thumb" aria-hidden="true"></span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-thumb" aria-hidden="true"></span>
<span class="artifact-poster" aria-hidden="true"><span class="artifact-play">▶</span></span>
<span class="artifact-name">land.webm</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-kind">PDF</span>
<span class="artifact-name">session.pdf</span>
<span class="artifact-size">1.2 MiB</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Copy link</button>
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-kind">JSON</span>
<span class="artifact-name">report.json</span>
<span class="artifact-size">18.4 KiB</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Copy link</button>
<button class="artifact-action" type="button">Share</button>
</div>
</div>
</div>
</div>
<div class="density-grid">
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Empty state</h3>
<span class="specimen-caption">sentence plus one way out</span>
</div>
<div class="empty-state">
<p>No runs match the current filters.</p>
<button class="btn" type="button">Clear filters</button>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Run-status chip row</h3>
<span class="specimen-caption">web status palette · unchanged</span>
</div>
<div class="stage">
<div class="chip-row">
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="chip chip--running"><span class="chip-glyph" aria-hidden="true">▶</span>running</span>
<span class="chip chip--waiting"><span class="chip-glyph" aria-hidden="true">…</span>waiting</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="chip chip--canceled"><span class="chip-glyph" aria-hidden="true">⊘</span>canceled</span>
<span class="chip chip--interrupted"><span class="chip-glyph" aria-hidden="true">‖</span>interrupted</span>
<span class="chip chip--blocked"><span class="chip-glyph" aria-hidden="true">■</span>blocked</span>
<span class="chip chip--skipped"><span class="chip-glyph" aria-hidden="true">»</span>skipped</span>
<span class="chip chip--active"><span class="chip-glyph" aria-hidden="true">◆</span>active</span>
<span class="chip chip--unknown"><span class="chip-glyph" aria-hidden="true">?</span>unknown</span>
</div>
</div>
</div>
</div>
</section>
<footer class="guide-footer" id="closing">
<div class="section-head">
<h2>Apply it in this order</h2>
<span class="section-index">closing</span>
</div>
<div class="guide-footer-grid">
<div class="guide-footer-step">
<span class="guide-footer-index">01</span>
<h3>Install the roles</h3>
<p>Link tokens.css before the area stylesheets. Keep the app's status hues exactly as they are.</p>
</div>
<div class="guide-footer-step">
<span class="guide-footer-index">02</span>
<h3>Collapse the boxes</h3>
<p>Remove pane and card borders first, then per-row boxes. Replace them with spacing and dividers.</p>
</div>
<div class="guide-footer-step">
<span class="guide-footer-index">03</span>
<h3>Unify the details</h3>
<p>One chip, one control height, one radius family, one focus ring. Delete the duplicate selectors.</p>
</div>
</div>
<p class="guide-footer-files">
<span>tokens.css</span>
<span>styleguide.css</span>
<span>styleguide.html</span>
<span>capture.mjs</span>
<span>web/docs/visual-system.md</span>
</p>
</footer>
</main>
</div>
</body>
</html>