/ Design systemv0.2 draftBack to landing
Design system

The app and auth surfaces.

Primitives for the app, login and signup. The landing page has its own night-sky world; see DESIGN.md. Everything here renders from the tokens in app/globals.css, so this page is always current.

Principles

Day by default, night for evidence

Warm neutral pages. Dark panels are reserved for product shots and code: the moments where we show real data.

One accent

Violet means “you can act here”. It never encodes data, so it never competes with a chart.

Colour carries meaning

Series colours = what kind of time. Status colours = what state. Status always ships with an icon and a word.

Show provenance

Every step says where it came from. Recorded sources are solid tags; inferred steps are dashed. We never dress a guess as a fact.

Colour: day surface

Default for every page.

canvas
Page background
surface
Cards, raised
sunken
Wells, hover
line
Hairlines
line-strong
Hover borders
Aa
ink
Primary text, 16.9:1
Aa
ink-2
Secondary text, 7.6:1
Aa
ink-3
Tertiary text, 5.0:1
Aa
brand
Actions, links, 5.8:1
brand-strong
Hover / pressed
brand-soft
Icon tiles, selected

Colour: night surface

Dark panels only: hero product shot, code, CTA band.

night
Panel background
night-2
Raised in panel
night-line
Hairlines
Aa
night-ink
Primary text
Aa
night-ink-2
Secondary text
Aa
night-ink-3
Tertiary, 5.5:1
brand-night
Brand marks
Aa
brand-night-text
Links, 9.0:1

Colour: data series

Validated dataviz palette. Each has a night variant tuned for the dark panel. Used for bars, lines, timeline dots.

series-1 / series-1-night
Receive, queue wait
series-2 / series-2-night
Send, producer
series-3 / series-3-night
Handler, consumer

Colour: status

Reserved for state. Always icon + label; never colour alone.

Deleted / healthy
good, -text, -soft, -ring, -night
Retrying / backlog
warning, -text, -soft, -ring, -night
Stuck / filtered
serious, -text, -soft, -ring, -night
Dead-lettered / failing
critical, -text, -soft, -ring, -night

Type

Two families. Newsreader for headlines, prose and UI; IBM Plex Mono only for IDs, timings, sources and code. Headlines stay regular weight; medium for UI labels and card headings.

display
60 / 1.02, −2%, serif
Know what happened
display-sm
48 / 1.04, mobile hero
Every message
title
36 / 1.1, section heading
Set up in an afternoon.
title-sm
30 / 1.15, mobile section
Observing never changes it.
heading
20 / 1.35, medium, card heading
Where did this message go?
lead
20 / 1.6, intro paragraph
Look up any SQS message and see its whole life.
body
17 / 1.6
Every receive is recorded with its receive count.
small
15 / 1.45, UI, nav, buttons
Sign in, Start free, Docs
xs
13 / 1.45, serif metadata
Updated 4s ago, Admins only
caption
12 / 1.4, mono IDs, times
billing-webhooks.fifo, 14:41:07.212
micro
11, mono, source tags
CloudTrail

Buttons

One primary per view. Two sizes: sm (32px, nav) and md (40px, content).

Day
Night

Badges & source tags

Badges label state. Source tags label provenance: solid = recorded, dashed = inferred by Trailbeam.

Dayneutraloutlinebrandgoodwarningseriouscriticallive
SourcesOTelTrailbeam pkgCloudTrailinferred
Nightneutralbrandgoodwarningseriouscritical
SourcesOTelTrailbeam pkgCloudTrailinferred

Surfaces & icon tiles

Radius: control 8, card 12, panel 16. Shadows are soft and warm; borders do most of the work.

Card with a brand tile

rounded-card, border-line, shadow-card. Features.

Neutral tile

Round, outlined. Steps in a sequence.

Good tile

Trust and safety statements only.

shadow-card
Cards
shadow-raised
Popovers, menus
shadow-panel
Hero shot, code

Night window

The product frame. glow = brand-tinted 1px edge, used once per page (hero).

9f3c2a71…a6c9
Dead-letteredbilling-webhooks.fifo
Received by billing-syncTrailbeam pkg
Handler timed outTrailbeam pkg
Moved to DLQinferred
handler.pyPython
# code-comment
import trailbeam
trailbeam.init(tenant_from="body.customerId")

Motif: trace grid

32px graph paper behind the hero, masked to fade out.