- 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
12 KiB
/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,Moreorhref(); every card a real link (the Desktop, CLI and extension cards are whole links to /desktop, /cli, /extension) Breadcrumb at depth 2 or moren/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:0on 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 carrydata-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-thumbask once the hero button leaves) - Copy button copies exactly the displayed text; failure never says Copied (kit
Copyon the two CLI install lines) data-ctaanddata-thumbon 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 duplicatesn/a: no marqueePrivacy link and owner line beside every submitn/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
Ctahand-off setsaria-busywhen it leaves for GitHub) - Focus ring visible on every stop of a Tab crawl
Dialogs are native, trap focus and return itn/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
FilmandPiconly (kitImgfor the extension card's page picture, 1200×1500 box)At most 2 videos playing; pause button on loops over 5 sn/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 togethern/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 itemn/a: nothing loops; the fan-out plays once in about 1 sForms labelled; first error focusedn/a: no form (pickers are labelledradiogroups 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 matchesn/a: not a catalogue or model pageSPEC.md- 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 DOMn/aOne price figure everywheren/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 ownn/a: no configTerminal pauses and ends on a static framen/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 successn/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-ctaon every primary; events only throughlib/track.js(<Cta>dispatchescta_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.