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

12 KiB
Raw Permalink Blame History

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

Page file: components/pages/DownloadPage.jsx (+ DownloadPage.css, shared components/v2/AppType.css, x-edison/AppLines) · gallery: docs/gallery/download/ · metric id: build_download

Open copy questions for James: none decided. On phones the main build follows the system the browser reports, as v1 and live do (an iPhone is offered the macOS build); the question of what a phone should be offered is left to James. Shared changes requested: docs/build-notes/requests/apps1.md (a Band with an id prop). The ask is settled by the shared system: the header's solid "Try Hanzo" carries it at every width, with no desktop bar, and the page's own data-thumb ask rides the slim phone bar. The page closes on its own band with <Cta id>. Forks this page deleted: the kicker over the h1 ("Download") and over "Just your files" ("Your kit"); the floating hover tooltips on the dial (the centre now reads the build you point at); the breathing glow loop on the button; the hand-made main button and the hidden data-thumb <i> (now <Cta thumb>); skeleton bars in the four product pictures (now Hanzo's own lines and a model image through kit Img); the solid "Or open Hanzo in your browser" (now a text link beside the repeated ask); spring and overshoot curves; cursor labels; shadows on objects.

Tick what applies. Strike the rest as n/a: reason. Fill each Done here: line with one or two sentences of evidence (a value, a file, a number). A part counts once its Done here: line has text.

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 lib: not merged; the label is Hanzo's "Download for macOS", with the system the browser reports)
  • 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: Top of DownloadPage.jsx names Persona, Goal, CTA, Metric: build_download, Signature and Beyond. check.mjs: 1 solid on the first screen at 1470×801 and 375×812; one <h1> in server HTML ("Download for macOS" is the server's default, as on live).

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 (the Desktop, CLI and extension cards are whole links to /desktop, /cli, /extension)
  • Breadcrumb at depth 2 or more n/a: /download is depth 1
  • Link parity: 0 removed, 0 unexpected

Done here: parity links 19/19 (every build file, /chat, the CLI release page). The three card links are new in-site routes to Hanzo's own product pages, which the download page names.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero (n/a for the part: not merged; the equivalent is the line-mask h1, one lede, one ask, one object); 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 (n/a: no proof figures on the live page), Band (the page's own "One account signs in to all of them."), footer
  • Card-to-page links use Morph (each card's picture carries data-morph; /desktop and /extension heroes carry data-morph-target)

Done here: At 1470×801 the h1 (52px), lede, the one ask and the whole dial (558px) share the first screen; the builds fan out of the button within 1 s (check.mjs: 23 running animations). JS off: 0 invisible text blocks (every pre-fan state is .js-scoped). Rhythm: dial → bento of four tiles → black room → band.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in header and bar after the hero (shared system: the header's solid "Try Hanzo" at every width, no desktop bar; on phones the slim quiet bar carries this page's data-thumb ask once the hero button leaves)
  • Copy button copies exactly the displayed text; failure never says Copied (kit Copy on the two CLI install lines)
  • data-cta and data-thumb on every primary

Done here: The primary appears twice: download-main (thumb, hero) and download-main-end (band), both to the detected system's build. Secondaries are text links (download-every-build, download-browser, download-browser-end, download-cli-all) and card links (download-open-desk|cli|ext).

5. Trust and proof

  • No logo without documented permission; no seal; no invented number
  • Every figure traces to Hanzo's copy (every version and size is live /download's)
  • 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: No counters and no computed totals. The detected rows are marked with a dot (shape, not colour). Parity text 48/48.

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 (build lists are hairline rows of real links; pickers are radiogroups)
  • python3 scripts/parity.py /download: 0 missing

Done here: h1 52px, heads 26–32px, the band statement 44px as the closing moment, body 16px, file names 13px mono (14px on phones, or hidden). Parity text 48/48, links 19/19.

7. Visual design system

  • python3 scripts/taste.py <files> passes
  • No label, tag, badge or pill above a headline
  • Radii, shadows and sizes from tokens; never box plus shadow (tiles are flat #f2f2f2, objects outlined 1px, chips outlined; no shadows)
  • One icon set; no icon in a rounded box (stroke glyphs; the group glyphs sit in a plain grey circle as the group's mark)
  • Differs from neighbours in hero medium and room order

Done here: taste.py OK. The hero medium is a dial of real download links around one button, unlike /desktop's app window, /extension's browser stack and /cli's terminal. One big thing per screen: the dial, then the bento, then the black room, then the 44px band statement.

8. UI component library

  • Every control has hover, press, focus-visible, disabled (n/a: none disabled), loading (the Cta hand-off sets aria-busy when it leaves for GitHub)
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs are native, trap focus and return it n/a: no dialog
  • Inputs 16px or larger; no bare :hover (no inputs; every hover sits in @media (hover: hover))
  • Forks this page deleted: listed above

Done here: Chips, rows, card links, pickers and kit rows have hover (fine pointers), press (scale .97/.98 or 1px), focus-visible and selected states; pickers glide with a 300 ms ease-emphasis tween.

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 (data-sound="tick" on the kit pickers; the card opening whooshes and the solid ask taps through the shared Morph and Sound; the page has no self-running demo, so no 'done')

Done here: Utility page, one delight: the fan-out (arrival, 500 ms per chip, 30 ms stagger) and the ray with the centre readout (pointer). Supporting: magnetic ask (pointer), gliding pickers (state), line-mask h1 (arrival); the black room opening is the only scroll-linked effect. variety.py OK, 0 Rise.

10. Media

  • Film and Pic only (kit Img for the extension card's page picture, 1200×1500 box)
  • At most 2 videos playing; pause button on loops over 5 s n/a: no video
  • Budgets met; nothing missing; alt on every image (the one image is decorative, alt="", 64 KB)
  • No dimmed or filtered photo; 4+ real visuals together n/a: the live page has no photos

Done here: The only raster is Hanzo's /models/uta.webp inside the extension card's drawn browser, lazy-loaded through kit Img.

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: check.mjs at 375×812: h1, lede, the full-width ask and the first product rail on the first screen, CLS 0.000, no small targets. Below 1200px the dial becomes the button over one swipe rail per product (scroll-snap proximity); on phones the chips slide in once.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better (#0a0a0a / #525252 / #737373 on white; white 55% or more on black)
  • Pause control on every moving item n/a: nothing loops; the fan-out plays once in about 1 s
  • Forms labelled; first error focused n/a: no form (pickers are labelled radiogroups with legends)
  • One h1; no heading skips; names start with visible text (each chip's name starts with its product and build)
  • Keyboard reaches every control

Done here: Focusing a chip draws the same ray and readout as pointing at it. The kit list is aria-live="polite".

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized (not measured here: needs a production build)
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: Every chip, row and file name is server-rendered; positions are rounded so server and browser print the same style. The fan-out is CSS transitions started by one class.

14. SEO and machine files

  • Title and description match live (metadata unchanged)
  • Canonical equals og:url equals the live URL (https://hanzo.ai/download/)
  • <JsonLd route> parses; no broken URL
  • Every card is a real link

Done here: app/download/page.jsx keeps its metadata and <JsonLd route="/download" />.

15. Catalogue and product pages

  • Model card matches SPEC.md n/a: not a catalogue or model page
  • Every card opens by Morph (Desktop, CLI and extension cards; Editors has no page of its own on the site)
  • Every maker and model page linked in the DOM n/a
  • One price figure everywhere n/a: no prices

Done here: With the rebuilt Morph, the Desktop card grows into a stage and settles into /desktop's window, and the extension card's picture lands on /extension's stack (filmed at 1470×801, 0 errors). The card titles stay Hanzo's own ("Desktop", "Browser extension") and the heroes' h1s are "Hanzo Desktop" and "Hanzo Extension"; copy is frozen, so they are not made identical.

16. Developer experience

  • One CodeBlock; copy equals display (the two CLI install lines copy exactly as shown)
  • Config blocks parse on their own n/a: no config
  • Terminal pauses and ends on a static frame n/a: the CLI card's terminal is static
  • No hand-typed version number (every version is live /download's own string)

Done here: curl -fsSL hanzo.sh | sh and npm i -g hanzo, each with kit Copy.

17. States and resilience

  • Loading, empty, error and offline states designed (Windows: the kit list says Hanzo's own line, "Desktop ships for macOS and Linux; on Windows the one native build is the CLI.")
  • Blocked live data leaves a complete page, no console errors (no live calls)
  • A failed submit keeps its values and shows no success n/a: no form
  • A thrown island does not blank the page (shared app/error.jsx)

Done here: With GitHub and hanzo.ai blocked in the sandbox the page renders complete with 0 console errors.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js (<Cta> dispatches cta_click)
  • 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/download.md (none yet; the neighbours' reviews were applied pre-emptively)

Done here: data-cta = download-main, download-every-build, download-browser, download-open-desk, download-open-cli, download-open-ext, download-cli-all, download-main-end, download-browser-end.