Clanker Design System · engineering handoff
Live styleguide — every component renders from the production CSS (final.css · remix.css · remix-timeline.css for the token-detail surface; create.css for the creation flow, §13–§15), so what you see here is exactly what the pages ship. One system, two surfaces, the same Velvet Ultraviolet tokens.
00How to read this handoff

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.

🔒 LockedBuild 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.
🔧 AdaptDirection 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 fluxShared 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.

01Color 🔒 Locked

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.

Core surfaces & text
Light
--bg
#FFFFFF
--navfill
#F3F0FA
--chipbg
#EEEBF6
--line
#E9E5F2
--ink
#171321
--t666
#5B5270
--t888
#7D7492
Dark
--bg
#1B1533
--pop
#271F45
--chipbg
rgba(190,175,255,.13)
--line
rgba(190,175,255,.11)
--ink
#F4F1FB
--t666
…, .64
--t888
…, .50
Accent & semantic
Light
--acc / --cta
#7A3FE8
--acc-bg
rgba(122,63,232,.10)
--pos
#0C7E45
--pos-bg
#E2F4E9
--neg
#D92D3A
--warnc
#A05E00
--warn-bg
#FAF0DC
Dark
--acc
#B18FF7
--cta
#8A55F2
--pos
#34D77B
--pos-bg
rgba(52,215,123,.12)
--neg
#FF6B7A
--warnc
#F7B733
--warn-bg
rgba(247,183,51,.12)

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).

02Type 🔒 Locked

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.

Scale
name · 19 / 600tokenbot
price · 30 / 600$15.98
swap amount · mono 24 / 4000.0
stat value · 16 / 500$15.9M
body / kv · 13 / 400–500Description & social links are editable.
chips / tabs · 12 / 500Swap · Limit · Buy
timestamp / caption · 11 / 40039m ago
section label · 11 / 600 · .06em · UPPERSafety
03Spacing & layout 🔒 Locked

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).

Spacing scale (px)
4
8
12
16
20
24
32
48
04Radius & elevation 🔒 Locked

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.

Radius
4px · micro (tags)
6px · --r (chips/btns)
12px · cards/menus
pill · avatars/dots
05Chips 🔒 Locked

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.

Light
Filter chips — .actbar .chip (active = .on)
AllFarcasterXTradesUpdates
Swap tabs — .swaptab
SwapLimitBuySell
Anchor pills — .apill (identical to swap tabs)
Quick-amount chips — .qchip (the border reference)
0.010.11Max
Dark
Filter chips
AllFarcasterXTradesUpdates
Swap tabs
SwapLimitBuySell
Anchor pills
Quick-amount chips
0.010.11Max
ClassRoleNeutralActive .on
.chipActivity filterborder + --line, text --t666solid --acc, text --cta-ink
.swaptabSwap mode tabbordersolid accent
.apillSection anchorborder—
.qchipQuick amount / expiryborder (full-width flex)accent border + text (no fill)
.hpillHandle pill (FC/X)border—

Shared spec (all): padding:5px 10px · border-radius:var(--r) · font:12px/500 · gap:8px. Hover: text→--ink, border→--t888.

06Badges & status 🔒 Locked

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.

Light
Safety verdict — .railverdict .mhbadge · neutral / .ok / .warnb
v4Top holder 34%✓ Verified✓ Fully vested⚠ thin liquidity
Identity — verified .idok, NEW .newpill, agent-status .agentstatus
✓ VerifiedNEW○ No agent yet
Dark
Safety verdict
v4Top holder 34%✓ Verified✓ Fully vested⚠ thin liquidity
Identity
✓ VerifiedNEW○ No agent yet
ClassMeaningStyle
.mhbadgeNeutral safety fact (v4, top-holder)solid --chipbg, text --t666
.mhbadge.okPositive (verified, vested)solid --pos-bg, text --pos
.mhbadge.warnbRisk (thin liq, volatility)solid --warn-bg, text --warnc
.idokVerified badge (masthead)solid --pos-bg / --pos
.newpillNew token flagaccent tint, 10px, r4
.agentstatusAgent state (○ none / ● v1)11px, gated by data-agent
.uptag / .vtag / .mflag“UPDATE” / “VERIFIED” / admin section flagmicro-tags, mono, r3–4
07Buttons 🔒 Locked

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).

Light
⇄ Trade $CLANKER
Dark
⇄ Trade $CLANKER
ClassTierStyle
.nrlaunch / .connect / .acpostPrimary CTAsolid --acc, text --cta-ink, r--r, weight 600
.hbconnectSoft-primary (menu)--acc-bg fill + --acc-br border → solid on hover
.tb-btnSolid-dark (mobile Trade)solid --ink, text --bg
.manage (Admin)Secondary / ghostborder chip (= the chip system)
.mbtn.ghost / .rxbtnTertiary (drawer / panel)border, --t666 text
.nrtheme / .nrham / .fsoc / .copyIconsquare (32–34px), border, icon in currentColor
08Inputs 🔒 Locked

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.

