- 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
8.8 KiB
/comparison coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/Comparison.jsx · gallery: docs/gallery/comparison/ · metric id: signup_start, read as cta_click on comparison.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/<page>.md): none filed. For the kit owner: DetailSheet is a role=dialog div, not a native <dialog> (part 8); MaskLines runs 1s where MASTER asks 700 ms.
Forks this page deleted: the floating phone total pill (.xcm-mini), the digit-rolling odometer, the 112–128px centred headline, the 140 ms setInterval printer (now CSS transition delays), the spring on the stack bar, every hover transform that was not James's (row nudges, box swell, arrow turn), the side-by-side stack table (now in a sheet, so every price shows once).
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; Hanzo's own label "Try Hanzo" → hanzo.ai/signup
- One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a
lib/plans.js(no plan prices here) - Open copy questions for James listed, none decided
Done here: One solid ask in the hero (comparison.hero) and again at the close of the dark room (comparison.close); "Images it runs" is a quiet (+) and "Put them all back" a text control.
2. Information architecture and navigation
- One
<main>; the shared layout's#mainmark takes the skip link (no second id) - Every link through
A - n/a Breadcrumb: /comparison is depth 1
- Link parity: 0 removed, 0 unexpected
Done here: parity.py /comparison reports 63/63 text and no links to lose; header and footer untouched.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- Nothing above the h1 ("Comparison" is a caption in the right column of the split);
PageHeron/a until the shared part merges - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in the dark room's closing line and the one ask, then the footer
- Card-to-page: the receipt is the
data-morph-targetfor /compare's "Buy it, or run it" card
Done here: The 52px h1 sits left of the 8/5 split with its lede and ask; beneath, the slip feeds out of its slot within 1 s of arrival and its lines print in a 60 ms stagger. JS off: 0 blocks hidden (checked with JS disabled).
4. Conversion system
- Kit
pf-btn solid(no raw.x-btn);<Cta>n/a until it merges - Sticky ask: the shared bar reads the hero's
data-thumb; the page's own floating total is gone - n/a Copy button: none on this page
data-ctaanddata-thumbon every primary
Done here: Hero ask data-cta="comparison.hero" inside data-thumb="Try Hanzo"; close ask data-cta="comparison.close". AskBar renders only hidden data for the shared bar.
5. Trust and proof
- No logo, no seal, no invented number
- Every figure traces to Hanzo's copy (each stack's compose footprint and $/mo, the $225.57/mo total)
- n/a Marquees: none
- n/a Privacy by a submit: no form
Done here: The total only ever shows whole real figures (the sum of the lines switched on); the note under the slip says what the figure leaves out.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held; no orphan in the headings
- The stack table lives in a sheet with
scopeon every header;DataTablen/a until it merges python3 scripts/parity.py /comparison: 0 missing
Done here: Parity 63/63. The critic's "the same eleven prices listed twice" is answered: the main scroll shows each price once, on the slip; images, vCPU and GB open in the sheet.
7. Visual design system
python3 scripts/taste.pypasses; deck greys only- No label, tag, badge or pill above a headline
- Radii 6, 8, 12, 16 from the deck; the slip is flat paper with one floating shadow
- One icon set (hand-drawn tick, arrow, reset at 1.6–2.2px); no icon in a rounded box
- Differs from neighbours: a receipt slip feeding from a slot (/compare is a wide table)
Done here: taste.py OK on Comparison.jsx and Comparison.css. Rhythm from ProofRhythm.css (pf-r on <main>): h1 52, headings 26, the total the one 84px moment (52px phone), the dark-room "$ ?" a 64px figure.
8. UI component library
- Every control has hover (inside
@media (hover:hover)), press (scale .97, 90 ms), focus-visible - Focus ring visible on every stop of a Tab crawl
- Dialogs are native: the kit's
DetailSheetis arole=dialogdiv that traps and returns focus (kit owner's change) - n/a Inputs: none
- Forks this page deleted: listed above
Done here: Slip lines are role=switch buttons; hover fills the row, darkens the box and underlines the name; no nudges.
9. Motion and interaction
- One signature (the slip feeding and printing), 3 supporting (line-mask h1, total swap, dark-room wipe with duty chapters), 0 fade-ups
- Kinds: time (feed and print), state (switches, stack bar reflow, total swap, sheet), arrival (h1), scroll (wipe, chapters ≤ 250svh)
- Something moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - n/a Sound: no shared sound kit exists yet
Done here: Deck timings: 300 ms ease-emphasis prints, 60 ms stagger, 300 ms ease-in-out reflow, 150 ms hovers, 90 ms presses; the paper feed is the one scene move at 1.4 s. variety.py OK.
10. Media
- n/a Images and films: the page has none; its objects are the slip and the duty receipt
- n/a Videos: none
- n/a Alt: no images
- n/a Dimmed photos: none
Done here: n/a: no media on this page; the hero object is product-style paper drawn in HTML.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320 (the sheet's table scrolls inside the sheet)
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here: phone.mjs /comparison OK (375/375). Nothing floats over content: the old total pill is removed; the shared bar is the only bottom layer.
12. Accessibility (WCAG 2.2 AA)
- Contrast: ink and #525252 on white; #a3a3a3 only on black
- n/a Pause control: nothing loops (the slip prints once)
- n/a Forms: none
- One h1; h2 for the bill and the dark room; names start with visible text
- Keyboard reaches every switch, the sheet and the reset
Done here: Each line's switch says "Take out / Add" with its price; the total is real text for screen readers and the full figure stays in the page whatever is selected.
13. Performance and engineering
- h1 and LCP element in server HTML
- No images; transform, opacity and clip-path only
- No poller (printing is CSS transition delays); no third party
- Nothing heavy run on James's laptop (filmed in the cloud)
Done here: Unprinted lines wait invisible in place and the slip feeds by transform, so printing causes no layout shift.
14. SEO and machine files
- Title and description unchanged (
app/comparison/page.jsx) - Canonical from the shared layout
<JsonLd route="/comparison" />renders- n/a Cards: none
Done here: Every stack's images and figures, every duty and the full total are in the server HTML.
15. Catalogue and product pages
- n/a Model card: not a catalogue or model page
- It receives /compare's card by Morph (
data-morph-targeton the slip) - n/a Maker and model links: not a catalogue
- One price figure everywhere (each stack's $/mo appears once in the scroll)
Done here: n/a for catalogue parts; the slip is the landing target of the card that opens from /compare.
16. Developer experience
- n/a CodeBlock: no code on the page
- n/a Config blocks: none
- n/a Terminal: none
- n/a Versions: image tags are Hanzo's compose text, not typed versions
Done here: n/a: no code; image names are shown in mono as their compose files write them.
17. States and resilience
- Static figures, so no loading or error state; the empty state reads "Nothing running, nothing to pay. Add a stack back."
- No live data; complete with the network blocked
- n/a Submit: no form
- No island can blank the page
Done here: Strike every stack and the empty line shows with a $0.00/mo total; the "same image, more than once" block comes and goes with the selection.
18. Measurement and handover
data-ctaon every primary; n/alib/track.js(not inlib/yet)- Nothing identifier-bearing; no form
V2:line in the top comment- Review read:
docs/build-notes/review/comparison.md8/10 (walked before this rework; its complaint, prices shown twice, is fixed)
Done here: comparison.hero and comparison.close; V2 line updated.