DESIGN SYSTEM & STYLE GUIDE

theme: DARK LUXE MINIMAL · v3.0 · canonical doc: docs/design-system.md · tokens: tailwind.config.ts + globals.css

1 · brand tokens — the core sixtwo accents, strictly
primary — muted sage · action · positive · live
#5E8F73
Primary
--tx-green · primary-500
#9ABCA6
Light
--tx-green-light · primary-300
#4A735C
Border
--tx-green-border · primary-600
accent — champagne · info · data · links
#BE9E57
Primary
--tx-blue · accent-500
#DEC48E
Light
--tx-blue-light · accent-300
#A2823F
Border
--tx-blue-border · accent-600
emerald / teal / primary — sage family
50
100
200
300
400
500
600
700
800
900
950
cyan / accent — champagne family
50
100
200
300
400
500
600
700
800
900
950
sky — warm sand (entity chips)
300
400
500
600
700
blue — muted slate-blue (entity chips)
300
400
500
600
700
2 · surfaces & text hierarchyink neutrals · slate text
ink surfaces
ink-950#09090apage background
ink-900#101012panels / cards
ink-850#151517dividers
ink-800#1a1a1dnested cards
ink-700#232326panel borders
ink-600#2e2e33idle controls
ink-500#45454chover borders
slate text scale
slate-100 — hero numbers, emphasis
slate-200 — input text, active items
slate-300 — body copy (default)
slate-400 — secondary copy
slate-500 — labels, idle tabs
slate-600 — axis ticks, disabled
green value textblue value textwarndanger
3 · typography — terminal stacksans = mono = terminal
"Berkeley Mono", "JetBrains Mono", "Cascadia Code", "Fira Code", "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace
type scale
PAGE TITLE · 18PX TRACK .2EM
.ptitle — panel header · 11px
1,284,502.44
Body — 11–12px sentence-case prose for copy and explanations.
.k — micro label · 10px uppercase
micro — 9px, chart ticks & count badges only
number discipline — tabular-nums
blk  2,481,009  +34,120
blk  2,481,010   +8,441
blk  2,481,011  +12,902
address / endpoint
0x84f0...c21b · /api/mcp/verify
live readout — .term-caret
LISTENING · mempool feed
4 · component catalogglobals.css · @layer components
kpi tile
+42.7%
blue metric
1,024
neutral metric
98.2
SAFE · 92RH · LIVECAUTIONBLOCKEDidle
.scanlines — hero panels only
shadow-glow-green
shadow-glow-blue

focus ring (Tab to any control): 2px rgba(52,211,153,.65) · selection: green 35% · motion ≤220ms ease-out, transform/opacity only, all disabled under prefers-reduced-motion.

5 · semantic verdicts & data-vizcolor is meaning
shield verdicts / status
✓ SAFE #9ABCA6⚠ CAUTION #FBBF24HIGH_RISK #FB923C✕ BLOCKED #F87171
chart series
inflow / up #9ABCA6outflow #DEC48Edown #F87171grid #1B2635 · axis #3B4D68
chain pills — CHAIN_COLOR
RH #dec48eARC #a79bc4SOL #9abca6BASE #93a3b8BNB #c2a15cHYPE #e3cfa0

