This is the first page of the Clanker redesign and the template for the rest. The design system grows as we add pages — components from other surfaces slot into the same sections. Every item carries one of three stability tags so you know where to build to spec and where you have room to adapt.
| 🔒 Locked | Build to spec. Tokens, the chip/badge/button system, type, spacing, radius, and the core interaction states are decided — match them exactly. This is what keeps the app one system. |
| 🔧 Adapt | Direction is set, details flex. Real data wiring, exact copy, edge-case handling, performance, and backend logic adapt to ground truth. Keep the shape; adjust the plumbing. |
| 🌐 Global · in flux | Shared across every page (nav, footer). Treated as a strong proposal, not final — input from the other pages will likely reshape these. Build them modular and expect change. |
Rule of thumb: anything visual and reusable is Locked (it's the system). Anything that touches live data or a real backend is Adapt. Nav + footer are Global-in-flux. When in doubt, the token/component spec here wins; if reality forces a change, change it here first so the system and the app never drift.
Brand palette is “Velvet Ultraviolet” — a violet accent on a near-white paper (light) / lightened dark-purple (dark). Every colour is a CSS variable; components never hardcode hex. Semantic pairs (fill + text) keep contrast AA in both themes. Ship both themes.
Usage: --acc = interactive/selected + brand. --cta = primary buttons (same violet). --pos/--neg = buys/gains & sells/losses. --warnc = risk (thin liquidity, volatility). Neutral text ramps --ink → --t333 → --t666 → --t888 → --t999. The palette is swappable — the page also ships 5 alternate palettes behind the same variable names (only Ultraviolet is used in production).
Two families, both via CSS vars: --font = Geist (UI) and --mono = JetBrains Mono (all numbers, addresses, %, amounts — anything tabular). Never mix a third face. Numeric fields use font-variant-numeric:tabular-nums.
A 4-based rhythm; the page's vertical beat is ~20px between sections (keyed to the swap card). Content column --maxw 1080px; the body is a two-column grid — feed 1fr + --colgap 24px + rail --rail 348px. The rail collapses below 900px (stats move inline; a docked Trade bar appears).
One corner token routes the small chrome: --r = 6px (chips, tabs, buttons, inputs, badges, menu items). Larger surfaces (cards, chart, drawer, menus) use 12px. Elevation is a single soft shadow token --shadow, used only on overlays (menu, drawer, toast) — the page itself is flat / border-defined.
The most-used component and the strictest rule on the page: a chip is EITHER a solid fill OR a border — never both. One padding (5/10), one radius (--r), one type (12/500), one gap (8px). The border variant is idle/neutral; the solid variant is selected/active. Solid chips carry a 1px transparent border so a filled chip and a bordered chip keep an identical box.
| Class | Role | Neutral | Active .on |
|---|---|---|---|
| .chip | Activity filter | border + --line, text --t666 | solid --acc, text --cta-ink |
| .swaptab | Swap mode tab | border | solid accent |
| .apill | Section anchor | border | — |
| .qchip | Quick amount / expiry | border (full-width flex) | accent border + text (no fill) |
| .hpill | Handle pill (FC/X) | border | — |
Shared spec (all): padding:5px 10px · border-radius:var(--r) · font:12px/500 · gap:8px. Hover: text→--ink, border→--t888.
Non-interactive status markers. Safety badges are the one place chips are solid semantic fills (fill + text share a hue, no border) — because they carry meaning, not selection. Micro-tags (NEW, UPDATE, agent status) sit at 10–11px.
| Class | Meaning | Style |
|---|---|---|
| .mhbadge | Neutral safety fact (v4, top-holder) | solid --chipbg, text --t666 |
| .mhbadge.ok | Positive (verified, vested) | solid --pos-bg, text --pos |
| .mhbadge.warnb | Risk (thin liq, volatility) | solid --warn-bg, text --warnc |
| .idok | Verified badge (masthead) | solid --pos-bg / --pos |
| .newpill | New token flag | accent tint, 10px, r4 |
| .agentstatus | Agent state (○ none / ● v1) | 11px, gated by data-agent |
| .uptag / .vtag / .mflag | “UPDATE” / “VERIFIED” / admin section flag | micro-tags, mono, r3–4 |
Four tiers: primary (accent fill — the main CTA), solid-dark (ink fill — the mobile Trade bar + high-emphasis), secondary/ghost (border chip — e.g. Admin), and icon (square, bordered).
| Class | Tier | Style |
|---|---|---|
| .nrlaunch / .connect / .acpost | Primary CTA | solid --acc, text --cta-ink, r--r, weight 600 |
| .hbconnect | Soft-primary (menu) | --acc-bg fill + --acc-br border → solid on hover |
| .tb-btn | Solid-dark (mobile Trade) | solid --ink, text --bg |
| .manage (Admin) | Secondary / ghost | border chip (= the chip system) |
| .mbtn.ghost / .rxbtn | Tertiary (drawer / panel) | border, --t666 text |
| .nrtheme / .nrham / .fsoc / .copy | Icon | square (32–34px), border, icon in currentColor |
The swap fields are the signature input: one continuous faint-fill box (You-pay + You-receive, no internal divider); the focused field lifts to --bg white + accent border.
| Class | Use | Style |
|---|---|---|
| .search | Nav search | --navfill fill, r--r, focus ring --acc-bg |
| .pay (swap field) | You-pay / You-receive | --navfill box, no divider; focus → --bg + accent border |
| .acinput / .mfield | Composer / drawer input | --bg, border --line, focus border --acc |
Cards and overlays. Rail cards + chart use a 12px radius + 1px --line border (flat, no shadow). Overlays (menu, drawer, toast) add the --shadow elevation. Metric rows are a flat key/value grid — no dividers.
| Class | Surface | Radius / elevation |
|---|---|---|
| .railcard / .swap-card / .charthero | Rail cards, swap, chart | 12px + 1px border, flat |
| .hbmenu / .curmenu / .searchmenu | Dropdowns | 12px (menus) / 8px, + --shadow |
| .mdrawer | Admin drawer | slide-in panel, + shadow |
| .kv / .rs / .krow | Metric rows | flat, no dividers; key --t666 / value --ink |
The feed's atom. A row is a kind (fc / x / trade / update / launch) → an avatar/square, a timestamp, an author, text, and (trades) an amount. Cast + trade rows expand into a panel .rowx (engagement + actions). Update rows are plain text — never expandable. Layout + expand behaviour are locked; the content is real/mock per the data contract. See it live on the page.
The creation form's field atom — MFLOW.field() (ported from the token-detail Manage drawer, so one validation doctrine runs across both surfaces). A labelled input with an optional fixed $/@ prefix, a live char counter, and an inline error row. Numbers/addresses use --mono. The image dropzone accepts JPEG/PNG ≤1MB and renders a real thumbnail.
| Class | Role | Style |
|---|---|---|
| .mf2-field | Labelled field wrapper | label .mf-flabel + .mf2-inputrow + meta (err + counter) |
| .mf-input | Text / textarea | --bg, border --line, focus border --acc; .err → --neg |
| .mf2-prefix | Fixed $ / @ | inline chrome; the value is the bare ticker/handle |
| .mf-drop | Image dropzone | dashed border → .over accent tint → .hasimg thumb row |
The form's selectors obey the §05 one-chip rule. .qchip is the border variant (chain / fee / pool / reward / inference): idle = border + --t666; selected .on = accent border + accent text, no fill. .pchip is the solid variant (agent platforms, multi-select): on = --cta fill. A single unavailable option is .dim. The agent opt-in is a .mtoggle switch carrying the amber .tag.prop “Proposed” badge everywhere the (not-yet-live) agent layer appears.
| Class | Role | Neutral | Active .on |
|---|---|---|---|
| .qchip | Chain / fee / pool / reward / inference | border + --line, --t666 | accent border + accent text, no fill |
| .qchip.dim | Unavailable option (OpenRouter · soon) | 50% opacity, hoverable tooltip, not selectable | — |
| .pchip | Agent platform (multi-select) | --chipbg fill, --t888 | solid --cta, --cta-ink |
| .mtoggle | Agent opt-in switch | track off | accent track, thumb right, label “On” |
| .tag.prop | “Proposed” marker | amber warn tint — flags the not-yet-live agent layer everywhere it appears | |
The live-preview rail inverts the token-detail fill pattern: where the detail page goes JSON → DOM, the creation page goes form-input → a .prevbox summary card (the same .kv metric rows as §09) → the launch record → the success receipt. The multi-recipient reward builder (.recrow) adds/removes rows; the allocation must total 100%. Primary CTAs use the §07 button tiers (.mbtn / .connect.primary).
| Class | Surface | Notes |
|---|---|---|
| .prevbox | Live-preview / summary card | 12px card, 1px --line; .kv rows (§09); wallet-first CTA |
| .recrow | Reward recipient row | address .recaddr + .recpct %, remove .recrm; allocation gate = 100% |
| .mbtn / .connect.primary | Primary deploy CTA | solid --cta (= §07 primary); .ghost = border tier |
| .toc .titem | Hanging section index (stepper) | per-section done/todo/invalid/opt/na — a layout component; states spec'd in spec §01 |