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.
This commit is contained in:
@@ -0,0 +1,70 @@
|
||||
// Capture the visual-system styleguide at 1440 × 900 through the repository's
|
||||
// zero-dependency Chrome DevTools driver. Read-only import: web/test/browser.mjs
|
||||
// is not modified.
|
||||
//
|
||||
// node web/design/tokens/capture.mjs
|
||||
//
|
||||
// Writes PNGs into web/design/tokens/captures/ (gitignored by the root
|
||||
// `captures/` rule). No server is started; the styleguide is a local file.
|
||||
|
||||
import { mkdir } from "node:fs/promises";
|
||||
import { dirname, join } from "node:path";
|
||||
import { fileURLToPath, pathToFileURL } from "node:url";
|
||||
import { launchChrome } from "../../test/browser.mjs";
|
||||
|
||||
const here = dirname(fileURLToPath(import.meta.url));
|
||||
const outDir = join(here, "captures");
|
||||
const styleguide = pathToFileURL(join(here, "styleguide.html"));
|
||||
|
||||
const shots = [
|
||||
{ id: "foundations", name: "styleguide-01-foundations-1440x900.png" },
|
||||
{ id: "type", name: "styleguide-02-type-1440x900.png" },
|
||||
{ id: "space", name: "styleguide-03-space-1440x900.png" },
|
||||
{ id: "navigation", name: "styleguide-04-rail-1440x900.png" },
|
||||
{ id: "lists", name: "styleguide-05-lists-1440x900.png" },
|
||||
{ id: "data", name: "styleguide-06-data-1440x900.png" },
|
||||
{ id: "overlays", name: "styleguide-07-overlays-1440x900.png" },
|
||||
{ id: "conversation", name: "styleguide-08-conversation-1440x900.png" },
|
||||
{ id: "content", name: "styleguide-09-content-1440x900.png" },
|
||||
];
|
||||
|
||||
await mkdir(outDir, { recursive: true });
|
||||
|
||||
const browser = await launchChrome({ width: 1440, height: 900 });
|
||||
try {
|
||||
for (const shot of shots) {
|
||||
const page = await browser.openPage(`${styleguide.href}#${shot.id}`, {
|
||||
width: 1440,
|
||||
height: 900,
|
||||
});
|
||||
await page.waitForSelector(`#${shot.id}`);
|
||||
await page.evaluate("document.fonts.ready.then(() => true)");
|
||||
if (shot.id === "foundations") {
|
||||
await page.evaluate("window.scrollTo(0, 0)");
|
||||
} else {
|
||||
await page.evaluate(`(() => {
|
||||
const node = document.querySelector("#${shot.id}");
|
||||
node.scrollIntoView({ block: "start" });
|
||||
window.scrollBy(0, -16);
|
||||
return node.getBoundingClientRect().top;
|
||||
})()`);
|
||||
}
|
||||
await new Promise((resolve) => setTimeout(resolve, 180));
|
||||
const path = join(outDir, shot.name);
|
||||
await page.screenshot(path);
|
||||
const metrics = await page.evaluate(`(() => {
|
||||
const node = document.querySelector("#${shot.id}");
|
||||
return {
|
||||
top: Math.round(node.getBoundingClientRect().top),
|
||||
width: Math.round(node.getBoundingClientRect().width),
|
||||
pageHeight: document.documentElement.scrollHeight,
|
||||
};
|
||||
})()`);
|
||||
console.log(
|
||||
`${shot.name}: viewport 1440x900, section top ${metrics.top}px, width ${metrics.width}px, page ${metrics.pageHeight}px`,
|
||||
);
|
||||
await page.close();
|
||||
}
|
||||
} finally {
|
||||
await browser.close();
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,944 @@
|
||||
<!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>
|
||||
@@ -0,0 +1,262 @@
|
||||
/* ===========================================================================
|
||||
Pipelines web — visual system tokens
|
||||
---------------------------------------------------------------------------
|
||||
The single source of truth for colour roles, spacing, radii, type, elevation,
|
||||
focus, tints and motion. Every token is named for the job it does, never for
|
||||
the value it happens to hold.
|
||||
|
||||
This file contains custom properties only. Import it first, then a component
|
||||
stylesheet (styleguide.css is the worked example). Nothing here paints a
|
||||
selector on its own.
|
||||
|
||||
Contrast contract (verified against the surfaces below):
|
||||
--color-text 14.35:1 on --color-bg, 13.29:1 on --color-surface
|
||||
--color-muted 9.14:1 on --color-bg, 8.47:1 on --color-surface
|
||||
--color-border 3.71:1 on --color-surface, 3.09:1 on --color-elevated
|
||||
--color-focus 13.21:1 on --color-surface
|
||||
Run-status hues are the web's current values, unchanged.
|
||||
=========================================================================== */
|
||||
|
||||
:root {
|
||||
/* ---- Canvas and surface layers ---------------------------------------- */
|
||||
/* bg the page behind every pane
|
||||
surface a pane, card or transcript group
|
||||
surface-2 an inset control, row or code body
|
||||
elevated a menu, dialog, sheet or toast above the page
|
||||
elevated-2 the highest drawn surface: hover on an elevated control */
|
||||
--color-bg: #0e1513;
|
||||
--color-surface: #161d1b;
|
||||
--color-surface-2: #1a211f;
|
||||
--color-elevated: #252c2a;
|
||||
--color-elevated-2: #2f3634;
|
||||
--color-scrim: rgba(0, 0, 0, 0.58);
|
||||
|
||||
/* ---- Lines and focus --------------------------------------------------- */
|
||||
/* divider decorative separation inside one surface (not a control edge)
|
||||
border the edge of an interactive or focusable component; >=3:1 on
|
||||
bg, surface, surface-2 and elevated (use border-strong on
|
||||
elevated-2)
|
||||
border-strong selected / pressed emphasis; >=3:1
|
||||
focus the one focus ring colour, visible on every surface */
|
||||
--color-divider: #2c3a36;
|
||||
--color-border: #6a7874;
|
||||
--color-border-strong: #889391;
|
||||
--color-focus: #a9f0dd;
|
||||
|
||||
/* ---- Text -------------------------------------------------------------- */
|
||||
--color-text: #dee4e1;
|
||||
--color-muted: #a9bab5;
|
||||
--color-faint: #8b9b96;
|
||||
--color-on-accent: #06231c;
|
||||
--color-on-bad: #1b0b0b;
|
||||
--opacity-disabled: 0.5;
|
||||
|
||||
/* ---- Accent ------------------------------------------------------------ */
|
||||
--color-accent: #7fd1bb;
|
||||
--color-accent-strong: #a3e4d3;
|
||||
--color-accent-pressed: #5fbfa8;
|
||||
|
||||
/* ---- Outcome hues (the app's own: ok / warn / bad) -------------------- */
|
||||
--color-ok: #6bd39a;
|
||||
--color-warn: #e6c268;
|
||||
--color-bad: #ef8a8a;
|
||||
|
||||
/* ---- Run-status palette (the web's current values, unchanged) ---------- */
|
||||
/* These are copied from the current base.css/.chip-* rules. Three values
|
||||
(succeeded, failed, interrupted) are the web's tuned rendering; the Compose
|
||||
RunStatusPalette uses slightly different stops. This item does not re-tune
|
||||
any status hue. */
|
||||
--status-queued: #9aa6a2;
|
||||
--status-running: #7fb2f0;
|
||||
--status-active: #7fb2f0;
|
||||
--status-waiting: #8edff5;
|
||||
--status-succeeded: #6bd39a;
|
||||
--status-failed: #ef8a8a;
|
||||
--status-canceled: #889391;
|
||||
--status-interrupted: #e6c268;
|
||||
--status-blocked: #f0a35e;
|
||||
--status-skipped: #a8b8c8;
|
||||
--status-unknown: #bec9c5;
|
||||
|
||||
/* Status washes tint the chip body; the neutral chip edge does the 3:1
|
||||
boundary work, so a wash never has to carry the component alone. */
|
||||
--status-queued-wash: rgba(154, 166, 162, 0.10);
|
||||
--status-running-wash: rgba(127, 178, 240, 0.10);
|
||||
--status-active-wash: rgba(127, 178, 240, 0.10);
|
||||
--status-waiting-wash: rgba(142, 223, 245, 0.10);
|
||||
--status-succeeded-wash: rgba(107, 211, 154, 0.10);
|
||||
--status-failed-wash: rgba(239, 138, 138, 0.10);
|
||||
--status-canceled-wash: rgba(136, 147, 145, 0.06);
|
||||
--status-interrupted-wash: rgba(230, 194, 104, 0.10);
|
||||
--status-blocked-wash: rgba(240, 163, 94, 0.10);
|
||||
--status-skipped-wash: rgba(168, 184, 200, 0.10);
|
||||
--status-unknown-wash: rgba(190, 201, 197, 0.10);
|
||||
|
||||
/* ---- Interaction tints ------------------------------------------------- */
|
||||
/* A tint is a transparent wash laid over whatever surface is already there;
|
||||
it never replaces a surface role. */
|
||||
--tint-hover: rgba(222, 228, 225, 0.05);
|
||||
--tint-pressed: rgba(222, 228, 225, 0.09);
|
||||
--tint-selected: rgba(127, 209, 187, 0.12);
|
||||
--tint-selected-strong: rgba(127, 209, 187, 0.20);
|
||||
--tint-accent-soft: rgba(127, 209, 187, 0.10);
|
||||
--tint-ok-soft: rgba(107, 211, 154, 0.10);
|
||||
--tint-warn-soft: rgba(230, 194, 104, 0.10);
|
||||
--tint-bad-soft: rgba(239, 138, 138, 0.10);
|
||||
--tint-info-soft: rgba(142, 223, 245, 0.10);
|
||||
|
||||
/* ---- Spacing: 8px grid with 4px half-steps ----------------------------- */
|
||||
/* 3xs is the only 2px step, reserved for optical alignment (a glyph against
|
||||
a label), never for layout. */
|
||||
--space-3xs: 2px;
|
||||
--space-2xs: 4px;
|
||||
--space-xs: 8px;
|
||||
--space-s: 12px;
|
||||
--space-m: 16px;
|
||||
--space-l: 24px;
|
||||
--space-xl: 32px;
|
||||
--space-2xl: 40px;
|
||||
--space-3xl: 48px;
|
||||
--space-4xl: 64px;
|
||||
|
||||
/* Role aliases: use these in components, not the t-shirt scale. */
|
||||
--space-inline-tight: var(--space-2xs); /* glyph + label */
|
||||
--space-inline: var(--space-xs); /* buttons in a toolbar */
|
||||
--space-inline-loose: var(--space-s); /* chips in a row */
|
||||
--space-stack-tight: var(--space-2xs); /* title + meta */
|
||||
--space-stack: var(--space-xs); /* lines inside a block */
|
||||
--space-block: var(--space-m); /* block to block */
|
||||
--space-section: var(--space-l); /* section to section */
|
||||
--space-page: var(--space-xl); /* page / pane padding */
|
||||
--space-field-gap: var(--space-xs); /* label to field */
|
||||
--space-control-pad-inline: var(--space-s);
|
||||
--space-control-pad-block: var(--space-2xs);
|
||||
--space-row-pad-inline: var(--space-s);
|
||||
--space-panel-pad: var(--space-m);
|
||||
--space-pane-pad: var(--space-m);
|
||||
|
||||
/* ---- Density ----------------------------------------------------------- */
|
||||
/* Density changes padding and control height, never type size, so a compact
|
||||
list stays readable. Set data-density="compact" on a container. */
|
||||
--density-row-pad-block: var(--space-s);
|
||||
--density-row-pad-inline: var(--space-s);
|
||||
--density-row-gap: var(--space-2xs);
|
||||
--density-control-height: 36px;
|
||||
--density-control-height-small: 30px;
|
||||
--density-touch-target: 44px;
|
||||
--density-touch-target-large: 48px;
|
||||
|
||||
/* ---- Radii ------------------------------------------------------------- */
|
||||
--radius-xs: 4px; /* inline code */
|
||||
--radius-s: 6px; /* tiny marker, count badge */
|
||||
--radius-control: 8px; /* button, field, row, menu item */
|
||||
--radius-card: 12px; /* pane, card, tile, transcript group */
|
||||
--radius-sheet: 16px; /* dialog and sheet */
|
||||
--radius-pill: 999px; /* chip, count pill, terminal node */
|
||||
|
||||
/* ---- Type -------------------------------------------------------------- */
|
||||
--font-sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
|
||||
--font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
|
||||
|
||||
/* Sizes: 11 / 12 / 13 / 14 / 16 / 20 / 24. Roles, not numbers, at call sites. */
|
||||
--type-eyebrow: 600 11px/14px var(--font-sans);
|
||||
--type-label: 600 11px/16px var(--font-sans);
|
||||
--type-meta: 400 12px/16px var(--font-sans);
|
||||
--type-body-small: 400 13px/18px var(--font-sans);
|
||||
--type-body: 400 14px/20px var(--font-sans);
|
||||
--type-title-small: 600 16px/22px var(--font-sans);
|
||||
--type-title: 600 20px/26px var(--font-sans);
|
||||
--type-display: 600 24px/30px var(--font-sans);
|
||||
--type-code: 400 12px/18px var(--font-mono);
|
||||
--type-code-small: 400 11px/16px var(--font-mono);
|
||||
|
||||
--weight-regular: 400;
|
||||
--weight-medium: 500;
|
||||
--weight-semibold: 600;
|
||||
--tracking-eyebrow: 0.06em;
|
||||
--tracking-tight: -0.01em;
|
||||
|
||||
/* ---- Elevation --------------------------------------------------------- */
|
||||
/* Elevation is reserved for things that float above the page: a menu, a
|
||||
dialog, a sheet, a toast. A pane or card never casts a shadow. */
|
||||
--elevation-1: 0 1px 2px rgba(0, 0, 0, 0.32);
|
||||
--elevation-2: 0 8px 24px rgba(0, 0, 0, 0.42);
|
||||
--elevation-3: 0 18px 48px rgba(0, 0, 0, 0.52);
|
||||
--elevation-sheet: 0 -16px 48px rgba(0, 0, 0, 0.55);
|
||||
--elevation-menu: var(--elevation-2);
|
||||
--elevation-dialog: var(--elevation-3);
|
||||
--elevation-toast: var(--elevation-2);
|
||||
|
||||
/* ---- Focus ------------------------------------------------------------- */
|
||||
--focus-ring-width: 2px;
|
||||
--focus-ring-offset: 2px;
|
||||
--focus-ring-color: var(--color-focus);
|
||||
--focus-ring: 0 0 0 var(--focus-ring-width) var(--focus-ring-color);
|
||||
--focus-ring-inset: inset 0 0 0 var(--focus-ring-width) var(--focus-ring-color);
|
||||
--focus-halo: 0 0 0 var(--focus-ring-width) var(--color-bg),
|
||||
0 0 0 calc(var(--focus-ring-width) + var(--focus-ring-offset)) var(--color-focus);
|
||||
|
||||
/* ---- Motion ------------------------------------------------------------ */
|
||||
/* fast hover / press feedback
|
||||
base selection, expansion, focus colour
|
||||
slow dialog and sheet entry
|
||||
spin an indeterminate spinner's one rotation */
|
||||
--motion-instant: 80ms;
|
||||
--motion-fast: 120ms;
|
||||
--motion-base: 180ms;
|
||||
--motion-slow: 240ms;
|
||||
--motion-spin: 800ms;
|
||||
--ease-standard: cubic-bezier(0.2, 0, 0, 1);
|
||||
--ease-out: cubic-bezier(0, 0, 0, 1);
|
||||
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
|
||||
|
||||
/* ---- Layout ------------------------------------------------------------ */
|
||||
--layout-rail: 200px;
|
||||
--layout-list-min: 200px;
|
||||
--layout-list-max: 360px;
|
||||
--layout-dock: 60px;
|
||||
--layout-hairline: 1px;
|
||||
--layout-measure: 72ch;
|
||||
--layout-chat-measure: 560px;
|
||||
--layout-dialog: 440px;
|
||||
--layout-sheet: 560px;
|
||||
--layout-menu: 240px;
|
||||
|
||||
--icon-status: 14px;
|
||||
--icon-small: 16px;
|
||||
--icon-inline: 18px;
|
||||
--icon-list: 20px;
|
||||
--icon-rail: 24px;
|
||||
|
||||
--layer-sticky: 10;
|
||||
--layer-popover: 20;
|
||||
--layer-dialog: 40;
|
||||
--layer-toast: 50;
|
||||
|
||||
/* ---- Transitional aliases --------------------------------------------- */
|
||||
/* The existing stylesheets use these short names. They map onto the roles
|
||||
above so a file can be migrated one rule at a time; new CSS should use the
|
||||
--color-* / --type-* / --space-* roles directly. */
|
||||
--bg: var(--color-bg);
|
||||
--surface: var(--color-surface);
|
||||
--surface-2: var(--color-surface-2);
|
||||
--elevated: var(--color-elevated);
|
||||
--border: var(--color-border);
|
||||
--border-strong: var(--color-border-strong);
|
||||
--text: var(--color-text);
|
||||
--muted: var(--color-muted);
|
||||
--accent: var(--color-accent);
|
||||
--ok: var(--color-ok);
|
||||
--warn: var(--color-warn);
|
||||
--bad: var(--color-bad);
|
||||
}
|
||||
|
||||
/* Compact density is a scope, not a second theme: same colours, same type,
|
||||
tighter row padding and a shorter control. */
|
||||
[data-density="compact"] {
|
||||
--density-row-pad-block: var(--space-xs);
|
||||
--density-row-pad-inline: var(--space-s);
|
||||
--density-row-gap: var(--space-3xs);
|
||||
--density-control-height: 30px;
|
||||
--density-control-height-small: 24px;
|
||||
}
|
||||
@@ -0,0 +1,445 @@
|
||||
# Pipelines web client — visual system
|
||||
|
||||
Design-only deliverable. It does not change `web/src`, `web/styles.css`,
|
||||
`web/index.html`, any area stylesheet or any test. The reference implementation is
|
||||
`web/design/tokens/styleguide.html` + `styleguide.css`, built entirely from
|
||||
`tokens.css`.
|
||||
|
||||
Sources read for this refinement:
|
||||
|
||||
- `web/base.css`, `lists.css`, `run-detail.css`, `chat.css`, `graph.css`,
|
||||
`dialogs.css`, `settings.css` — the current palette, chip, radius and shadow
|
||||
vocabulary.
|
||||
- `web/design/layout/prototype.html`, `prototype.css`, `web/docs/layout-spec.md`
|
||||
— the target rail + list/detail shell and its 200px rail.
|
||||
- `android/.../ui/theme/Color.kt`, `Typography.kt`, `Dimens.kt`, `Theme.kt` —
|
||||
the app's dark identity, type intent and 4dp-derived spacing.
|
||||
- `android/.../ui/components/RunStatus.kt` — the app-owned status vocabulary.
|
||||
|
||||
The result keeps the app's dark canvas, mint accent and the web's current
|
||||
run-status hues. It is a refinement of hierarchy and reuse, not a new brand.
|
||||
|
||||
---
|
||||
|
||||
## 1. The layer model
|
||||
|
||||
One canvas, four surface steps, one scrim. Every component picks a layer from this
|
||||
table; no component invents a background.
|
||||
|
||||
| Layer | Token | Used by | Never |
|
||||
| --- | --- | --- | --- |
|
||||
| Canvas | `--color-bg` | Page, list/detail pane body, chat transcript, code body, artifact thumb base | A static card that also has a border and a shadow |
|
||||
| Base surface | `--color-surface` | Left rail, top bar, toolbar, card, detail section, composer shell, approval card, empty state | A row inside another card; use a tint instead |
|
||||
| Inset surface | `--color-surface-2` | Button/field fill, row fill when needed, chip body, inline code, code header, user bubble, sheet row, artifact tile | A card on top of a card; never `surface-2` on `surface-2` |
|
||||
| Elevated | `--color-elevated` | Menu, popover, dialog, sheet, toast, tool panel | A normal page card |
|
||||
| Highest | `--color-elevated-2` | Hover on an elevated control, gradient stop | A page background |
|
||||
| Scrim | `--color-scrim` | Behind a dialog, sheet or full-screen viewer | A content background |
|
||||
|
||||
Rules:
|
||||
|
||||
1. **One step per nesting level.** Pane (`bg`) → card (`surface`) → control
|
||||
(`surface-2`). Do not put another `surface` card inside a card; use padding,
|
||||
a divider or a tint.
|
||||
2. **A tint is not a layer.** Hover, pressed and selected are transparent washes
|
||||
(`--tint-*`) laid over the surface that is already there. They never replace a
|
||||
surface role.
|
||||
3. **Elevation means floating.** A shadow is reserved for menus, dialogs, sheets,
|
||||
toasts and the tool panel. A pane or card never casts one.
|
||||
4. **The transcript is the page.** The agent turn sits directly on `bg`; only the
|
||||
operator's bubble takes `surface-2`. This removes the current transcript →
|
||||
agent bubble → tool section → code block stack of four fills.
|
||||
|
||||
### Which surface for each named layer
|
||||
|
||||
| Area | Surface |
|
||||
| --- | --- |
|
||||
| App shell / page | `bg` |
|
||||
| Rail | `surface`, separated from the workspace by a `divider` edge |
|
||||
| List pane / detail pane | `bg`; the wide split uses a divider, not a card |
|
||||
| Top bar / connection banner | `surface` + bottom divider; banner states use `surface-2`, `tint-warn-soft`, `tint-bad-soft` |
|
||||
| List row | transparent on the pane; hover `tint-hover`; selected `tint-selected` + 2px accent inset |
|
||||
| Toolbar | `surface`; its controls `surface-2` with a `border` |
|
||||
| Card / detail section | `surface`, no border; sections separated by `space-section` |
|
||||
| Key/value table | on the card surface; use spacing or a divider, never a per-row box |
|
||||
| Code block | `bg` body, `surface-2` header, one outer `border` |
|
||||
| Dialog / sheet / menu | `elevated` + `border` + matching elevation + scrim where modal |
|
||||
| Chat user bubble | `surface-2` + `border` |
|
||||
| Chat agent turn | transparent on `bg`; code block is the only framed part |
|
||||
| Composer | `surface` shell + `border`; the textarea itself is transparent |
|
||||
| Approval card | `surface` + `border` + 3px warning inset; resources `bg`; risk `tint-warn-soft` |
|
||||
| Artifact tile | `surface-2` + `border`; media fills the tile; actions overlay it |
|
||||
| Empty state | `surface` + `space-l` padding; a sentence and at most one action |
|
||||
|
||||
---
|
||||
|
||||
## 2. Border or background?
|
||||
|
||||
Use **background** to group, **border** to identify a control, **divider** to
|
||||
separate content inside one surface.
|
||||
|
||||
| Need | Use | Do not use |
|
||||
| --- | --- | --- |
|
||||
| A card or section | A `surface` step and spacing | Border + radius + shadow on a static block |
|
||||
| A button, input, tile, selected row, dialog | `--color-border` (≥3:1 on all surfaces) | `--color-divider`, which is decorative and below 3:1 |
|
||||
| A separator between rows or sections | `--color-divider` (1px) | A border around each row |
|
||||
| A selected row | `tint-selected` + 2px inset accent bar + weight | A 1px accent border alone |
|
||||
| A focused control | The 2px focus ring with a 2px offset | Recolouring the border and calling it focus |
|
||||
| A destructive confirm | `--color-bad` text/edge + `tint-bad-soft` | A red-filled button for a secondary action |
|
||||
| A floating panel | `elevated` + `border` + one elevation | A border pretending to be a shadow |
|
||||
|
||||
Rules:
|
||||
|
||||
1. **A border is a control edge, not decoration.** `--color-border` is `#6a7874`
|
||||
so it stays above 3:1 on `bg`, `surface`, `surface-2` and `elevated`. The old
|
||||
`#2c3a36` border is now `--color-divider` and is only for non-interactive
|
||||
separation.
|
||||
2. **Never border, fill and shadow the same static box.** Pick the grouping
|
||||
mechanism: a surface step, a divider, or a floating elevation.
|
||||
3. **No border-only selection.** The selected row also changes weight and adds the
|
||||
accent bar; the `aria-current`/`aria-selected` state carries the semantics.
|
||||
4. **No accent border on hover.** Hover is a 5% wash. Accent is reserved for
|
||||
active, focus and the primary action. Today every `button:hover` turns its
|
||||
border mint, which makes ordinary hover look selected.
|
||||
5. **One border around a group.** A code card frames once; the header uses a
|
||||
divider, not a second border. A dialog frames once; its rows use a surface or
|
||||
spacing.
|
||||
|
||||
---
|
||||
|
||||
## 3. Chips and badges
|
||||
|
||||
There is one chip component.
|
||||
|
||||
```
|
||||
.chip
|
||||
glyph (aria-hidden, optional) + the status word
|
||||
height 22px · padding 1px 8px · radius pill · type-label 11/16 600
|
||||
neutral border (3:1) · status wash background · status-colour text
|
||||
```
|
||||
|
||||
Status mapping (the web's current status palette, unchanged):
|
||||
|
||||
The values below are copied byte-for-byte from the current `base.css` status
|
||||
rules. They are the web's tuned rendering of the app's status vocabulary; this
|
||||
item does not re-tune a single hue.
|
||||
|
||||
| Word | Token | Wash | Glyph |
|
||||
| --- | --- | --- | --- |
|
||||
| `queued` | `--status-queued` | `--status-queued-wash` | `◷` |
|
||||
| `running` | `--status-running` | `--status-running-wash` | `▶` |
|
||||
| `waiting` | `--status-waiting` | `--status-waiting-wash` | `…` |
|
||||
| `succeeded` | `--status-succeeded` | `--status-succeeded-wash` | `✓` |
|
||||
| `failed` | `--status-failed` | `--status-failed-wash` | `✕` |
|
||||
| `canceled` | `--status-canceled` | `--status-canceled-wash` | `⊘` |
|
||||
| `interrupted` | `--status-interrupted` | `--status-interrupted-wash` | `‖` |
|
||||
| `blocked` | `--status-blocked` | `--status-blocked-wash` | `■` |
|
||||
| `skipped` | `--status-skipped` | `--status-skipped-wash` | `»` |
|
||||
| `active` | `--status-active` | `--status-active-wash` | `◆` |
|
||||
| `unknown` | `--status-unknown` | `--status-unknown-wash` | `?` |
|
||||
|
||||
Rules:
|
||||
|
||||
1. **Never colour alone.** Every status chip carries its glyph and its word. The
|
||||
glyph may be `aria-hidden` because the word is present.
|
||||
2. **Use the server's vocabulary verbatim.** Status words stay lowercase; the
|
||||
uppercase role is the eyebrow/overline, never a status label.
|
||||
3. **One chip, tone modifiers only.** `chip--succeeded`, `chip--failed`, etc.
|
||||
change colour and wash; they do not change height, radius or type. Delete the
|
||||
parallel `.outcome-chip`, `.version-chip`, `.graph-type-chip` and
|
||||
`.verdict-ref` shapes.
|
||||
4. **A chip is a fact, not an action.** A chip is never a button and never nested
|
||||
inside another chip. If it opens something, use a row or a link.
|
||||
5. **Neutral is a tone for a non-status fact.** A version (`v5`) or a file kind
|
||||
(`PDF`) can use `chip--neutral`; it must not borrow `--status-unknown` and must
|
||||
not be used for a run state.
|
||||
6. **Counts are a count chip, not a status chip.** `chip--count` is a neutral
|
||||
pill with a minimum width, used for `12` or `Filter (2)`.
|
||||
7. **Badges are attached, not inline.** The attention count is a small filled
|
||||
bubble (`--color-bad` + `--color-on-bad`) with a number; the live badge is a
|
||||
dot plus the word `live`. Neither replaces a status chip.
|
||||
8. **One fact, one chip.** Do not show `failed` twice in a row (chip plus a
|
||||
coloured diagnostic line); the chip carries the state, the diagnostic carries
|
||||
the reason.
|
||||
|
||||
---
|
||||
|
||||
## 4. Spacing inside vs between
|
||||
|
||||
The layout scale is 8px with 4px half-steps. A separate 2px optical step exists
|
||||
only for aligning a glyph against a label; it is never a layout gap.
|
||||
|
||||
| Inside | Value |
|
||||
| --- | --- |
|
||||
| Icon/label gap | 4px |
|
||||
| Control padding (block × inline) | 4 × 12px |
|
||||
| Row padding, light (comfortable) | 12 × 12px |
|
||||
| Row padding, compact | 8 × 12px |
|
||||
| Card / panel padding | 16px |
|
||||
| Dialog padding | 16px |
|
||||
| Sheet padding | 12px vertical, 16px horizontal |
|
||||
| Code body padding | 12px |
|
||||
| Chip / count padding | 1 × 8px |
|
||||
|
||||
| Between | Value |
|
||||
| --- | --- |
|
||||
| Chips or toolbar controls | 8px |
|
||||
| Title and meta | 2–4px |
|
||||
| Lines in a block | 8px |
|
||||
| Block to block (card sections) | 16px |
|
||||
| Section to section | 24px |
|
||||
| Page / pane edge | 32px (24px narrow) |
|
||||
|
||||
Rules:
|
||||
|
||||
1. **One owner per gap.** Use `gap` on the container; do not add a margin to the
|
||||
last child and a gap on the parent.
|
||||
2. **Padding inside is smaller than space between.** If a card's padding equals
|
||||
the gap to the next card, the grouping reads as one block.
|
||||
3. **No nested padding beyond 24px.** Card 16 + panel 16 + row 12 is 44px of
|
||||
inset for a 14px label. Remove a layer or reduce to 16 + 8.
|
||||
4. **List separation is either a gap or a divider, never both.** The refined
|
||||
lists use a 2px gap and no row border; day headers use a divider.
|
||||
5. **Density changes geometry only.** Compact changes row block padding 12 → 8
|
||||
and control height 36 → 30. Type, line height and touch targets do not shrink.
|
||||
Touch surfaces (rail, dock, primary row actions) stay 44/48px.
|
||||
|
||||
---
|
||||
|
||||
## 5. Type roles
|
||||
|
||||
| Role | Size / line | Weight | Use |
|
||||
| --- | --- | --- | --- |
|
||||
| `--type-eyebrow` | 11 / 14 | 600 | Overline (`WORKSPACE`, `SECTIONS`, `RISK REVIEW`); tracking 0.06em, uppercase |
|
||||
| `--type-label` | 11 / 16 | 600 | Chip and badge labels |
|
||||
| `--type-meta` | 12 / 16 | 400 | Meta lines, key labels, captions, helper text |
|
||||
| `--type-body-small` | 13 / 18 | 400 | Dialog copy, empty-state copy, dense prose |
|
||||
| `--type-body` | 14 / 20 | 400 | Default body, row titles (add 600), toolbar labels |
|
||||
| `--type-title-small` | 16 / 22 | 600 | Card title, dialog/sheet title, approval headline |
|
||||
| `--type-title` | 20 / 26 | 600 | Screen title (`Pipelines`, `Runs`) |
|
||||
| `--type-display` | 24 / 30 | 600 | The app's largest title; rare |
|
||||
| `--type-code` | 12 / 18 | 400 mono | Commands, diffs, code blocks |
|
||||
| `--type-code-small` | 11 / 16 | 400 mono | Inline code, hashes, timestamps in tables |
|
||||
|
||||
Rules:
|
||||
|
||||
1. **Roles, not sizes.** No `font-size` literal in an area stylesheet. The current
|
||||
CSS has ten distinct sizes (10, 11, 12, 12.5, 13, 14, 15, 16, 18, 20) plus a
|
||||
40px viewer glyph; collapse to the seven sizes above.
|
||||
2. **Three weights.** 400, 500, 600. Do not introduce 650/700; the app is
|
||||
semibold-led, not bold-led.
|
||||
3. **Sentence case for actions and titles.** Uppercase is only the eyebrow /
|
||||
overline role. Status words stay lowercase.
|
||||
4. **Tabular numbers** for timestamps, durations, counts and IDs:
|
||||
`font-variant-numeric: tabular-nums`.
|
||||
5. **Mono is for data, not emphasis.** Hashes, paths, commands, code and IDs in a
|
||||
table. A pipeline name or a status word is never mono.
|
||||
6. **Measure.** Prose is capped at `--layout-measure` (72ch); a chat bubble at
|
||||
`--layout-chat-measure` (560px).
|
||||
|
||||
---
|
||||
|
||||
## 6. State, focus and motion
|
||||
|
||||
### Focus
|
||||
|
||||
- One ring: `outline: 2px solid var(--color-focus)` with `outline-offset: 2px`.
|
||||
`--color-focus` is `#a9f0dd`, 13.2:1 on `surface` and 11:1 on `elevated`.
|
||||
- Use `:focus-visible`; do not show the ring on a mouse click.
|
||||
- A filled accent button uses the halo (`--focus-halo`) so the ring sits on the
|
||||
page, not on the mint fill.
|
||||
- A composite field (search wrapper, composer shell) uses `:focus-within` and
|
||||
removes the inner input outline.
|
||||
- Never `outline: none` without a replacement. Today `.decision-feedback:focus`,
|
||||
`.template-create-name:focus` and `.rename-input:focus` only recolour the
|
||||
border; `.timeline-row:focus-visible` explicitly removes the outline.
|
||||
- An invalid field keeps the focus ring and uses the bad colour for the message
|
||||
and border, not for the ring.
|
||||
|
||||
### Interaction states
|
||||
|
||||
| State | Treatment | Structural cue |
|
||||
| --- | --- | --- |
|
||||
| Hover | `--tint-hover` (5%) | none needed |
|
||||
| Pressed | `--tint-pressed` (9%) | none needed |
|
||||
| Selected | `--tint-selected` (12%) | 2px inset accent bar + 600 weight |
|
||||
| Active / current | `--tint-selected` + accent bar | `aria-current` / `aria-selected` |
|
||||
| Disabled | `--opacity-disabled` (0.5) | `disabled` / `aria-disabled` |
|
||||
|
||||
Selection is never colour alone: the bar and the weight are the non-colour cue.
|
||||
|
||||
### Motion
|
||||
|
||||
- `--motion-fast` 120ms for hover/press, `--motion-base` 180ms for selection and
|
||||
expansion, `--motion-slow` 240ms for dialog/sheet entry, `--motion-spin` 800ms
|
||||
for an indeterminate spinner.
|
||||
- Standard easing `cubic-bezier(0.2, 0, 0, 1)`.
|
||||
- Under `prefers-reduced-motion: reduce`, transitions and animations collapse to
|
||||
an immediate state, scroll behaviour becomes `auto`, and no selected or focus
|
||||
state is removed. The styleguide implements this globally.
|
||||
|
||||
---
|
||||
|
||||
## 7. What to remove from today's CSS
|
||||
|
||||
### 7.1 Nested boxes
|
||||
|
||||
Remove the second and third frame in each chain:
|
||||
|
||||
- `base.css` — `.list` / `.detail` (border + radius) wraps `.row` (bottom border)
|
||||
and `.step` (border + radius), and `.artifact-tile` adds another border and
|
||||
radius. A run detail is three borders deep.
|
||||
- `run-detail.css` — `.verdict` and `.field-block` frame content inside
|
||||
`.stage-pane-sheet`; `.change-hunk` frames a diff inside `.change-viewer`.
|
||||
- `chat.css` — `.chat-transcript` (border) → `.chat-bubble` (border) → optional
|
||||
`.chat-tool-section` (border) → `.chat-tool-section-body` (bg). The approval
|
||||
card is `.chat-approval` (border) → `.chat-approval-resources` (border) →
|
||||
`.chat-approval-risk` (wash). That is three nested boxes for one decision.
|
||||
- `dialogs.css` — `.attention-sheet-panel` → `.attention-row` → the inner
|
||||
`.attention-row-open`; `.decision-sheet-panel` → `.decision-option`.
|
||||
- `settings.css` — each `.settings-status`, `.settings-warning`,
|
||||
`.settings-notify-state` and `.settings-card` is its own bordered box inside the
|
||||
section.
|
||||
|
||||
Replace with: one pane surface, one card surface, spacing, and a divider where a
|
||||
boundary is genuinely needed.
|
||||
|
||||
### 7.2 Duplicate chip styles
|
||||
|
||||
There are at least six parallel chip shapes:
|
||||
|
||||
| Selector | File | Problem |
|
||||
| --- | --- | --- |
|
||||
| `.chip` + `.chip-*` | `base.css` | The canonical shape, 11px pill |
|
||||
| `.outcome-chip` + `.outcome-*` | `run-detail.css` | Second pill, `currentColor` border |
|
||||
| `.verdict-ref` | `run-detail.css` | Third pill, 11px |
|
||||
| `.version-chip` | `lists.css` | Fourth pill, surface fill |
|
||||
| `.graph-type-chip` | `graph.css` | Fifth pill, 11px |
|
||||
| `.graph-edge-label` | `graph.css` | Sixth pill-shaped label |
|
||||
| `.attention-badge` | `dialogs.css` | A badge, correctly distinct; keep but tokenise |
|
||||
|
||||
Delete the five chip duplicates. Keep one `.chip`, one `.chip--count`, and the
|
||||
attention badge as a badge. The graph edge label is a label, not a status chip:
|
||||
style it with `type-code-small` and no status tone.
|
||||
|
||||
### 7.3 Inconsistent radii and heights
|
||||
|
||||
- Radii in the current files: 0, 2px, 4px, 6px, 8px, 10px, 12px, 14px, 50%,
|
||||
999px. Collapse to `4 / 6 / 8 / 12 / 16 / pill`; use 50% only for a dot or a
|
||||
circular poster.
|
||||
- Control heights: about 22px (artifact action), 30px (approval control), 32px
|
||||
(toolbar/tool), 36px (inputs), 40px (chat send), 44px (rail/strip), 48px (dock).
|
||||
Standardise on **30px compact**, **36px comfortable**, **44/48px touch**.
|
||||
- `.chat-send` and `.chat-stop` are 16px glyph buttons with 8px 12px padding while
|
||||
`.chat-composer-input` is 20px line-height; they do not align. Put both on the
|
||||
same 36px row.
|
||||
- `.artifact-action` at 22px is below the 24px minimum for a secondary target;
|
||||
use 30px or move the actions into a menu.
|
||||
|
||||
### 7.4 Raw colour, alpha and shadow duplication
|
||||
|
||||
- Status hexes are repeated in `base.css` (`.chip-*`), `lists.css`
|
||||
(`.metric-*`), `run-detail.css` (`.outcome-*`), `dialogs.css`
|
||||
(`.decision-card`, `.decision-open`) and `graph.css` (`.chip-unknown`). One
|
||||
`--status-*` token per state.
|
||||
- Banner and decision hexes `#2c1616`, `#12251b`, `#2a2410`, `#102329` are
|
||||
one-off colours. Use `tint-bad-soft`, `tint-ok-soft`, `tint-warn-soft` and
|
||||
`tint-info-soft`.
|
||||
- Floating shadows have six recipes (`0 10px 30px`, `0 12px 32px`,
|
||||
`0 16px 40px`, `0 20px 60px`, `0 -12px 40px`, `-12px 0 40px`). Use
|
||||
`--elevation-2` / `--elevation-3` / `--elevation-sheet`.
|
||||
- Inline `rgba(...)` tints (`rgba(127, 209, 187, 0.12)`, `rgba(0, 0, 0, 0.45)`)
|
||||
become `--tint-*` and `--color-scrim`.
|
||||
|
||||
### 7.5 Focus and hover
|
||||
|
||||
- Add a base `:focus-visible` rule; today `base.css` has none, so buttons and
|
||||
inputs rely on the browser default.
|
||||
- Remove `outline: none` from `.timeline-row:focus-visible`,
|
||||
`.decision-feedback:focus`, `.template-create-name:focus` and
|
||||
`.rename-input:focus`.
|
||||
- Stop using `border-color: var(--accent)` as the only hover signal on every
|
||||
button, card, tile and menu item. Hover = tint; accent = active/focus/primary.
|
||||
- Unify the four focus offsets (`1px`, `-2px`, `-1px`, `2px`) to the token.
|
||||
|
||||
### 7.6 Disabled and opacity
|
||||
|
||||
The files use `opacity: 0.4`, `0.45`, `0.5`, `0.55`, `0.6` and `0.8` for
|
||||
disabled, unavailable and closed states. Use `--opacity-disabled: 0.5` for a
|
||||
disabled control; do not fade a whole card to hide it.
|
||||
|
||||
---
|
||||
|
||||
## 8. The six biggest before/after improvements
|
||||
|
||||
| # | Before | After |
|
||||
| --- | --- | --- |
|
||||
| 1 | **Boxes inside boxes.** A run row is a bordered `.row` inside a bordered `.list`; a chat decision is three nested fills/borders; a settings section has a card per block. | One pane surface, one card, spacing and dividers. A row is a control on the pane; only a floating surface has elevation. |
|
||||
| 2 | **Six chip dialects.** `.chip`, `.outcome-chip`, `.verdict-ref`, `.version-chip`, `.graph-type-chip`, `.graph-edge-label` each set their own height, radius and type. | One `.chip` with tone modifiers, a count chip and one attention badge. Every status carries a glyph and its word. |
|
||||
| 3 | **Every control invents a height.** 22–48px buttons, fields, tiles and composer actions do not line up across a toolbar. | 30px compact / 36px comfortable / 44–48px touch, one control radius, one icon size. Toolbars and the composer align on one baseline. |
|
||||
| 4 | **Accent borders on hover.** Every button, tile and card turns mint on hover, making hover look focused and selection look ordinary. | Hover is a 5% wash. Accent is reserved for active, focus and the primary action; selection adds a 2px bar and weight. |
|
||||
| 5 | **Ten ad-hoc type sizes.** 10, 11, 12, 12.5, 13, 14, 15, 16, 18, 20px with three near-identical section headers. | Seven sizes across eight roles plus two mono roles: 11 / 12 / 13 / 14 / 16 / 20 / 24 with fixed line heights and 400/500/600 weights. |
|
||||
| 6 | **Focus is a border colour, when it exists at all.** Some inputs remove the outline; a focused timeline row is indistinguishable from hover; `base.css` has no focus rule. | One 2px `#a9f0dd` ring with a 2px offset on every focusable control, `:focus-within` on composite fields, and a halo on filled accent buttons. |
|
||||
|
||||
These six are ordered for migration: each one is independently shippable and each
|
||||
removes more CSS than it adds once the old selectors are deleted.
|
||||
|
||||
---
|
||||
|
||||
## 9. Adopt it without a redesign
|
||||
|
||||
1. **Add `tokens.css` first.** It is custom properties only; linking it changes
|
||||
nothing until a rule consumes a token. The `--bg`, `--surface`, `--border`
|
||||
aliases at the bottom of the file let the existing stylesheets keep working
|
||||
while they migrate one rule at a time.
|
||||
2. **Collapse one area at a time.** Start with `lists.css` (rows, toolbar,
|
||||
filter menu) because it owns the clearest box-in-box chain. Then
|
||||
`run-detail.css`, then `chat.css`, then `settings.css`.
|
||||
3. **Delete duplicate chips in the same change that introduces the unified one.**
|
||||
Do not leave both `.chip` and `.outcome-chip` shipping.
|
||||
4. **Move focus to the base layer.** Add the focus rule and remove the
|
||||
`outline: none` exceptions before touching colour, so keyboard users never
|
||||
regress.
|
||||
5. **Keep the app's words and status colours.** This system changes surfaces,
|
||||
spacing and shape; it does not rename a run state or invent a new outcome hue.
|
||||
|
||||
---
|
||||
|
||||
## 10. Captures and verification
|
||||
|
||||
Capture command (no server, no build step):
|
||||
|
||||
```sh
|
||||
node web/design/tokens/capture.mjs
|
||||
```
|
||||
|
||||
Captured at **1440 × 900** through the repository's read-only
|
||||
`web/test/browser.mjs` driver at device scale 1:
|
||||
|
||||
- `web/design/tokens/captures/styleguide-01-foundations-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-02-type-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-03-space-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-04-rail-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-05-lists-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-06-data-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-07-overlays-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-08-conversation-1440x900.png`
|
||||
- `web/design/tokens/captures/styleguide-09-content-1440x900.png`
|
||||
|
||||
The captures are review evidence and are covered by the repository's root
|
||||
`captures/` ignore rule, like the layout captures.
|
||||
|
||||
Contrast was checked against the defined surfaces:
|
||||
|
||||
| Pair | Ratio |
|
||||
| --- | --- |
|
||||
| `--color-text` / `--color-bg` | 14.35:1 |
|
||||
| `--color-text` / `--color-surface` | 13.29:1 |
|
||||
| `--color-muted` / `--color-surface` | 8.47:1 |
|
||||
| `--color-border` / `--color-surface` | 3.71:1 |
|
||||
| `--color-border` / `--color-elevated` | 3.09:1 |
|
||||
| `--color-focus` / `--color-surface` | 13.21:1 |
|
||||
| lowest status text / its chip wash (canceled) | 4.75:1 |
|
||||
|
||||
No production app stylesheet, view, markup or test was changed. The production
|
||||
page still renders from the current area stylesheets; this is the target system
|
||||
and its evidence, not a live restyle.
|
||||
Reference in New Issue
Block a user