Same hexes ship in OG images (public/og), Discord embeds (src/lib/relay/embeds.ts) and the AppKit wallet theme (--w3m-accent: #5e8f73). One palette, every surface.

6 · do / don't
DO
  • Take every color from this page / docs/design-system.md
  • Green = action & positive · blue = info & data
  • tabular-nums on all numbers, uppercase + tracking on labels
  • Accent borders at 30–50% opacity on ink surfaces
DON'T
  • No new hues outside the semantic set; no old cyan (#22d3ee)
  • No glassmorphism / blur fog; flat ink panels only
  • No recoloring verdicts (SAFE green, BLOCKED red — always)
  • No proportional fonts — terminal means mono
7 · mobile-first contractsmall screens decide, desks inherit

Every row below is rendered from src/lib/ui/mobile.ts — the same module that gates the shell, the hooks and INV-34 in the eval harness. Nothing on this page is re-typed, so the contract cannot drift from the product. Written reference: docs/mobile-first.md.

breakpoints — Tailwind defaults, mirrored
below-sm(max-width: 639.98px)
above-sm(min-width: 640px)
below-md(max-width: 767.98px)
above-md(min-width: 768px)
below-lg(max-width: 1023.98px)
above-lg(min-width: 1024px)
below-xl(max-width: 1279.98px)
above-xl(min-width: 1280px)
sm 640 · md 768 · lg 1024 · xl 1280 — a utility class and a runtime query can never mean different things.
floors — touch, type, inputs
touch target (any control)≥ 44px
comfortable · thumb zone48px
bottom-nav destinations56px
pointer floor (desktop rail)32px
phone body type11px
micro type (ticks, badges)10px
input font (iOS no-zoom)16px
cadence — the read plane slows down on a phone and stops when hidden
/api/chain poll · desktop → mobile → save-data15s → 20s → 60s
engine tick · desktop → mobile → low-end2.5s → 4s → 6s
hidden documentstopped (null interval)
wallet stack · idle → then first intent3.5s (≤ 8s)
first-load JS budget · phone route≤ 200 kB
LCP / INP / CLS2.5s / 200ms / 0.1
wallet stack before deferral−540 kB
deferred surfaces · estimated saving8 · ~730 kB
surface registry — every mobile opinion, stated once (25 rows)
surfacestrategybandloadsave-datatargetest kBnote
shell.rootreflowallinlineallow——Mobile-first base: `viewport-fit=cover` so safe-area insets resolve, `min-h-dvh` so the mobile URL bar cannot clip the bottom bar, gutters `px-3 md:px-5`, content column pads itself for the bottom tabs (never for a hidden desktop bar).
shell.topbarreflowallinlineallow44px—Phone first: hamburger, wordmark, search door, Copilot, wallet — 44px controls, safe-area top padding. Chain pills arrive at `md:`, the CA chip at `xl:`, and the Shield tier is never lost: it also lives in the drawer.
shell.bottom-tabsreflowbelow-lginlineallow56px—One-thumb journey: Home · Screener · Copilot FAB · Signals · Menu. 56px targets, `env(safe-area-inset-bottom)` padding, opaque surface on phones (a blurred fixed bar is a per-frame GPU cost on a mid-range Android).
shell.nav-drawersheetbelow-lginlineallow52px—Slide-in from the left, journey-grouped (Discover → Research → Act → Pro), 52px rows, body scroll locked, safe-area padded.
shell.side-navmedia-gateabove-lginlineallow40px—Never mounted on a phone: a fixed rail plus its collapse state is dead weight in the thumb-sized layout.
shell.status-barmedia-gateabove-lginlineallow——Desktop only. It was previously mounted-but-hidden on phones, which meant a setState every second re-rendering a strip nobody could see — and it now also stops ticking while the tab is hidden.
shell.chain-stripmedia-gatebelow-lginlineallow44px—Phone/tablet read plane: 2 columns of chain health, tap to open that chain's screener. Desktop reads the same truth from the top-bar pills.
shell.command-palettelazyalluser-openallow56px34The registry/signals/entities indexes behind it ship in their own chunk. A ~40B bus module keeps the door open for every caller, and the modal is fetched on the first ⌘K or tap. On a phone it opens as a full-height sheet with 56px rows.
shell.copilotlazyalluser-openallow44px42IntentGraph compiler + policy transcript + ticket panel — the heaviest interactive surface in the app and useless until asked for. The desktop command bar stays inline (it is one button); the modal is a chunk.
shell.toaststaticallinlineallow——Sits above the bottom tabs (`bottom-24` below lg, `bottom-16` above) so a confirmation never lands under a thumb.
shell.modalsheetallinlineallow44px—Below sm: anchored to the bottom edge, `max-h-[88dvh]`, scroll-locked, safe-area padded, drag handle. From sm: up: the centred dialog. Escape and backdrop close both.
shell.consentsheetallinlineallow44px—Shown only to EEA/UK/CH time zones with no stored choice, or on "cookie preferences". A card, not a wall: it floats above the bottom tabs and the raised Copilot button (`bottom: safe-area + 5.75rem`), moves bottom-right from lg:, and sits at z-[45] so modals, drawers and toasts stay on top. If a page overflows horizontally (the phone then lays out wider than the screen and every fixed-bottom box drops below the fold), it anchors itself to the visual viewport instead. Reject and Accept carry equal weight; every control is 44px. GTM itself loads after hydration and is not a UI surface.
board.smart-moneyprogressive-columnsallinlineallow48px—Phone: one identity cell carrying symbol, price, 24h change, desk net-flow bar and Shield score — the row *is* the summary card. Columns return at `md:` and the table gains its 860px floor only there, so a phone never scrolls sideways.
board.screener-matrixprogressive-columnsallon-approachinteraction-only44px56The heaviest board and the last one on the home page: deferred to its own chunk on `/` and eager on `/screener`, where it *is* the page. Phone keeps identity, price/24h and the Shield verdict; the other ten columns are `md:`/`lg:`. Header sorting is a desktop affordance, so phones get an explicit sort control instead of a hidden target. Carries the launchpad rail.
board.alpha-feedreflowallinlineallow44px—The ranked column is the mobile protagonist: it moves above the 8-column board in the home page's source order and keeps its sparkline + SFS bar, with reason-code chips wrapping under the row.
board.kpi-tilesreflowallinlineallow——2×2 grid below lg, 4-across above. Values stay tabular so the live tick cannot make them jump.
board.meme-radarlazyallon-approachinteraction-only44px52Below-the-fold intelligence panel that polls `/api/fomo`: fetched when the reader approaches (one flick of lead time), not prefetched on a metered link. Carries the agent console.
board.launchpad-marqueelazyallon-approachskip44px—A forever-drifting rail inside the screener board, so it rides that chunk. The drift stops on hover/focus/touch, when the rail is off-screen (IntersectionObserver) and when the document is hidden; the 2-minute refresh and the browser-direct CoinGecko fallback are both skipped under Save-Data. Its card avatars are the app's only raw `<img>` (already `loading=lazy`).
board.holder-cost-basislazyallon-approachinteraction-only44px6A live top-holder read, never above the fold on a phone: fetched on approach so the RPC work leaves the first paint, and the placeholder reserves its height so the page cannot jump when it lands.
board.x-trackersreflowallinlineallow44px—Already responsive by construction: `grid-cols-[auto_1fr]` rows on phones reflow to the five-column settlement grid at `md:`, and the chain/venue summary stacks at 2-up.
board.app-monitorlazyallon-approachskip44px—The MemeRadar agent tab: it can only arrive with that board, so it rides that chunk. Its 8s `/api/agent` + `/api/brain` poll and its 1 Hz countdown clock run only while the document is visible and refresh on return.
wallet.stacklazyallidleinteraction-only44px540The single biggest win on a phone: AppKit + wagmi + viem + the connector tree were in the shared bundle of *every* route (~580 KB of the 688 KB First Load JS on /). The terminal now paints, and the wallet stack loads on idle — skipping to first-interaction on Save-Data, 2G/3G or a ≤4-core device. Tapping Connect Wallet before that mounts it immediately and opens the modal.
onchain.snapshot-pollstaticallinlineallow——10s on the desk, 20s on a phone, 60s on Save-Data — and never while the document is hidden. Returns immediately on visibility, so coming back to the tab shows live data without waiting out a timer.
engine.live-tickstaticallinlineallow——2.5s on the desk, 4s on a phone, 6s on low-end/Save-Data, paused when hidden. Each tick re-renders every board row, so the interval *is* a mobile frame-budget decision — and the update is wrapped in a transition so a tap always wins over a repaint.
docs.styleguidestaticallinlineallow——Renders the surface registry above the fold so the contract is inspectable in the running app, not only in the harness.