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

16 KiB
Raw Permalink Blame History

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

Page file: components/pages/Customers.jsx + Customers.css · route: app/customers/page.jsx · gallery: docs/gallery/customers/ · metric id: contact_sales_submit

Open copy questions for James:

  • (1) May the backer names and logos show? PLAN 1.3 #3 / MASTER part 5. They show as live shows them, as names only, with no tiles.
  • (2) May "Case studies" stay as the caption under the plate? It is Hanzo's heading, moved below the plate.
  • (3) There is no current proof (benchmarks, GitHub figures) on this page's copy to put above the 2015–2020 cases. Should any be linked in?
  • (5) The index keeps Hanzo's own order: SKULLY first, as on hanzo.ai. An earlier build moved it after Triller; that change is reverted, so there is nothing to decide.
  • (4) $8.4M and $7M+ sit on the plate beside the case year. Both come word for word from the case pages, with the year as the case copy prints it.

Shared changes requested (docs/build-notes/requests/customers.md):

  • Filed: the media mirror into public/, a hold cap inside the shared openDoor (wrapped page-locally here), and the header ask (shared chrome, unchanged).
  • Also noted: a shared BACKERS module (lib, Data chat) and a register string for the em dash.

Forks this page deleted:

  • The hand-rolled case tabs, now kit Tabs.
  • The overprinting stage hand-off: it now runs exit then enter (mode="wait").
  • The pointer preview card, replaced by the stage.
  • The seven backer tiles.
  • The data-morph plate, now doorway.
  • The springs.

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. Hanzo's own "Talk to us"; lib/cta.js does not exist yet.
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button. n/a: prices (none on this page).
  • Open copy questions for James listed, none decided

Done here: one ask, "Talk to us" (/contact), sits beside the lede at 1470×801 (x=820, y=425–473) and at 375×812 (y≈408). It appears again in the shared bar after the hero and in the close. The header's "Try Hanzo" turns to outline while it shows.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it. Both come from the layout.
  • Every link through A, Go, More or href(); every card a real link
  • n/a: breadcrumb (depth 1 page)
  • Link parity: 0 removed, 0 unexpected

Done here: parity links 10/10. Both case plates are real <a href> links to /customers/damon-motorcycles and /customers/kanoa.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero (the kit equivalent until it merges: MaskLines h1, lede, one ask); 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. The close is the page's own "Launch with us" band.
  • Card-to-page links open into their page. The doorway is used instead of Morph, which times out site-wide (reported by the conductor).

Done here:

  • Arrival order: the h1 cuts in first, as the company MaskLines CSS at first paint (+0.5s). Then the lede and ask (CSS, 0.95s), then the plate (1.15s). Playwright saw the h1 visible at 1.34s, the lede at 1.46s and the plate at 1.72s.
  • First screen at 1470×801: the figure block sits in the plate's upper half, so $8.4M is on screen at y 638–739.
  • The plate turn: Damon to KANOA, then back to Damon, then it rests. Each case has its own tone: a graphite gradient, with a lighter Sigil on KANOA. The incoming text arrives at 0.25s, so the wipe edge reads.
  • Rhythm: hero, plate, launch scene, a quiet names row, the black close.
  • JS off: the MaskLines and page <noscript> rules stack both cases readably and set the phone figures in place. Playwright with JS disabled: both cases position: relative, clip-path none, text opacity 1, at 1470 (526–1131, 1131–1736px) and at 375 (465–928, 928–1391px; phones get a 4/5.4 box so the text no longer overlaps); the logo boxes and the static phone strip are hidden. CSS keyframe arrivals pause only while html.x-arriving is set. A Playwright run with JS disabled found 0 faint or offset text.

4. Conversion system

  • No raw .x-btn. The asks are one page-local pill; kit Cta has not merged.
  • Sticky ask in header and bar after the hero, same label
  • n/a: copy button (none on this page)
  • data-cta and data-thumb on every primary

Done here: data-cta="customers.hero" and customers.close, both with data-thumb="Talk to us". The hero is now its own section, so the shared bar takes over as soon as the hero ask leaves view. This closes the gap the review found.

5. Trust and proof

  • No seal; no invented number. Logo permission is an open question (above).
  • Every figure traces to Hanzo's copy; qualifier beside the number
  • Marquees: none. The closing figure rows move only with scroll.
  • n/a: Privacy link (no form on this page)

Done here:

  • Figures come from the page copy, plus $8.4M and $7M+ from the case pages' own copy.
  • Years appear only where the case copy prints them. Undated launches show an aria-hidden dash.

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. The case tabs are kit Tabs.
  • python3 scripts/parity.py /customers: 0 missing

