Page spec — Token creation Full spec
The anatomy, states, interactions and data contract for the clanker.world /deploy flow (create → success → deployments).

01Anatomy (top → bottom)

One /deploy page: Token by default; an inline toggle expands the optional tokenized agent section. Each region maps to components in the design system — class names in mono are the tags (creation components are in §13–§15). This is the canonical region reference the handoff home §05 points to.

Nav .topnav
Brand + bars, centered search (“/” focuses it), Trade / Launch links, and the wallet-first control: Connect Wallet when disconnected, else the wallet pill → account dropdown (Wallets · Deployments · Social [Connect Farcaster / Link X — the optional secondary attachments, never the primary CTA] · Navigate · Tools · Settings · Disconnect). 🌐 Global
Section index (ToC) .toc .titem
The LEFT column of the 3-column grid (≥1040px), sticky, sitting at the left guide (--pgpad) with live per-section state (done / todo “N left” / invalid / opt-off / n-a). ≤1039px it drops to collapsed state-dots riding the sticky title + a left drawer (§05). The body matches the token-detail width exactly: --maxw 1080 = [ToC --toccol 184 · form 1fr · rail --rail 348]. 🔒
Page head .pagehead
“Launch a Clanker” title + subhead (chain-aware). On mobile the title turns sticky and carries the collapsed ToC state-dots; tap → left drawer. 🔒
Agent opt-in .agentbar
“Add a tokenized agent” .mtoggle switch with the amber Proposed tag (the agent layer is not live on Clanker today). Base-only — auto-off + toast on other chains. Not a separate object: just a Clanker with an agent attached. 🔒 shape · 🔧
Token #sec-token
Image dropzone (JPEG/PNG ≤1MB, renders on the preview), name (≤32), symbol ($-prefixed, ≤10), and the chain selector (7 chains; Base default; drives §fees–§pool recompute + agent/preclank availability). 🔒
Description & social #sec-social
Description (≤240), website (real-TLD check), Telegram / X / Farcaster handles (@-prefixed, validated). All optional — credibility attachments, not identity. 🔒 🔧
Fees #sec-fees
Static (default) / Dynamic 3% · tier 1/2/3% (dimmed under Dynamic) · sniper-tax seconds (chain default 15s, Ethereum 90s; 80%→5% decay). 🔒
Rewards #sec-rewards
Admin address + multi-recipient builder .recrow (add/remove rows, per-row 0x + %, must total 100%, ≤7) + reward type Paired / $Token / Both. Admin + first recipient prefill from the connected wallet. 🔒 🔧
Pool & supply #sec-pool
Recommended (mcap locked/read-only) / Legacy (mcap editable) · pair token (chain-derived USDC/WETH/USDT/WMON) · starting mcap (chain default) · total supply (100B). 🔒
Agent #sec-agent
Shown only when the toggle is on. Name (≤32), voice/personality (≤280), Inference (venice.ai · Llama 3.3 70B at launch; OpenRouter chip = soon/disabled), posting mode (Post+Reply / Post only), platforms (Farcaster on / X off, ≥1 required), funding share (10% of fee rewards → inference). Carries the Proposed tag. 🔒 shape · 🔧 wire
Add-ons [data-cx]
Four optional modules, off by default, each self-registering via window.CREATE: Creator vault (%, beneficiary, 7-day-min lockup, vesting) · Creator buy (ETH dev-buy) · Airdrop (paste CSV live-parsed / top mutuals / FC following) · Preclank (cast keyword; Base+Monad only). 🔒 shape · 🔧
Live preview rail .col-rail .prevbox
Everything above → a window.TOKEN-shaped summary card → launch record → success receipt. Wallet-first: disconnected → the CTA is Connect Wallet + “identity is your address”. 🔒 🔧
Submit + mobile .submitrow · .launchbar
Desktop rail CTA + inline submit row. On mobile the rail is hidden → a docked launch bar + a pre-deploy review sheet .mf-modal before Clank. 🔒
Success + deployments create-success{,-ta}.html · deployments.html
Token receipt / dual token+agent receipt (Proposed) — both personalize from the launch record with static fallback. Deployments = connected list (Tokens + Tokenized-agents groups, filters, live counts, just-launched prepend) vs disconnected empty state. 🔒 🔧
Footer .footer
Token column ($CLANKER + price + Clank), link columns, CLANKER watermark, legal disclosure. 🌐 Global

