Design deliverable

Visual system

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.

Contrast body ≥ 4.5:1 · UI edge ≥ 3:1 Focus 2px ring, 2px offset Motion 80 / 120 / 180 / 240 ms Grid 8px with 4px half-steps

Foundations

01 / 09

Colour is assigned by layer, not by file. The page is bg; a pane or card is surface; a control, row or code body is surface-2; anything that floats is elevated. Borders mark interactive edges. Dividers separate content inside one surface.

Canvas and surface layers

--color-bg #0e1513
--color-surface #161d1b
--color-surface-2 #1a211f
--color-elevated #252c2a
--color-elevated-2 #2f3634
--color-scrim black 58%

Text, lines and focus

--color-text #dee4e1
--color-muted #a9bab5
--color-faint #8b9b96
--color-divider #2c3a36
--color-border #6a7874
--color-border-strong #889391
--color-focus #a9f0dd

Accent and outcome

--color-accent #7fd1bb
--color-accent-strong #a3e4d3
--color-ok #6bd39a
--color-warn #e6c268
--color-bad #ef8a8a

Type

02 / 09

Eight sans roles and two mono roles. A screen title is title; a section header is title-small; a row name is body at semibold; meta is meta. Nothing picks a size directly.

--type-eyebrow Workspace 11 / 14 · 600 · 0.06em
--type-label v5 11 / 16 · 600
--type-meta id 24 · v5 · 6 stages 12 / 16 · 400
--type-body-small This asks the server to stop the active run. 13 / 18 · 400
--type-body Plan and land 14 / 20 · 400
--type-title-small Waiting for your decision 16 / 22 · 600
--type-title Pipelines 20 / 26 · 600
--type-display Visual system 24 / 30 · 600
--type-code sha256:9f2c41e8a7 12 / 18 · mono
--type-code-small run 458 · 12m 11 / 16 · mono

Space and depth

03 / 09

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.

Spacing scale

8px grid · 4px half-steps
--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

Radii

one family, five roles
--radius-xs
--radius-s
--radius-control
--radius-card
--radius-sheet
--radius-pill

Elevation

floating surfaces only
--elevation-1
menu item, sticky edge
--elevation-2
menu, toast
--elevation-3
dialog

Lists and toolbar

05 / 09

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.

Toolbar

filter · sort · search · live
live

Rows

default · hover · selected

Density

light · compact
Light density row 12px block
Compact row 8px block

Key/value and code

06 / 09

Facts use one two-column table with the label in meta and the value in body-small; 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.

Key/value table

Summary
Content hash
sha256:9f2c41e8a7
Started
19 Oct 2026 14:20
Finished
19 Oct 2026 14:32
Duration
12m

Monospace code

one frame, one label
Shell
node serve.mjs --port 8095 --pipelines 127.0.0.1:8080
# http://127.0.0.1:8095/

PIPELINES_WS_URL=ws://127.0.0.1:8095/connect node test/smoke.mjs

Dialog and sheet

07 / 09

Anything above the page uses elevated, 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.

Confirm dialog

Cancel run 458?

Bottom sheet

Needs you

Conversation

08 / 09

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.

Show me why run 458 needed the decision, and what changed in the last stage.
Agent

Run 458 waited on the review stage. The landing step then completed and recorded four artifacts.

  • Review requested a decision on the land stage.
  • The decision was recorded, then the run finished.
  • Four files changed in the last stage.
bash
git diff --stat HEAD~1
 4 files changed, 86 insertions(+), 21 deletions(-)
Approve bash Waiting for your response
docker build -t pipelines:dev .
RISK REVIEW This writes an image tagged pipelines:dev on this machine.

Artifacts and empty

09 / 09

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.

Artifact tiles

image · video · PDF · JSON
land.webm
PDF session.pdf 1.2 MiB
JSON report.json 18.4 KiB

Empty state

sentence plus one way out

No runs match the current filters.

Run-status chip row

web status palette · unchanged
queued running waiting succeeded failed canceled interrupted blocked skipped active unknown