Done here: parity text 72/72, links 10/10. The lede is 44ch and the row text 44ch. The "01"/"02" marks are gone.

7. Visual design system

  • python3 scripts/taste.py <files> passes. Literal hex values are deck values only (#0a0a0a, #525252, #737373, #f5f5f5, #ededed, #262626, #000).
  • No label, tag, badge or pill above a headline
  • Radii, shadows and sizes from tokens; never box plus shadow. The plate shadow was removed, and the stage and plate are flat fills.
  • One icon set (one arrow glyph); no icon in a rounded box
  • Differs from neighbours in hero medium and room order

Done here:

  • Scale has rhythm (round 2, JAMES 1). Measured computed sizes:

    • h1 52px (phone 40px);
    • "Every launch", "Backed by builders." and "Launch with us" all 26px;
    • index names 21px (phone 17px);
    • stage figure 64px at rest (it arrives at 84px as the moment, then settles);
    • second stage figures 26px.

    One big thing per screen: the plate's $8.4M (112px) on the first screen, the stage figure in the index, and the sliding close figures (176px). These are page-local overrides of company/deck.css; the shared file is untouched. Headings are 497, and figures are Air 220.

  • The plate never prints the case name twice. A missing logo leaves the corner to the year only ("2020", "2015"), and the h3 carries the name.

  • Container 1152, sections clamp(72px, 11vw, 188px), buttons 48px.

  • Radii are deck values: plate 20 (art card), stage 24 (tile), pills full. These are literals in page CSS because tokens.css has not merged.

  • The row sheet ends 12px short of the stage.

  • One black room (the close). The plate is a card, not a room.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading (n/a: nothing loads)
  • Focus ring visible on every stop of a Tab crawl. The ring is 2px ink with a white halo.
  • n/a: dialogs (none)
  • n/a: inputs (none); no bare :hover. All hovers sit in @media (hover: hover).
  • Forks this page deleted: listed above

Done here:

  • The year chips are aria-pressed buttons whose gliding pill now has size (111×48).
  • The case tabs are kit Tabs (arrow keys, Home/End). Every page control presses at .97: the asks, the years, the wall and the plate arrow.

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
  • n/a: sound (the shared kit has not merged)

Done here:

  • Signature (round 2): the launch stage rolls like a slot. As each row crosses the middle, or under the pointer, the outgoing panel rises out of the stage's mask while the incoming one rises in right behind it: 400ms ease-in-out each, edge to edge.
    • Measured by scrolling the index continuously in 60px steps (26 samples): the stage was never blank (0/26), two panels were in flight in 10 samples, and they overlapped by 0px, so nothing overprints. The old exit-then-enter gap read blank in 6 of 30 samples in the review.
    • The lead figure arrives as the moment (scale 84/64, or 1.15 for long figures), holds about 1.1s, then settles to its 64px rest (500ms). Long figures ("120,000 ETH") rest at 44px. Every figure stays on one line.
  • Phone, one number once per screen: while a row is the one being read, its own first figure fades out (300ms), because the strip carries it. Sampled 12 swipes: the strip's figure never appeared twice on screen (0/12).
  • Phone scene: a slim sticky strip (64px) sits right under the year rail (rail 60–121px, strip 121–185px at 375×812) and carries the first figure and label of the row crossing the middle, swapping as the desktop stage does (out 150ms rising 16px, then in 300ms ease-emphasis, AnimatePresence mode="wait"). Playwright, scrolling 300px at a time through the index: $2.5M → 250,000 → $135K → 120,000 ETH → $500M → $650M → €150M → 169M → Cover Build → Myle Tap → Personas Social, with exactly one strip layer each time. Rows also still read in (name to ink, figures settle once). Under reduced motion the strip swaps with no movement.
  • Supporting: the line-mask h1; the plate's turn (Damon, KANOA, back to Damon, rest), where the outgoing text fades in 0.15s before the edge crosses it; the closing figure rows sliding with scroll.
  • State: the year filter closes the list up with a 300ms glide.
  • Kinds: arrival, idle, pointer, state and scroll; scroll is 2 of 6. Idle in the index: the stage dot for the launch being read gives off a slow 1px ring (2.4s ease-in-out loop, off under reduced motion), so the mid-index screen is no longer still.
  • Film (film.mjs motion customers-run3, before the dot): desktop layout shift 0.000, 1 still screen (the mid-index, now answered by the dot); phone 0.000, 0 still screens. The desktop "DEAD hover" lines (asks, years, tab) are the tool's headless Chromium reporting (hover: hover) false (puppeteer check). Playwright shows the ask going #0a0a0a → #262626 on hover. The phone's "DEAD tap" is a tap on the already-selected case tab.
  • No springs. The kit Tabs pill is the kit's own.

10. Media

  • Pic (kit Img with a fallback) only; sizes set
  • n/a: videos (none)
  • Alt on every image (covers carry their case alt, logos are decorative or named)
  • No dimmed or filtered photo. The plate uses only a gradient under its text. 4+ visuals together: n/a, the page has two covers.

Done here: covers and logos are referenced at Hanzo's /public paths. They are not mirrored into this repo's public/ (MASTER part 10, a shared media task): dev pulls them from hanzo.ai by rewrite, and the static export would need the mirror. In this cloud box they are blocked, so the films show the Sigil fallback and the names.

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:

  • At 375 the ask's bottom is at y≈471.
  • At 375 the year chips become a sticky rail under the header. It marks the year being read and scrolls to keep it in view.
  • Row figures show inline on phones; the stage is desktop-only.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better: #525252 on white is 7.8:1, #737373 on white 4.7:1, white on #000.
  • Pause control on every moving item. The plate moves once and stops; the tabs stop it.
  • n/a: forms
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here:

  • Plate cases are role=tabpanel, labelled by the kit tabs; inactive ones are inert. Hydration check: at starts at 0 on the server and on the first client render, so inert and aria-hidden match. Reduced motion is read with the hydration-safe useCalm (false until mounted). A real reduced-motion mismatch from useReducedMotion was found and fixed in round 1. No attribute mismatch was logged in this round's 8 Playwright loads.
  • Row figures stay in the accessibility tree on desktop (visually hidden), while the stage is aria-hidden.
  • A year tap announces one line through a role=status count ("2018: 3 launches"), not the whole list.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • Every image sized
  • No poller (one IntersectionObserver); no third-party request
  • Nothing heavy run on James's laptop (filmed in the cloud)

Done here: transform, opacity and clip-path only. The plate timer runs only while it is in view and after arrival.

14. SEO and machine files

  • Title and description match live
  • Canonical: from the layout (shared owner)
  • <JsonLd route="/customers"> unchanged
  • Every card is a real link

Done here: metadata unchanged in app/customers/page.jsx. All rows, both cases and every figure are in the server HTML.

15. Catalogue and product pages

  • n/a: model card (not a model page)
  • Every card opens into its page (doorway; Morph is broken site-wide)
  • n/a: maker and model pages
  • n/a: prices

Done here: the plate opens Damon and KANOA by the doorway. The ink grows from the plate's rectangle, and the case page lifts it (useArrival in Story.jsx). The hold is capped at 700ms: if the page hasn't lifted the ink by then, the page cuts to it.

16. Developer experience

  • n/a: no code on the page

Done here: n/a. The page has no code, terminal or config.

17. States and resilience

  • Loading and error: a missing cover shows a Sigil plate, a missing logo shows its name. Empty and offline: n/a (static copy).
  • Blocked live data leaves a complete page, no console errors
  • n/a: no submit
  • A thrown island does not blank the page (Sigil is only a fallback)

Done here: with hanzo.ai blocked (this box), the page is complete. The only console lines are the browser's "Failed to load resource" 404s for the remote covers and logos (request 1). There are no script or hydration errors at 1470×801 or 375×812, with or without reduced motion. A reduced-motion hydration mismatch in the plate's line (useReducedMotion read on the first client render) was fixed by switching to the hydration-safe useCalm.

18. Measurement and handover

  • data-cta on every primary. lib/track.js does not exist yet.

  • Nothing identifier-bearing; no payload

  • V2: 8/10 … in the page file's top comment

  • Review read: docs/build-notes/review/customers.md re-run was 7/10. Its fixes are done:

    • the phone scene (a sticky figure strip that swaps one in, one out, plus rows reading in);
    • the stage hands off in sequence;
    • "120,000 ETH" is on one line;
    • the h1 leads;
    • $8.4M is above the fold;
    • each case has its own tone, and text arrives at 0.25s;
    • the sheet stops short of the stage;
    • press is .97;
    • radii are 20 and 24;
    • the doorway hold is capped;
    • Hanzo's order is kept;
    • aria-live is narrowed;
    • the card is corrected.

    Round 2 (7/10, scale): all five fixes are in.

    • Scale rests at h1 52 / headings 26 / names 21, with one big figure per screen.
    • The phone strip never doubles a figure.
    • The plate never prints the name twice.
    • The stage is never blank.
    • Hydration was checked.

    The next review is pending.

Done here: verified by Playwright on the dev server: filter 11→3→11, pill 111×48, row sheet opacity 1, stage figures Bellabeat 250,000 → Unikrn 120,000 ETH → Palladium €150M as you scroll, no console errors.