02State matrix

The creation flow renders from independent axes (see the handoff home for where they come from in production). What each changes:

Axis · valueWhat changes on the page
wallet = connectedWallet pill + account dropdown. Admin + first reward recipient auto-prefill from the address. Every CTA = “Clank” (or “Clank + Agent”).
wallet = disconnectedEvery CTA (nav / submit / rail / mobile launch bar) becomes Connect Wallet; the rail reads “Connect a wallet to deploy — identity is your address”; admin + first-recipient prefill cleared.
agent = offDefault. Token-only form; the Agent section + preview sub-card + ToC item are hidden; CTA = “Clank”.
agent = onAgent section expands inline (+ preview agent card + ToC item); CTA → “Clank + Agent”; deploy routes to the dual receipt. Only selectable on Base.
chain = Base … MonadRe-derives pair token, reward-type chips, sniper default, starting-mcap default, agent availability (Base only), preclank availability (Base + Monad), and the chain-info strip. Only overwrites values the user hasn't diverged.
fee = static / dynamicDynamic dims the fee-tier chips (fixed 3%).
pool = recommended / legacyRecommended locks the starting mcap (read-only); Legacy makes it editable.
add-ons (×4)Each of vault / buy / airdrop / preclank: off / on-valid / on-invalid / n-a (preclank on an unsupported chain). Airdrop sub-states: CSV (0 / N+total / N errors) vs mutuals vs following.
theme = light / darkFull Velvet Ultraviolet palette swap; drives every page in the journey. Persisted.
Combinatorics: the structural axes alone — agent × wallet × chain × fee × pool × theme = 2 × 2 × 7 × 2 × 2 × 2 = 224 base combinations, each of which must render coherently — before the 4 independent add-on toggles (×16), per-field validation states (empty-required / empty-optional / valid / invalid; allocation <100 / =100 / >100), and 4 viewports. Far larger than the token-detail's 36; the verification pass drives the representative matrix and asserts 0 console errors per state.

03Interaction inventory

Every interaction that must exist. In the prototype these are wired as vanilla JS (MFLOW field engine + the window.CREATE add-on registry); treat them as the behaviour spec.

