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

11 KiB
Raw Permalink Blame History

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

Page file: components/pages/Beta.jsx · gallery: docs/gallery/beta/ · metric id: signup_start

Open copy questions for James: none (Hanzo's words only). Shared changes requested (docs/build-notes/requests/<page>.md): none. Forks this page deleted: the forked x-btn solid Apply buttons (now kit Cta), the portal div sheet with a hand-made focus loop (now a native <dialog>), raw <video> (now kit Film), the floating data-cursor label, hover lifts and image zooms.

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
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js
  • Open copy questions for James listed, none decided

Done here: Header comment in app/beta/page.jsx names Persona, Goal, CTA, Metric signup_start, Signature, Beyond. One solid per screen: kit Cta "Apply" (beta.hero, and one per opened pass beta.<pass>); the header's Try Hanzo turns outline while it is on screen, on desktop (the shell) and on the phone (page-local html[data-ask=quiet] while the hero Apply is seen, as /bounty does). No copy questions.

2. Information architecture and navigation

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

Done here: One <main> from the layout; links via A/Cta; parity links 4/4 (Hanzo's own); the product tiles add links to Hanzo's own /dev, /studio, /kai, /enso and /zen pages; Feedback goes to /login?next=/beta (a button on live, listed for James).

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero; nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; no 3 same-height sections in a row
  • Ends in proof strip, Band, footer
  • Card-to-page links use Morph; title lands within 12px n/a: the passes open into their sheet by shared-element morph (layoutId), not to a new page; the product tiles link to their own pages.

Done here: No label above the h1. "Get there first." (52px) on the left with Hanzo's line and Apply on the right in one row (desktop), so the five tiles sit whole in the 1470×801 first screen (y 259 to 702); the tiles are in the server HTML with their posters (no fade, they only land the last 24px), so a first visit is never blank; the film strip is the one big thing and plays within 1 s. White between rooms is about 100px (rail to passes) and 74px (passes to the close). PageHero is not in the kit yet, so the hero is page-local (left open). The page ends on its own dark close (Feedback 52px, Book a call 26px over Kai's film; the room arrives as a rounded card that opens to full width, then the lines cut in) then the footer; kit Band takes one action, this close has two (left open). JS off: films show posters, every line is in place.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in header and bar after the hero, same label
  • Copy button copies exactly the displayed text; failure never says Copied n/a: no copy control.
  • data-cta and data-thumb on every primary

Done here: Kit Cta only (no raw .x-btn in the page file); data-cta and data-thumb on the hero Apply; after the hero the ask is the header's (the shared bar does not show on /beta, so nothing floats over the page).

5. Trust and proof

  • No logo without documented permission; no seal; no invented number n/a: no logos, seals or figures.
  • Every figure traces to Hanzo's copy; qualifier beside the number n/a: no figures.
  • Marquees pause, freeze under reduced motion, hide duplicates n/a: no marquee.
  • Privacy link and owner line beside every submit n/a: no form on this page; Apply hands off to /beta/apply.

Done here: No figures, logos or seals; only Hanzo's product names and pass sentences.

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 n/a: no table, FAQ, tabs or code.
  • python3 scripts/parity.py /beta: 0 missing

Done here: Parity 12/12 text. Type from MASTER: h1 52px, pass titles 32px (first) and 21px, sheet title 52px while it is the moment, close 52px and 26px; nothing under 13px.

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 passes (greys only); nothing above a headline; tiles 24 radius with a hairline, no box plus shadow; the dark rooms are the first pass and the close, never back to back. Differs from /affiliate (link as type) and /bounty (GitHub window): its hero object is Hanzo's own films.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs are native, trap focus and return it
  • Inputs 16px or larger; no bare :hover
  • Forks this page deleted: the forked x-btn solid Apply buttons (now kit Cta), the portal div sheet with a hand-made focus loop (now a native <dialog>), raw <video> (now kit Film), the floating data-cursor label, hover lifts and image zooms. listed below

Done here: Kit Cta states; the five product tiles answer hover (Kai, Enso, Zen: the film steps up 12px; Dev rewrites its diff and Studio runs its cut again; the hairline turns from faint to grey; the ↗ joins the name), press .97 in 90ms, focus ring; pass tiles answer hover (art drifts up 16px, "+" turns), press .97 in 90ms, focus ring; the opened pass is a native <dialog> via showModal(): focus goes to Close, Esc, the scrim, Close and Back close it, focus returns to the pass.

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 n/a: the shared sound kit is not on main yet; nothing page-local plays sound.

Done here: Signature: the pass grows into its sheet (layout morph, 0.6s standard ease). Time: the films play; Dev and Studio sketches come alive. Pointer: art drift on tiles and passes; Dev and Studio replay their sketch on hover. Scroll: the passes clip in once (0.5s, 60ms apart); the close lines cut in from their mask (0.7s, 60ms). No springs; reduced motion shows final states and pins the rail (no scroll scale or drop), with no hydration mismatch.

10. Media

  • Film and Pic only; sizes and posters set
  • At most 2 videos playing; pause button on loops over 5 s
  • Budgets met; nothing missing; alt on every image
  • No dimmed or filtered photo; 4+ real visuals together where the page has them

Done here: Kit Film and Img only, posters set; Kai, Enso and Zen films play muted, inline; a pause control beside the row stops all of them; at most 2 films play at once on the phone; with JS off the browser's own video controls are hidden, posters only. Design partner: Dev's window sits on the right under the "+" (20px clear), the words keep the left; on the phone the window sits below the "+" and 76px above the title.

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: 375×812: films on the first screen, Apply full width above the fold and the only solid there (the header's Try Hanzo is outlined while it shows), passes stack, the close sets 32/21; no horizontal scroll at 320; targets 44px+.

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.
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: Ink and greys on white at 4.5:1+; white on the dark rooms; one h1; pass titles are h2; the dialog is labelled by its title; the pause control is a real button with its state.

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: h1 in server HTML; films lazy with posters; motion is transform, opacity and clip-path; loops pause off screen ([data-off]); filmed in the cloud.

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

Done here: Title and description unchanged; <JsonLd route="/beta" /> renders canonical and og tags.

15. Catalogue and product pages

  • Model card matches SPEC.md (or n/a: not a catalogue or model page) n/a: not a catalogue or model page.
  • Every card opens by Morph n/a: not a catalogue.
  • Every maker and model page linked in the DOM n/a: not a catalogue.
  • One price figure everywhere n/a: no prices.

Done here: n/a: not a catalogue or model page.

16. Developer experience

  • One CodeBlock; copy equals display (or n/a: no code on the page) n/a: no code on the page.
  • Config blocks parse on their own n/a: no config.
  • Terminal pauses and ends on a static frame n/a: no terminal.
  • No hand-typed version number n/a: no version numbers.

Done here: n/a: no code on the page.

17. States and resilience

  • Loading, empty, error and offline states designed n/a: static page; films fall back to their posters.
  • Blocked live data leaves a complete page, no console errors n/a: no live data.
  • A failed submit keeps its values and shows no success n/a: no form.
  • A thrown island does not blank the page

Done here: Static Hanzo copy; a film that fails leaves its poster; the sheet is an island that cannot blank the page.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js
  • 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/beta.md verdict 8 or more

Done here: data-cta ids beta.hero, beta.a, beta.b, beta.c (kit Cta fires cta_click); V2 line in the route header; conductor review docs/build-notes/review/beta.md 7/10 capped on the card format and the close scale (both fixed: 18-part card, close 52/26), product tiles without hover (fixed: drift, replay, hairline, press) and raw <video> (fixed: kit Film). Round 2 (7/10): phone double solid, rail cut by the fold and blank on first visit, white gaps, Design partner crowding, JS-off controls and reduced-motion scale: all fixed.