Skip to content

Agent UX Musts 1–7: www canonicals + header-first V2 accuracy - #1

Draft
gregrdev wants to merge 34 commits into
mainfrom
cursor/agent-ux-musts-e117
Draft

gregrdev wants to merge 34 commits into
mainfrom
cursor/agent-ux-musts-e117

Conversation

@gregrdev

@gregrdev gregrdev commented Sep 16, 2026

Copy link
Copy Markdown
Owner

Align shipx402.com agent/human UX with official x402 V2 (docs.x402.org / x402-foundation). Accuracy over novelty: www canonicals, header-first teaching, digest Content-Type, Learn path order, checker/explorer copy, redirects, and dated protocol facts. Additive restyle only (no monetization/arcade).

Wallet Fast freeze strings untouched (wallet-fast.tsx freeze copy verbatim). Learn Fast stays below Setup.

Founder will preview then merge — do not merge.

Tip SHA 159145b

  • Non-compact SupportNudge tip button: no rgb/color-mix shadow (iridescent stays rails / nav hairline / Setup frame-soft only)
  • Trust-chip rows not de-duped (soft-hold P1)
  • Wallet Fast freeze, H1, Learn Fast, accept-list otherwise unchanged

Site & Trust (carried)

  • Type +2px; Independent/NFA/legal .legal-quiet
  • Trust chips own quiet row under Setup; freeze split; no RGB on chips
  • Centered agent CTAs under Setup (lg secondary)
  • Wordmark A + 1fr auto 1fr; Independent strip above; hairline under sticky header
  • Quiet /tools SupportNudge compact
  • Learn Fast below Setup; Walk the Loop not filled beside Practice
  • About live GitHub link

Test notes

  • npm run build green at 159145b
  • No merge (founder preview)
Open in Web Open in Cursor 

…igest accuracy

Prefer https://www.shipx402.com for canonicals, sitemaps, and agent surfaces.
Teach PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE as canonical V2
headers (X-PAYMENT as legacy). Serve /.well-known/x402 as application/json,
reorder the Learn path to match docs.x402.org, and update checker/explorer copy
for CAIP-2, facilitators, and Solana exact USDC — no speculative protocol APIs.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
@vercel

vercel Bot commented Sep 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
shipx402 Ready Ready Preview Sep 16, 2026 7:04am UTC

Request Review

…edirect, CAIP-2 form

Add attribution.cite https://www.shipx402.com/ on site catalog, agent-card, and agent.json.
308 /guides/why-agent-readable to /guides/agent-readable. Alias /.well-known/llms.txt to
/llms.txt. Curriculum network_form uses genesis-hash CAIP-2 and rejects solana:devnet.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Tighten shared radius tokens to ~4–8px, lift background/text off harsh
black-on-white, and add low-opacity RGB hairlines/glows via CSS variables
and chip/nav utilities. No copy, protocol, or monetization changes.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
…GB spin

