Each region maps to components in the design system. Class names in mono are the tags — look them up there for the full spec.
Four independent axes (see the handoff home for where they come from in production). What each changes:
| Axis · value | What changes on the page |
|---|---|
| viewer = visitor | No Admin button, no manage drawer, no update composer. The “no-agent” block shows the visitor note (not the set-up CTA). |
| viewer = admin | Admin button in the masthead → opens the Manage drawer. Update composer appears above the feed. “No-agent” block shows the “Set up an agent” CTA. |
| agent = agent | Agent section shows live metrics (fees / deployed / treasury / uptime). Farcaster + X feed rows and filter chips are present. |
| agent = noagent | Agent section → “No agent yet” (+ set-up CTA in admin). Social (FC/X) feed rows + filter chips are HIDDEN — feed falls back to trades/updates. Masthead shows “○ No agent yet”. |
| agent = v1locked | Agent section → “Not agent-capable” (v1 contract). Social feed rows + chips hidden. Masthead shows “● v1 · not agent-capable”. |
| age = established / early / fresh | Navigates to that token's page. established = $CLANKER (no banner). early = $AIRGAP (amber “early” banner, thin liq, zero trades). fresh = $BRIAN (“just launched” banner, high risk, no agent). |
| theme = light / dark | Full palette swap (incl. the GT chart canvas). Toggled by the ☀/☾ control; persists across the age-navigation. |
Every interaction that must exist. In the prototype these are wired as vanilla JS; treat them as the behaviour spec.
| Where | Trigger → result | Tag |
|---|---|---|
| Search | Focus grows the field + reveals a results dropdown; “/” focuses it; picking a result would route. Mobile: collapses to an icon. | 🔧 |
| Theme toggle | ☀/☾ flips light↔dark, persists, re-renders the chart. Also in the hamburger menu. | 🔒 |
| Hamburger menu | Opens the account menu. Disconnected: Navigate · Tools · Settings · Connect Wallet. Connected: wallet addresses (EVM×3 + Solana, copy/open) · Link X · Toggle Theme · Export Privy · Disconnect · Navigate · Tools. Outside-click / Esc closes. | 🌐 🔧 |
| Address copy | Copy icon → clipboard + toast. (Masthead address + contract section.) | 🔒 |
| Anchor chips | Smooth-scroll to the target section. | 🔒 |
| Swap tabs | Swap / Limit / Buy / Sell — active tab gets the accent fill; Limit reveals the limit-price + expiry row. | 🔒 |
| Swap amount | Typing in You-pay computes You-receive + reveals the quote (rate / network fee / slippage / price impact). Focusing You-pay lifts it to white + accent border (one box, no divider). | 🔒 visual · 🔧 quote |
| Currency select | The token button opens the token menu (WETH/ETH/USDC/$TOKEN). Quick chips (0.01/0.1/1/Max) fill the amount. Reverse arrow swaps direction. | 🔒 |
| Connect wallet | Connect Wallet → connected state (walletline + Disconnect). Mirrors the hamburger's connect state. | 🔧 real Privy |
| Activity filters | All/FC/X/Trades/Updates filter the feed AND the timeline markers together. Updates isolates the plain-text updates. | 🔒 |
| Feed rows | Cast/trade rows expand into a panel (cast: engagement + View on X/Farcaster; trade: tx + Basescan + copy-tx). The top non-trade (cast) row is auto-expanded on load. Update rows are plain text — not expandable, no panel. | 🔒 |
| Post update (admin) | Composer above the feed → Post prepends a plain-text UPDATE row + toast. | 🔒 shape · 🔧 persist |
| Holders | “View top 10” expands the holder list. | 🔒 |
| Admin drawer | Admin button → slide-in drawer with the clanker.world admin sections (metadata, image, verify, rewards, recipient/admin, bulk, agent config). Accordion sections; actions toast (dummy). | 🔧 |
| Mobile Trade bar | Docked black “Trade $token” button → opens the swap route (the rail is hidden on mobile). | 🔒 visual · 🔧 |
Each page is filled from a per-token JSON (clanker-token-{established,early,fresh}.json) by token-fill.js → sets window.TOKEN. Activity + the chart pull live from GeckoTerminal / Neynar. This is the field map — and what's real vs mock in the prototype (all “mock” = 🔧 wire to real).
| JSON field | Drives | Prototype source |
|---|---|---|
| name, ticker, verified | Masthead identity + verified chip | Real (from brief) |
| contractShort / Full, pool, basescanHref | Address (+copy), contract section, chart pool | Real |
| price, changeAbs/Pct/Dir | Masthead price + change, stats, sliver, footer | Real (snapshot) |
| stats{} | Stats grid (mcap / vol / liq / holders / fdv) | Real (snapshot) |
| handles[], launchedBy, isNew | Handle pills, launched-by, NEW pill | Real |
| agentState, agent{} | Agent axis default + Agent metrics block | agentState real; metrics mock |
| safety[] | Safety verdict badges | Mock (plausible) |
| holders[], holdersCount | Holders list + counts | Mock addresses |
| launch, contract, clankernomics | Launch cast, contract kv, clankernomics kv | Contract real; launch/clankernomics mock |
| about[], agentSkill | About prose; hamburger “Copy Agent Skill” | Mock (SEO/skill copy) |
| activity[] (+ GT / Neynar) | Feed rows + timeline markers + volume | Casts/X/trades real; updates/launch mock; trade times re-spread |
These are intentional — documented so you don't mistake them for bugs. All resolve when you wire real data / your stack. The page is otherwise robust: 0 console errors across all 36 state combinations × light/dark × desktop/mobile.
Full component-by-component audit (54 findings, all triaged) was run against this page; every blocker + the token-awareness cluster + the clear state/interaction bugs are fixed. What remains above is the deliberately-deferred, wire-to-real-data set.