WhereTrigger → resultTag
Chain chipsPick a chain → re-derives pair/reward chips, sniper + mcap defaults, agent + preclank availability, the chain-info strip. “More” reveals the extra 4 chains. Only overwrites values the user hasn't diverged from the chain default.🔒
Agent toggleOn → expands the Agent section, adds its preview card + ToC item, CTA → “Clank + Agent”. On a non-Base chain it's disabled (toast). Off → collapses; hidden fields are skipped by validation.🔒
Field validationLive on input + blur: inline red error + a char counter (MFLOW). Prefix fields ($/@) keep the input borderless — the error chrome lives on the row. Symbol upper-cases + strips $; addresses shorten to 0x…abcd.🔒
Image dropzoneClick / drag-drop → validates JPEG/PNG ≤1MB (else toast) → renders a real thumbnail on the field + the preview avatar. Remove restores idle.🔒
Fee / pool modesDynamic dims the tier chips; Legacy unlocks the starting-mcap field (Recommended re-locks it to the chain default).🔒
Reward builderAdd / remove recipient rows (≤7); each row = 0x address + %. Live allocation indicator; the deploy is hard-blocked unless it totals exactly 100% (strict integer check).🔒 🔧
Inference modelvenice.ai (Llama 3.3 70B) selected; OpenRouter chip is .dim (hover tooltip “coming soon”, not selectable). The choice is recorded → shown on the agent receipt.🔒 shape · 🔧 wire
Add-on modulesEach registers via window.CREATE.register() and owns its own record/preview/validation: vault (%/quick-sets, 7-day-min lockup enforced, vesting), creator buy (ETH + first-swap estimate), airdrop (paste CSV → live per-line parse w/ counts + errors, or mutuals/following), preclank (keyword; chain-gated Base+Monad).🔒 🔧
Wallet connectConnect → connected state across every page (walletline + Disconnect); admin + first recipient prefill. Mirrors the account dropdown's connect state. Persisted to 12118-states / clanker_auth.🔧 real Privy
ToCClick a section → smooth-scroll; scrollspy marks the active row; hover expands the compact rail (Grow); on mobile the collapsed dots ride the sticky title → tap opens a left drawer.🔒
Deploy (Clank)Connect gate → validate in DOM order, skipping hidden sections → first-invalid scroll+focus+toast → allocation≠100 block → agent-on-no-platform block → (mobile) pre-deploy review sheet → “Deploying…/Deploying token + agent…” → “✓ Deployed” → navigate to the matching success page. Writes the launch record first.🔒 🔧
Theme toggle · copy · account menu☀/☾ (and the dropdown item) flips light↔dark, persists. Address copy → clipboard + toast. Account dropdown: Wallets (copy) · Social · Navigate · Tools · Settings · Disconnect; outside-click / Esc closes.🔒 🌐
Deployments filtersAll / Tokens / Tokenized-agents filter the groups; counts recompute from the DOM; a just-launched record prepends to the matching group (“just now” for 1h).🔒 🔧

04Data contract

The inverse of the token-detail's fill: where that page goes JSON → DOM, the creation page goes form input → a window.TOKEN-shaped preview → the launch record (localStorage['12118-launch']) → the success + deployments pages (textContent-only, XSS-safe). This is the field map — and what's real vs mock in the prototype (all “mock” = 🔧 wire to real).

FieldDrivesPrototype source
imagePreview avatar + (real) token imageReal (client-side object URL)
name, symbol, chainIdentity, preview, receipt, deployments rowReal (form input)
description, website, tg/x/fcMetadata + social attachmentsReal input; social linking Adapt
feetype, feetier, snipertaxFee chips + receipt fee lineReal input
recipients[] {addr, pct}, rewardtokenReward builder + “N recipients” on the receiptReal input; allocation gated =100%
pooltype, pair, mcap, supplyPool section + receipt; chain-derived defaultsReal input (defaults per chain)
agent {name, voice, model, mode, platforms, funding}Agent section + dual receipt + deployments agent blockReal input; runway estimate mock; model → 🔧 wire (venice.ai / OpenRouter)
addons {vault, buy, airdrop, preclank}Add-on preview rows + receipt/deployments chipsReal input; on-chain effect Adapt
wallet identityConnect state, admin/recipient prefillMock → 🔧 wire Privy + the 12118-states / clanker_auth keys
contract, tx, block, pool statusReceipt confirmation rowsMock → 🔧 the real chain deploy
deployments fixturesThe two demo rows (Privashh, Moltbook)Mock (illustrative); the prepended just-launched row is record-driven

05Responsive

06Open questions & known limits 🔧 all Adapt

These are intentional — documented so you don't mistake them for bugs (the “Out of scope this pass” set). All resolve when you wire real data / your stack. The page is otherwise robust: 0 non-benign console errors across the representative state matrix × light/dark × desktop/mobile.

The token-detail page's robustness-audit methodology (component-by-component sweep for hardcoded values that should be state/record-driven — 54 findings there) was applied to this surface: every per-chain / per-wallet / per-token surface derives from state or the launch record, not a literal. What remains above is the deliberately-deferred, wire-to-real-data set.

RED · NEYN-12118 · Page spec for the token-creation surface. Pairs with the design system (component specs, §13–§15) and the handoff home (legend + conventions). Sibling: token-detail spec.