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.
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-scrimblack 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-eyebrowWorkspace11 / 14 · 600 · 0.06em
--type-labelv511 / 16 · 600
--type-metaid 24 · v5 · 6 stages12 / 16 · 400
--type-body-smallThis asks the server to stop the active run.13 / 18 · 400
--type-bodyPlan and land14 / 20 · 400
--type-title-smallWaiting for your decision16 / 22 · 600
--type-titlePipelines20 / 26 · 600
--type-displayVisual system24 / 30 · 600
--type-codesha256:9f2c41e8a712 / 18 · mono
--type-code-smallrun 458 · 12m11 / 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-3xs2px
--space-2xs4px
--space-xs8px
--space-s12px
--space-m16px
--space-l24px
--space-xl32px
--space-2xl40px
--space-3xl48px
--space-4xl64px
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
Rail
04 / 09
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.
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 densityrow 12px block
Compactrow 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.
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?
Cancel run 458?
This asks the server to stop the active run.
Bottom sheet
Needs you
Needs you
✕failedServerServer · failed · needs you
…waitingNightly auditNightly audit · waiting for your decision
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.
RISK REVIEWThis 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.