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", monospacetype 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)
| surface | strategy | band | load | save-data | target | est kB | note |
|---|---|---|---|---|---|---|---|
| shell.root | reflow | all | inline | allow | — | — | 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.topbar | reflow | all | inline | allow | 44px | — | 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-tabs | reflow | below-lg | inline | allow | 56px | — | 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-drawer | sheet | below-lg | inline | allow | 52px | — | Slide-in from the left, journey-grouped (Discover → Research → Act → Pro), 52px rows, body scroll locked, safe-area padded. |
| shell.side-nav | media-gate | above-lg | inline | allow | 40px | — | Never mounted on a phone: a fixed rail plus its collapse state is dead weight in the thumb-sized layout. |
| shell.status-bar | media-gate | above-lg | inline | allow | — | — | 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-strip | media-gate | below-lg | inline | allow | 44px | — | 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-palette | lazy | all | user-open | allow | 56px | 34 | The 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.copilot | lazy | all | user-open | allow | 44px | 42 | IntentGraph 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.toast | static | all | inline | allow | — | — | Sits above the bottom tabs (`bottom-24` below lg, `bottom-16` above) so a confirmation never lands under a thumb. |
| shell.modal | sheet | all | inline | allow | 44px | — | 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.consent | sheet | all | inline | allow | 44px | — | 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-money | progressive-columns | all | inline | allow | 48px | — | 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-matrix | progressive-columns | all | on-approach | interaction-only | 44px | 56 | The 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-feed | reflow | all | inline | allow | 44px | — | 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-tiles | reflow | all | inline | allow | — | — | 2×2 grid below lg, 4-across above. Values stay tabular so the live tick cannot make them jump. |
| board.meme-radar | lazy | all | on-approach | interaction-only | 44px | 52 | Below-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-marquee | lazy | all | on-approach | skip | 44px | — | 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-basis | lazy | all | on-approach | interaction-only | 44px | 6 | A 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-trackers | reflow | all | inline | allow | 44px | — | 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-monitor | lazy | all | on-approach | skip | 44px | — | 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.stack | lazy | all | idle | interaction-only | 44px | 540 | The 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-poll | static | all | inline | allow | — | — | 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-tick | static | all | inline | allow | — | — | 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.styleguide | static | all | inline | allow | — | — | Renders the surface registry above the fold so the contract is inspectable in the running app, not only in the harness. |