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

9.6 KiB
Raw Permalink Blame History

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

Page file: components/pages/Referral.jsx · gallery: docs/gallery/referral/ · metric id: signup_start

Open copy questions for James: none decided. Only the 21 strings of content/live/referral.json appear; the invented channel names, row labels and the split affiliate sentence from the earlier build are gone. Shared changes requested (docs/build-notes/requests/<page>.md): docs/build-notes/requests/referral.md (Ask.jsx: on phones, quiet header while the hero ask shows, then the header carries the page's ask; done page-locally until then). Forks this page deleted: hand-rolled xp-cta/xp-ghost anchors (now kit Cta), the icon boxes and the grey list-plus-box stage (now one strip), every tiled marquee (now one pinned journey), the share-chip list and the channel-name rail, the definition-list dark room and its second "Affiliates" link, every Apple grey.

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport; label and href are the live page's ("Get your link" → /signup?next=/referral)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; n/a prices
  • Open copy questions listed, none decided

Done here: one <h1> in server HTML; at the top the header is an outline at both widths (measured rgba(0,0,0,0) background) beside the hero's solid "Get your link"; after the hero the header is solid "Get your link" (measured rgb(10,10,10)) at 1470 and 375.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it (app/layout.jsx)
  • Every link through A or Cta
  • n/a breadcrumb: depth 1
  • Link parity: 0 removed, 0 unexpected

Done here: parity.py /referral → links 3/3 (/signup, /login, /affiliate).

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • Line-masked h1; nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per section, each shown once: the card, one referral's journey (one word big at a time, the link pill once), the steps strip, the one difference (two tracks), the close
  • Ends on a closing band: the sign-in line, the ask ("Get your link", Sign in) and the card at rest, then the footer
  • n/a Morph: no card opens a page

Done here: the journey pins for 260svh on wide screens (stacks and plays once by itself under 900px); the dark room opens from a 32px inset (8px on phones, inside the text's 24px margin, so no letter is cut); the close shows the card with the rider on Qualified.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in the header after the hero, same label, at both widths; no bottom bar (measured 0 .x-ask); the header returns to quiet while the closing ask is on screen, at both widths
  • n/a copy: signed-out Copy is aria-disabled; pressing it shakes the link and lights Sign in, never says Copied
  • data-cta (referral.hero, referral.close) and data-thumb on the primary

Done here: usePhoneHeaderAsk mirrors the desktop Ask.jsx move on phones (request filed).

5. Trust and proof

  • No logo, no seal, no invented number (counts show an em dash, as signed out on hanzo.ai)
  • No figure to trace; the pay tracks carry no numbers
  • n/a marquee: none left; the only loops (flow dots, pay tracks, the rider's breath) are ambient and freeze under reduced motion
  • n/a Privacy: no form

Done here: the journey carries only Hanzo's words (Referred, Pending, Qualified, hanzo.ai/?ref=… once).

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Headings balanced; the dark room's two sentences sit in two columns (5/7)
  • Steps are aria-pressed buttons that replay their drawing; no table, FAQ or code
  • python3 scripts/parity.py /referral: 0 missing

Done here: parity text 20/20 links 3/3; no word on the page outside content/live/referral.json.

7. Visual design system

  • taste.py passes; deck greys only
  • No label above a headline ("Referrals" sits under the asks)
  • Radii 16/20/24/full; flat tiles
  • One icon set; no icon in a rounded box
  • Differs from /affiliate (display link, sticky chapters with a box) and /bounty: the signed-out card, a pinned one-word journey and a four-column strip

Done here: taste.py components/pages/Referral.jsx components/pages/Referral.css → OK.

8. UI component library

  • Every control has hover (in @media (hover:hover)), press, focus-visible
  • Focus ring on every Tab stop
  • n/a dialogs
  • n/a inputs
  • Forks deleted: listed above

Done here: Copy fills ink; steps lift 2px and ink; the "Affiliates" link brightens and moves its underline; press .97 or 1px.

9. Motion and interaction

  • One signature (the journey) plus 3 (line-mask h1, the card's landing builder, the dark room opening); 0 fade-ups; variety.py OK (3 techniques)
  • Kinds: idle (flow dots, pay tracks, the rider's breath), time (builder lands once, strip draws once, phone journey plays once), pointer (hovers), state (step replays, word cut-ins), arrival (h1, room opening); scroll-linked is the journey and the room only
  • motion.mjs: 0 still screens at both widths, layout shift 0.002–0.003
  • Reduced motion: final states (card on Qualified, journey on Qualified, all four drawings, affiliate track full); no setInterval
  • Sound: data-sound="tick" on steps and Copy

Done here: slice D (7 Nov) re-verified the motion-map rebuild: the h1 slot-roll, the How-it-works word-shuffle (now each word rises into its own place in shuffled order, so no word ever crosses another), the dark room's cursor-lens, the counts dealt from one deck, and the close (the card holds at the top of a short pinned stage while the sign-in panel rises with the scroll and parks right under it, never over it, then both leave together). Earlier: motion.mjs /referral desktop 0 still (its Copy/Affiliates "dead hover" lines come from headless Chrome not matching (hover: hover); Playwright with a fine pointer measures Copy going from white to rgb(10,10,10)), phone 0 still and 0 dead controls.

10. Media

  • n/a Film/Pic: no Hanzo photo or film on this page
  • n/a videos
  • No images to size
  • n/a photos

Done here: every object is DOM or inline SVG.

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap (flow dots run on their own track under the tiles)
  • No horizontal scroll (0 at 375)
  • Targets 44px or more
  • Primary ask above the fold at 375×667 (y ≈ 315)

Done here: slice D (7 Nov): check.mjs /referral passes at 1470×801 and 375×812 (0 errors, no overlay, scrollWidth 1470/375); no in-page target under 44px at 375 (the close's Sign in link now 44px); on phones How it works is the question card then the summary, whose four steps are listed from the start in grey and ink with a drawn check as each is done (no tall empty box); the close stage parks the panel under the card at 375 too.

12. Accessibility (WCAG 2.2 AA)

  • Text at 4.5:1 or better (unlit rail words #737373)
  • n/a pause: no loop over 5 s carries content; the journey follows the scroll and the strip ends at rest
  • n/a forms
  • One h1; h2s for How it works, the dark room and the close
  • Keyboard reaches every step button and both asks

Done here: the summary's pending steps are readable (#737373, no longer aria-hidden) and turn ink when done; Copy is aria-describedby the sign-in line; the tracks are aria-hidden beside the sentences they draw.

13. Performance and engineering

  • h1 and lede in server HTML
  • No new dependency; no rAF loop
  • No poller; no third-party request
  • Filming in the cloud only

Done here: 200 and 0 console errors at both sizes.

14. SEO and machine files

  • Title and description from the live page
  • Canonical from shared metadata
  • <JsonLd route="/referral" /> renders
  • n/a cards

Done here: app/referral/page.jsx metadata unchanged.

15. Catalogue and product pages

  • n/a: not a catalogue or model page
  • n/a Morph
  • n/a model links
  • n/a prices

Done here: n/a, a programs page.

16. Developer experience

  • n/a: no code
  • n/a config
  • n/a terminal
  • n/a versions

Done here: n/a, the only mono text is hanzo.ai/?ref=….

17. States and resilience

  • Signed-out state designed (Hanzo's own)
  • No live data
  • n/a submit
  • The header hook restores the header on unmount

Done here: usePhoneHeaderAsk undoes its label, href and data-ask on route change.

18. Measurement and handover

  • data-cta on every primary; events through the kit's hz-event
  • Nothing before consent
  • V2: line in the page file
  • Review read: docs/build-notes/review/referral.md (7/10, third walk) fix list answered: the step 03 needle now rotates by CSS with transform-box: view-box; transform-origin: 200px 220px, measured in Playwright at 0.00px from the hub at rest (50°), mid-replay (37.7°) and after replay, at 1470 and 375; every other anchor measured the same way (share dots, the locked account, the waitlist bar: 0.00px). The hero's dead band is gone: the journey's word peeks under the hero at 1470×801 and its stage sticks at 22svh, so nothing blank follows it

Done here: 1 the tiled rails became one pinned journey (link once, one word big at a time); 2 phone clip starts at 8px inside a 24px text margin; 3 the close is a band with the card at rest; 4 the steps are one four-column strip, not a list beside a grey box; 5 "Affiliates" shows once; 6 phone header goes quiet at the closing ask.