Darken page charcoal vs the first restyle preview, cap radii at 2–4px, and
add a rotating RGB hairline + soft glow on the hero and Payment Loop. Center
the home hero; place loop step numbers and feature icons on the title row.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Apply .rgb-frame to the home hero and Learn Payment Loop only — not the
four-card directory grid. Feature icons sit in an explicit flex-row beside
titles; hero/setup copy is centered. Loop steps use .step-num. Card no longer
defaults to rgb-hairline; page wash is charcoal-only. Trust chrome uses
muted/fg. Title Case: What Is x402?, What Is an RPC?, and related H1s.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Remove the body linear-gradient wash so the page is solid --color-bg.
.rgb-frame stays on key cards only. Title Case for What Is x402? / What Is
an RPC? is already in learning-path.ts and live strings.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Kill rainbow hearth-panel/scan-grid fills on the home hero and Payment
Loop. Cards stay plain surface. Tighten the hero. RGB lives on a pair of
vertical .cyber-rail lines (transform-safe bead animation) plus a thin
mask-free .rgb-frame border so production CSS cannot flood the card.
Add a Devnet-first Make a Wallet Fast setup strip under the hero.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Replace splash fills with plain charcoal. Page-level .cyber-columns sit
below the Independent strip (RGB on the lines only; --cyber-rail-glow;
reduced-motion static). Tight hero CTAs: Make a Wallet Fast + Learn Path.
Main Wallet Fast strip uses rgb-frame-soft and frozen copy; Phantom/Solflare
show Continue on Devnet. Compact agent row; Learn Fast vs Start Here;
Grade/Ship/Explorer only. Continue chip only when localStorage progress exists.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Match freeze strings on Wallet Fast (Practice not Practice Wallet),
Learn Start Here Wallet Fast + Payment Loop, Home Learn Fast quiet
links, and /app network/mode validateSearch.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Match VC v1.1 verbatim on #setup Make a Wallet Fast: 1. 2. 3. steps,
Solana Devnet chip, phone strip, trust chips, homepage phrase, Loop
bridge, agent aside, and How keys stay on your device.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Replace Home agent-row copy with the www site.txt freeze line.
Wallet Fast already carries Then walk the Loop — free cert.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Keep Then walk the Loop — free cert. verbatim as the v1.1 end
bridge, directly under Practice / Install / Continue on Devnet.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Accent lines travel downward on an 16–18s loop. Intensity stays a
thin hairline; prefers-reduced-motion keeps a static frame.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
1px rails on a 30s downward waterfall, navbar hairline, outline hero
Wallet Fast, Learn Fast without Open Learn, compact 3-item FAQ.
Fix tagline double period. Home H1 and Grade copy softened.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
SupportNudge on /tools uses border-border surface and an outline CTA.
Donate catalog gist: Tips over 0.25 SOL get a special thank-you.
Wallet Fast freeze untouched. Skip H-10.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Prefer the existing muted compact variant: text link, optional framing,
no cyber-edge or filled primary CTA. T-06 donate gist already applied.
Wallet Fast freeze untouched.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Founder H1/sub/closer/title: teach then ship; practice on Devnet; never share keys. First-viewport trust chips, sparse wordmark, 1fr header, +2px type, quieter legal strip. Wallet Fast freeze untouched; Learn Fast stays below Setup.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Devnet chip gets a one-line practice-network gloss (Wallet Fast freeze strings unchanged). Solana/x402/402 Checker first mentions and site.txt/llms.txt ## gloss share /learn facts. Header wordmark vs footer tile.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Footer Devnet chip (adjacent only), ship-api practice-network copy, Learn facilitator before loop step 5, tools wallet keys-never-leave gist, agent-row Devnet line.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Move Wallet Fast freeze chips to a full-width quiet row under Setup. Header BrandMark size lg with sparse Sx tile. Wire --rgb-line-* on rails, nav hairline, and Setup frame. Root type 18px; legal strip stays quiet. Learn Fast and H1 unchanged.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Header uses variant=wordmark (no Sx tile) in grid-cols-[1fr_auto_1fr]: mark left, nav center, Open practice wallet right. Footer keeps the compact tile. BrandMark asset left in place for Icons.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
CSS/text Ship x402 only (no SVG). Header uses wordmark; footer/app keep the Sx tile.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Keep Wallet Fast freeze strings; add adjacent Devnet chip only. Replace site.txt/llms ## gloss with Agent UX facts (Solana teach-first, Checker headers first).

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Gloss Devnet on Learn Start Here cards; facilitator teach chip before loop step 5; drop remaining fake-money SEO; Guides map chips for payTo, CAIP-2, keys never leave.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Tools card and digests now use keys never leave / never paste — not the weaker stay-on-device line.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Drop the “once published” clause so Contact points at the live repo.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Open site.txt now shares the quiet secondary treatment with Copy agent prompt.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Keep iridescent on rails, nav hairline, and Setup frame-soft only.

Co-authored-by: Phoenix <grachkovsky@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants