Files
Claude 07cf81bd47 Handoff layout: new README; build-chat notes moved to docs/build-notes/
- 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
2026-11-08 13:22:36 +00:00

13 KiB
Raw Permalink Blame History

/ledger coverage (MASTER.md part 2, the 18 parts)

Page file: components/pages/apps/Ledger.jsx (+ Ledger.css, app/ledger/page.jsx) · gallery: docs/gallery/ledger/ · metric id: api_key_created (developers; on this page through the docs clicks ledger.hero / ledger.close)

Open copy questions for James: none. (The ask "Read the docs" and its docs.hanzo.ai/docs/cli/books link are kept as live; "the CLI docs link" is on MASTER's list, so James may want to confirm it is the right docs URL for Ledger.) Shared changes requested (docs/build-notes/requests/<page>.md): none. Everything this page needed from the shared kit (header ask outline, paste-box greys, close as a Band) is done page-locally in Ledger.css / Ledger.jsx. Forks this page deleted: the group's BizAsk button (now kit Cta), the v1 hero step accordion, the v1 three-box capability grid (now one tabbed object), the page's own AskBar pill, the "Watch" cursor label, kick="bash" on the sheet, the "Get X" receipt-beside-close block of the Biz template (now a hairline receipt strip, then a closing Band).

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport; label and href from lib/cta.js (n/a for the label source: Hanzo's own "Read the docs" → docs.hanzo.ai/docs/cli/books)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js (n/a: no prices)
  • Open copy questions for James listed, none decided

Done here: Header has Persona, Metric: api_key_created, Goal, CTA, Signature, Beyond and V2. The page's ask is solid in the hero and the Band only; while either is on screen main[data-ask-on] turns the header's ask into an outline (Ledger.css), so a probe of every screen at 1470×801 and 375×812 counts at most 1 dark solid button.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it (the layout's #main mark sits before <main>)
  • Every link through A, Go, More or href(); every card a real link
  • Breadcrumb at depth 2 or more (n/a: depth 1)
  • Link parity: 0 removed, 0 unexpected

Done here: One <main>. Parity shows links 3/3 (docs, GitHub, Deploy) through A, More and kit Cta.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero; nothing above the h1 (n/a for PageHero: not merged; BizLines has the same line-mask spec)
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; no 3 same-height sections in a row
  • Ends in Band, footer (proof strip: n/a, Hanzo's ledger page has no proof to strip; a page-local Band: kit Band uses Rise/Magnetic, over the motion budget)
  • Card-to-page links use Morph; title lands within 12px (n/a: no cards lead to pages)

Done here:

  • First screen at 1470×801: "Hanzo Ledger" at 52px cut in by line mask, the lede, the ask and the live book posting by itself in the first second.
  • Order (8 Nov): hero book → splitter (its words ride sticky beside it on desktop, so no empty column) → "Every cent lands somewhere" and its three plain steps, each scene beside its own words (the middle one mirrored), no pin → dark capability room → "Get Ledger" receipt strip and Deploy row → closing Band ("Get started with Ledger", lede, the ask) in a black room that opens from a rounded card to full width, then the footer with no gap.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in header and bar after the hero, same label (header only: JAMES.md 6 bans a floating bar on desktop; the header's own ask is the sticky one)
  • Copy button copies exactly the displayed text; failure never says Copied
  • data-cta and data-thumb on every primary

Done here: kit Cta writes data-cta="ledger.hero" (with data-thumb), ledger.github and ledger.close; the Deploy row carries ledger.deploy. No bar of the page's own floats at any width. Copy is the kit Copy in BizPaste.

5. Trust and proof

  • No logo without documented permission; no seal; no invented number
  • Every figure traces to Hanzo's copy; qualifier beside the number
  • Marquees pause, freeze under reduced motion, hide duplicates (n/a: no marquee)
  • Privacy link and owner line beside every submit (n/a: no form)

Done here: Every figure (10,000, 9,500, 500, USD/2, order_42_payout) comes from Hanzo's own curl and Numscript example on the page. No logos, no seals.

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Measures held; no orphan word in a heading
  • Tables, FAQ, tabs and code use the kit parts
  • python3 scripts/parity.py /ledger: 0 missing

Done here:

  • Parity 55/55 text, 3/3 links.
  • Probe at 375×812: page text is 14px or more; the only smaller runs are 12px Zen Mono capital labels (source, amount, Numscript…) and the header's 13px ask (shared chrome).
  • At 375 the Numscript panes keep their shape and scroll sideways, focusable (tabIndex=0, labelled), with a fade at the right edge instead of cutting off mid-word.

7. Visual design system

  • python3 scripts/taste.py <files> passes; no literal hex outside tokens
  • No label, tag, badge or pill above a headline
  • Radii, shadows and sizes from tokens; never box plus shadow
  • One icon set; no icon in a rounded box
  • Differs from neighbours in hero medium and room order

Done here:

  • taste.py OK. Ledger.css uses only var(--bz-*) and five --ld-* deck steps declared once on .ld (#000000, #fafafa, #e4e4e7, #a3a3a3, #262626) plus white-alpha steps from the deck list; no other literal hex.
  • "Numscript" is a caption under its h2; the sheet has no kick.
  • Scale: h1 52, section heads 26 ("Every cent lands somewhere", "One transaction, however many parties", "Get Ledger"), figures capped at 64 (Σ 0, the "1", 10000/100.00, the amount); one big figure per screen.
  • Objects are outlined (bz-obj), tiles flat; only the slider thumb (a floating control) has the float shadow.
  • Unlike the Biz template: the book reads back what the pointer is on, the close is a Band that opens to full width rather than the "Get X" receipt beside the close.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs trap focus and return it (BizSheet is not a native <dialog>: role=dialog with aria-modal, focus in and back, Esc closes; shared component)
  • Inputs 16px or larger; no bare :hover
  • Forks this page deleted: listed above

Done here:

  • Every :hover in Ledger.css sits inside @media (hover: hover), including the selected tab (underline) and the slider thumb (a 4px ring, no scale).
  • Press is scale .97 / 90ms on the pause, tabs, Copy, the Band ask and the slider thumb; journal rows and accounts are focusable with a 2px ink ring.

9. Motion and interaction

  • One signature, at most 3 supporting techniques, at most 2 fade-ups
  • At least 3 kinds of movement; scroll-linked is half or less
  • Something moves without input; every control answers
  • Reduced motion shows the final state; no setInterval
  • Sound only on the listed moments, through the one kit

Done here:

  • Signature: the book posts by itself. Pointer: hovering a journal row lights the accounts it touched and the note reads it back ("tx 2 · @users:001 · @merchants:042 · @platform:fees · Σ 0"); an account lights its postings; the film holds still while you read. No cursor labels anywhere.
  • Idle: chapter scenes (also stacked on phone) draw a hairline along each chain entry / retry in turn; the dark-room rows sweep; the split bar carries a flowing band. Time: the split slides from 50 to 95 once when first seen. State: the tab pill glides (layoutId, ease-emphasis 300ms; the balance roll is the same tween — no springs). Entrances: stack-drop (the book's layers drop onto it on load), velocity-skew (splitter), spring-snap (each step snaps in from its side on a spring), word-shuffle (dark room), inertia-drag (Get Ledger). The Band opens once.
  • variety.py: 2 techniques (layoutId, useScroll). Reduced motion stops every keyframe and skips the slide.

10. Media

  • Film and Pic only; sizes and posters set (n/a: no images or films on this page)
  • At most 2 videos playing; pause button on loops over 5 s (n/a: no video; the self-running book has a 44px pause)
  • Budgets met; nothing missing; alt on every image (n/a: no images)
  • No dimmed or filtered photo; 4+ real visuals together where the page has them (n/a: Hanzo's ledger page has no media)

Done here: No Hanzo media on this page; its objects are product UI drawn in HTML (book, posting, chain, retries, capability objects, splitter, receipt).

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap
  • No horizontal scroll at 320
  • Every target 44px or more; every hover has a tap path
  • Primary ask above the fold at 375×667

Done here:

  • Under 900px nothing pins: the three steps stack (words, then their scene) and the Numscript copy's sticky is switched off.
  • 8 Nov: with "See the request" open at 1470x801 the sheet's title row sits above the header and the scrim covers the header and the splitter (the sticky column lifts to z 1000 while its sheet is open). check.cjs: 0 console errors and no overlap at every resting screen at 1470x801 and 375x812 (the earlier overlap was the old absolutely stacked chapter scenes left without their pin; they now sit in normal flow).
  • Book rows and accounts answer a tap (pin the reading, tap again to let go). scrollWidth equals the viewport at 320 and 375 (check script).

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item
  • Forms labelled; first error focused (n/a: no form; the splitter's fields are labelled)
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here:

  • Selected tab: #0a0a0a on the #fafafa pill (19:1); unselected #a3a3a3 on #262626 (6.1:1).
  • The book has a pause with aria-pressed; journal rows and accounts take Enter/Space to pin a reading and Esc to clear.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: The h1 and the book render on the server; the book's loop runs only on screen (useLive, setTimeout). Filming and checks ran in the cloud session.

14. SEO and machine files

  • Title and description match live (or are listed for James)
  • Canonical equals og:url equals the live URL
  • <JsonLd route> parses; no broken URL
  • Every card is a real link (n/a: no cards)

Done here: app/ledger/page.jsx (unchanged) takes title and description from content/pages.json and renders <JsonLd route="/ledger" />.

15. Catalogue and product pages

  • n/a: not a catalogue or model page

Done here: n/a. It follows the product anatomy: identity, the book as console, three chapters, the "See the request" spec sheet, the Band.

16. Developer experience

  • One CodeBlock; copy equals display (kit Code until CodeBlock merges)
  • Config blocks parse on their own (n/a: the curl is shell)
  • Terminal pauses and ends on a static frame (n/a: no terminal)
  • No hand-typed version number

Done here: Hanzo's curl sits in one Code pane with Copy in "See the request"; the splitter writes the postings and Numscript live from the amount and percentage.

17. States and resilience

  • Loading, empty, error and offline states designed
  • Blocked live data leaves a complete page, no console errors
  • A failed submit keeps its values and shows no success (n/a: no submit)
  • A thrown island does not blank the page

Done here: Splitter: an empty amount reads "Type an amount above zero" and the seal shows "—". The book's refusals read as an inverted note with a × cue. Nothing is fetched.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js (kit Cta dispatches cta_click; lib/track.js is the shared owner's)
  • Nothing identifier-bearing before consent; no field value in a payload
  • V2: <score>/10 <one line> in the page file's top comment
  • Review read: docs/build-notes/review/ledger.md verdict 8 or more (6/10; this pass answers its Fixes 1–6, awaiting a re-walk)

Done here: V2: line updated (no sticky-bar claim). data-cta ids ledger.hero, ledger.github, ledger.close, ledger.deploy. The 6/10 review was read and each fix is answered in this commit.