Light
Search — .search
Composer (admin) — .acinput + .acpost
Dark
Search
Composer (admin)
ClassUseStyle
.searchNav 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 / .mfieldComposer / drawer input--bg, border --line, focus border --acc
09Surfaces & metrics 🔒 Locked

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.

Light
Rail card — .railcard + metric rows .rs
Safety
Price$15.98
Market cap$15.9M
Liquidity$1.6M
Holders77,394
Contract metrics — .kv
Type / chainclanker_v4 · Base
Supply1.00M
DeployedMay 27, 2025
Dark
Rail card + metric rows
Safety
Price$15.98
Market cap$15.9M
Liquidity$1.6M
Holders77,394
Contract metrics
Type / chainclanker_v4 · Base
Supply1.00M
DeployedMay 27, 2025
ClassSurfaceRadius / elevation
.railcard / .swap-card / .chartheroRail cards, swap, chart12px + 1px border, flat
.hbmenu / .curmenu / .searchmenuDropdowns12px (menus) / 8px, + --shadow
.mdrawerAdmin drawerslide-in panel, + shadow
.kv / .rs / .krowMetric rowsflat, no dividers; key --t666 / value --ink
12Activity row 🔒 🔧

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.

13Form fields & upload 🔒 Locked 🌐 12118

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.

Light
Text field — .mf2-field (label · input · counter)
Token name
8/32
Prefixed field — .mf2-inputrow.has-prefix
Symbol
$
4/10
Invalid state — .mf-input.err + .mf-err.show
Website
“.zzz” isn’t a recognised domain ending.
Dropzone — .mf-drop (idle / has-image)
Drop token image or click to browseJPEG / PNG · 1MB max
moltbook.pngShown across clanker.world · click to replace
Dark
Text field
Token name
8/32
Prefixed field
Symbol
$
4/10
Invalid state
Website
“.zzz” isn’t a recognised domain ending.
Dropzone (idle / has-image)
Drop token image or click to browseJPEG / PNG · 1MB max
moltbook.pngShown across clanker.world · click to replace
ClassRoleStyle
.mf2-fieldLabelled field wrapperlabel .mf-flabel + .mf2-inputrow + meta (err + counter)
.mf-inputText / textarea--bg, border --line, focus border --acc; .err → --neg
.mf2-prefixFixed $ / @inline chrome; the value is the bare ticker/handle
.mf-dropImage dropzonedashed border → .over accent tint → .hasimg thumb row
14Option chips, toggle & Proposed badge 🔒 Locked 🌐 12118

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.

Light
Border chips — .qchip (selected = accent border, no fill) + .dim
Solid toggle chips — .pchip (agent platforms)
Agent opt-in — .agentbar + .mtoggle + .tag.prop
Add a tokenized agent Proposed
Attach an AI agent that posts & replies as the token.
On
Dark
Border chips + dim
Solid toggle chips
Agent opt-in
Add a tokenized agent Proposed
Attach an AI agent that posts & replies as the token.
On
ClassRoleNeutralActive .on
.qchipChain / fee / pool / reward / inferenceborder + --line, --t666accent border + accent text, no fill
.qchip.dimUnavailable option (OpenRouter · soon)50% opacity, hoverable tooltip, not selectable—
.pchipAgent platform (multi-select)--chipbg fill, --t888solid --cta, --cta-ink
.mtoggleAgent opt-in switchtrack offaccent track, thumb right, label “On”
.tag.prop“Proposed” markeramber warn tint — flags the not-yet-live agent layer everywhere it appears
15Summary card & multi-recipient builder 🔒 Locked 🌐 12118

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).

Light
Summary card — .prevbox
M
Moltbook
$MOLT · Base
ChainBase
Fee tier1% static
RewardsUSDC → 0xcb2b…f1ab
Reward builder — .recrow (address + %, must total 100)
%
%
CTAs — .mbtn / .mbtn.ghost
Dark
Summary card
M
Moltbook
$MOLT · Base
ChainBase
Fee tier1% static
RewardsUSDC → 0xcb2b…f1ab
Reward builder
%
%
CTAs
ClassSurfaceNotes
.prevboxLive-preview / summary card12px card, 1px --line; .kv rows (§09); wallet-first CTA
.recrowReward recipient rowaddress .recaddr + .recpct %, remove .recrm; allocation gate = 100%
.mbtn / .connect.primaryPrimary deploy CTAsolid --cta (= §07 primary); .ghost = border tier
.toc .titemHanging section index (stepper)per-section done/todo/invalid/opt/na — a layout component; states spec'd in spec §01
RED · NEYN-12112 (token detail) + NEYN-12118 (token creation) · Live styleguide. Every class above is a tag — find it here to get its spec. The system is one spine: new surfaces add their components to these same sections under the same Velvet Ultraviolet tokens (it only grows; it doesn't fork). If the build changes a component, change it here first.