The Clanker redesign, handed over cleanly. Two surfaces so far — the token-detail page and the token-creation flow — each a self-contained section here, both built on one design system. Everything is tagged so you know exactly where to build to spec and where you have room to adapt. This explorer grows page by page; the system is the spine and only grows, it doesn't fork.
This handoff's job is to make your job easier — to not make you guess — while leaving you room to adapt where reality demands it. So every token, component and region carries one of three tags:
This is deliberately structured as a template so pages drop into the same shape without re-litigating the system. The token-detail page came first; the token-creation flow is the second surface, and it slotted into the exact same structure — the proof the template works:
spec-token-detail.html and spec-creation-flow.html; add spec-<page>.html for each new surface. Same anatomy → state-matrix → interactions → data-contract structure every time.Read this before you open the source, so you calibrate what to take literally.
final.css · remix.css · remix-timeline.css; the creation surface ships create.css — both consume the same token names, so they read as one site.Each surface renders from independent axes on <body data-*> (in the prototype you flip them via review chrome; in production they come from data + auth). The token-detail axes:
| Axis | Values | Drives | In production, comes from |
|---|---|---|---|
| data-viewer | visitor · admin | Shows/hides the Admin button + drawer and the update composer. | Is the connected wallet the token admin? |
| data-agent | agent · noagent · v1locked | The Agent section, and whether social (Farcaster/X) feed rows + filters show. | The token's on-chain + agent config. |
| data-age | fresh · early · established | The token-age risk banner + which of the three token pages you're on. | Pool age / trade history depth. |
| data-theme | light · dark | Palette. Toggled by the on-page ☀/☾ control; persists. | User preference. |
The token-creation flow has its own axis set (full detail in the creation spec §02):
| Axis | Values | Drives | In production, comes from |
|---|---|---|---|
| data-wallet | connected · disconnected | Wallet-first auth: every CTA becomes “Connect Wallet”; admin + first reward recipient prefill from the address. | Privy / wallet connection. |
| data-agent | off · on | Reveals the inline tokenized-agent section (+ preview sub-card + ToC item); CTA → “Clank + Agent”. | Did the creator opt in? (Base-only.) |
| chain | Base · 6 more | Re-derives pair token, reward type, sniper default, start mcap, agent + preclank availability. | Creator's chain choice. |
| fee / pool | static·dynamic / rec·legacy | Fee tier active vs dimmed; starting mcap locked vs editable. | Creator's choices. |
| data-theme | light · dark | Palette. Same control, drives every page. | User preference. |
/deploy page whose sections recompute from the chain + agent axes.The two page specs drill into each region; this is the combined map. Full component specs (with live examples) are in the design system. The canonical region detail for each surface lives in that surface's spec §01 Anatomy (detail · creation).
| Region | Section | Stability | Notes for engineering |
|---|---|---|---|
| Nav (logo, search, theme toggle, Launch, hamburger/account menu, scrolled collapsed masthead) | Both | 🌐 Global | Strong proposal; expect change. The account menu (connected/disconnected wallet states) mirrors clanker.world's Privy menu. On creation, the nav Launch CTA cross-links to /deploy; wallet-first identity lives here, not on a primary CTA. |
| Masthead / identity (avatar, name, verified, agent status, address, handles) | Detail | 🔒 🔧 | Layout + the three agent-status states locked. Address full desktop / truncated mobile. Data + copy adapt. |
| Chart · Activity · Evidence · Swap console | Detail | 🔒 🔧 | All interaction states locked (row/expand, swap focus, one-box no-divider). Live data + quoting + wallet connect are Adapt. Timeline is under review — build decoupled. |
| Create form (identity · description · fees · rewards · pool/supply · add-ons) | Create | 🔒 🔧 | Field set, validation UX (MFLOW), the one-chip selectors, the hard-block deploy order + hidden-section skipping are locked. Chain ground truth (7 chains) is verified from the live form. Real chain deploy is Adapt. |
| Tokenized-agent section (inline opt-in, name/voice/model/mode/platforms/funding) | Create | 🔒 shape · 🔧 wire | Layout + Base-only gating + the “Proposed” tag are locked. Inference model (venice.ai now / OpenRouter soon) is chosen & recorded; the inference backend + X-API-key linking are Adapt. |
| Live preview rail → success receipt → deployments | Create | 🔒 🔧 | The inverse fill (form → window.TOKEN-shaped preview → launch record → receipt) is locked. Fixtures/runway are mock → Adapt to real records. |
| ToC / stepper (hanging section index, 3 responsive tiers) | Create | 🔒 | Per-section state (done/todo/invalid/opt/na), scrollspy, and the ≥1320 / 1040–1319 / drawer tiers are locked. See creation spec §01. |
| Footer | Both | 🌐 Global | Global; expect change. Columns + socials + legal are a proposal. |