- 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
13 KiB
/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#mainmark sits before<main>) - Every link through
A,Go,Moreorhref(); 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 forPageHero: not merged;BizLineshas the same line-mask spec)- JS off: legible; no
opacity:0on 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: kitBandusesRise/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-ctaanddata-thumbon 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.pyOK.Ledger.cssuses onlyvar(--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 (
BizSheetis 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
:hoverinLedger.csssits 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
FilmandPiconly; 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 (kitCodeuntilCodeBlockmerges) - 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-ctaon every primary; events only throughlib/track.js(kitCtadispatchescta_click;lib/track.jsis 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.mdverdict 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.