- README.md: what this is, how to run and build it, the folder map, how light and dark mode work (@hanzo/appearance, @hanzo/design), where every price and checkout link lives, scripts, and known differences from live - docs/build-notes/: status files, request notes, per-page checklists and reviews, plans - Removed: screenshot galleries, captures of third-party sites used as references, the generated status page and its script, editor config, a personal working-rules file - Code comments point at the new docs paths (no code changes) Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
9.0 KiB
/treasury coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/apps/Treasury.jsx (+ Treasury.css) · gallery: docs/gallery/treasury/ · metric id: api_key_created (docs hand-off)
Open copy questions for James: the wallet's four controls are icons with aria-labels ("Take at checkout", "Delivered: pay the seller", "Release the hold", "Reset"); visible labels would need content/ui-strings.json.
Shared changes requested (docs/build-notes/requests/treasury.md): the phone header ask and ask bar; Settle and PinChapters reading reduced motion during render; PinChapters' phone pin over text. Noted for shared owners: no skip link in shared chrome; useEvery uses setInterval; tokens.css not merged (page CSS uses deck values as literals).
Forks this page deleted: the separate Hold section (its h2 and lede were cut and spliced from Hanzo's sentences), the static .ts-say statement screen (now the chapters' lead), the solid "Take at checkout" button, the floating hero pause, the gold comment and duplicate .ts-ed/.ts-flow/pre rules, every spring.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; "Read the docs" → docs.hanzo.ai/docs/cli/treasury
- One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a prices
- Open copy questions for James listed, none decided
Done here: gate: 1 h1, max 1 solid per viewport at both widths. Desktop: the page's "Read the docs" is solid while the header is quiet, then the header carries it. Phones: the shared header keeps a solid "Try Hanzo", so the page's own "Read the docs" (hero and close) is outlined under 900px. Wallet buttons are outlined icons; the close's ask carries data-thumb so the bar steps aside.
2. Information architecture and navigation
- One
<main id="main">; n/a skip link (shared chrome) - Every link through
A - n/a breadcrumb: depth 1
- Link parity: 0 removed, 0 unexpected
Done here: parity links 3/3 (docs, GitHub, platform deploy).
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- h1 line-mask cut-in (CSS, painted by the server), one lede, one primary, one object; nothing above the h1
- JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; heights vary (dark hero, pinned chapters, short close)
- Ends on the close's heading beside the finished split (a small graphite card whose bar draws in its three parts; hover or focus a row to light its part), one ask and the Get card, then the footer
- n/a Morph
Done here: the server paints the split finished and balanced; it holds, then re-writes from the source line so a destination is named within 0.8 s (no empty box). Gate: JS-off hidden 0.
4. Conversion system
- Kit
A+.w2-cta; no raw.x-btn - Sticky ask: desktop header carries "Read the docs" after the hero; phones: the shared header keeps "Try Hanzo" and no bar shows (requested in
docs/build-notes/requests/treasury.md) - n/a copy button
data-ctaanddata-thumbon every primary
Done here: treasury.hero and treasury.close, both data-thumb="Read the docs". Primary appears twice.
5. Trust and proof
- No logo, seal or invented number
- Every figure is the split's own (10,000 = 9,000 + 500 + 500 from Hanzo's split.num)
- n/a marquees
- n/a submit
Done here: figures come only from the 90% / 5% / remaining split of USD/2 10000; posting lines use only Hanzo's account names.
6. Content presentation (copy untouched)
- No text under 13px on desktop, 14px on phone; mono capitals 11–12px only (the editor's "Treasury Operations" name)
- Measures held; headings balanced
- n/a tables (chapter rows are drawings, aria-hidden); n/a FAQ/tabs
python3 scripts/parity.py /treasury: 0 missing
Done here: parity text 57/57 links 3/3; measured at 375×812 over the whole page: 0 lowercase text runs under 14px (split.num, the close's figcaption and "event →" raised to 14px). Editor comments raised to #a3a3a3 on #0f0f0f (≥7:1).
7. Visual design system
taste.pypasses (0 hues)- No label above a headline (the lede now leads the chapters as a 32px statement)
- Tiles flat; only the chapter cards float
- One inline icon set (1.5px strokes)
- Differs from neighbours: a dark room with an editor and money streams, not a window or a dial
Done here: gate hues []; deck values (#0a0a0a, #171717, #262626, #a3a3a3, #f2f2f2, #ededed). One chapter grid so the destination column holds still.
8. UI component library
- Hover inside
@media (hover:hover), press .97, focus-visible, disabled - Focus ring on every stop
- n/a dialogs
- No bare
:hover; chips 44px with hover and press - Forks deleted: listed above
Done here: wallet buttons invert on hover, the hanzoai chip 44px inverts on hover, the pause inverts.
9. Motion and interaction
- Signature (the split writes itself), supporting: the Stage settle, PinChapters (desktop), the close's 10,000 counted once at figure size (64–84px), plus the magnetic ask as a pointer response;
variety.pypasses; 0 fade-ups - Idle (split, flow events), time (typing), state (wallet), pointer (magnetic), scroll (pin)
- Something moves without input; every control answers
- Reduced motion: the split rests finished, the coin and log rest; no springs
- n/a sound (shared kit)
Done here: variety.py OK (magnetic, pathLength). No pinned chapters any more: the calculator re-plans every figure on the page; the wallet plays itself in its own room (held, paid, back, every 2.4 s while on screen, stops when driven, under pause and reduced motion); each carousel card runs its own ledger while half on screen (rows read in turn every 1.3 s with a drawn hairline, the flow lights its four steps). Entrances: accordion (calculator), iris (wallet), scramble (statement), side-carousel (parts), pixel-resolve (close). motion.mjs at 1470 (7 Nov 22:20): 0 still screens of 6, layout shift 0.000. The coin travels by transform only; the log height is fixed, so nothing below the wallet moves.
10. Media
- n/a: no Hanzo media on the live page; objects are drawn UI
- n/a
- n/a
- n/a
Done here: n/a, the page has no images or films.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Targets 44px or more
- Primary above the fold at 375×667
Done here: on phone the streams come first (inside the first screen) and stack as rows. The calculator stacks its sliders over the posting card; the wallet keeps its own room; the parts are a swipe rail (86% cards, prev/next and a 01 / 04 counter). Account names never break mid-name: reconciliation and balances rows size the account column to its name (desktop), and the phone postings keep @platform:revenue whole (12px arrow, 7ch amount).
12. Accessibility (WCAG 2.2 AA)
- Contrast measured (comments #a3a3a3 on #0f0f0f, body #525252 on white)
- Pause control on every moving item (editor bar, chapter visual)
- n/a forms
- One h1, h2/h3 order
- Keyboard reaches every control; hidden chapter visuals are
inert
Done here: wallet log is aria-live only after the visitor drives it.
13. Performance and engineering
- h1 and code in server HTML
- No images
- No poller, no third party
- Nothing heavy on James's laptop
Done here: one client island; the h1 cut-in is CSS.
14. SEO and machine files
- Title and description from
content/pages.json - Canonical from shared layout
<JsonLd route="/treasury" />- n/a cards
Done here: app/treasury/page.jsx.
15. Catalogue and product pages
- n/a: not a catalogue or model page
- n/a
- n/a
- n/a
Done here: n/a.
16. Developer experience
- The split is Hanzo's own Numscript, displayed as written
- n/a config blocks
- The split pauses and rests finished
- No hand-typed version
Done here: n/a copy button; the code is a display of Hanzo's example.
17. States and resilience
- n/a live data
- Blocked network leaves a complete page, no console errors
- n/a submit
- Reset returns the wallet to its start
Done here: Playwright walk at 1470x801 and 375x812 (7 Nov 22:25): 0 console errors in 6 cold loads, 2 of them with reduced motion on; no horizontal scroll; no text overlap at either size (overlap probe over every screen).
18. Measurement and handover
data-ctaon every primary- Nothing identifier-bearing
V2:line incomponents/pages/apps/Treasury.jsx- Review read: Ready line in docs/build-notes/review/treasury.md
Done here: Ready 7 Nov (James's bar: holds up next to /api and /affiliate, no score). The round-3 complaints are gone with the rebuild: desktop is alive end to end (0 still screens), postings draw real arrows, the count-up never blinks, no pin tail. This pass: account names whole in the carousel cards, the editor pause inverts on hover. taste/parity/unique OK.