f3c00f9ce5
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.
945 lines
48 KiB
HTML
945 lines
48 KiB
HTML
<!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>
|