- 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
/machines coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Machines.jsx · gallery: docs/gallery/machines/ · metric id: signup_start (cta_click machines.hero)
Open copy questions for James: none. Decided by the conductor (7 Nov, DONE.md point 2, copy word-for-word): the derived 2x and 4x prices are dropped; only Hanzo's 1x quote ($3.48, $27.84, $2,540, 80 GB) is printed, and the live 2x / 4x size tabs light their cards with an em dash in the quote. The "Tech specs" label stays out.
Shared changes requested (docs/build-notes/requests/machines.md): cookie card size, the header strip near the page end, the PinChapters crossfade (fixed page-locally), tokens.css (page tokens declared locally until it lands).
Forks this page deleted: the page's own hero shell (Frame Hero), hand-made buttons (.v2-btn became the kit Cta), a second ending (the agent prompt moved mid-page), the sticky phone visual over text (chapters now stack), every spring transition; round 2: the three-column spec wall, the shared GetIt contour close (the close is the page's own rack), the step console's six sets of boxes and its traffic-light dots, the invented console labels, the "Tech specs" label
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 are Hanzo's hero ask (
lib/cta.jsis not on main yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button; prices only from the page's own quote
- Open copy questions for James listed, none decided
Done here: // Persona: to // Beyond: head components/pages/cloud/Machines.jsx; the one solid fill is Hanzo's "Try Hanzo" (#fafafa on black, machines.hero; repeated in the close, machines.close). "View Documentation" is now a text link (white 78%, 1px underline, no fill), so the primary is the only fill in the hero.
2. Information architecture and navigation
- One
<main>; the layout's skip link reaches#main - Every link through
Aor the kitCta; related cards are real links Breadcrumb at depth 2 or moren/a: a depth-1 page- Link parity: 0 removed, 0 unexpected
Done here: Parity 106/106 text and 7/7 links after round 2; Hanzo's header and footer are untouched; the close's GitHub chip and "Deploy to Cloud" go through A/Cta.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- Hero built from the kit's line mask (
Lines) and one object (PageHerois not on main yet); nothing above the h1 - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; loud and quiet sections alternate
- Ends in one close in Hanzo's words ("Get Machines" with the ask), then the footer
- The h1 is the
data-morph-target, so cards elsewhere open into it
Done here: At 1470x801 the $3.48 / h moment now sits at y 626 to 711, inside the fold, and the rack and quote stay inside the gutters (.mc-rent 85 to 1385; Lift settles from 1.04, not 1.12). Section breaks alternate 116 and 188px (specs 116/72, uses 188/116, own 72/116, ship 116/72, close 116) instead of 161.7px everywhere. The close is the page's own object: the four-card rack waking one card after another.
4. Conversion system
<Cta>only; no raw.x-btnin the page- Sticky ask: the shared ask bar carries the hero label (
data-thumb) - Copy buttons copy exactly the displayed text (kit
CodeBlock/Copy) data-ctaanddata-thumbon every primary
Done here: Hero <Cta thumb id="machines.hero">Try Hanzo</Cta> with a 2px rise and a white ring on hover (measured translateY(-2px), outline white 55%); the close repeats it (machines.close) beside "Deploy to Cloud" (machines.deploy, link).
5. Trust and proof
- No logo, seal or invented number
- Every figure traces to Hanzo's copy
Marquees pause, freeze, hide duplicatesn/a: no marqueePrivacy link beside every submitn/a: no form submits
Done here: $3.48, $27.84, $2,540, 80 GB and every spec value are Hanzo's; no derived price and no dash: the big quote is always Hanzo's 1x H100 figure, labelled "1x H100", and 2x/4x light their cards and rewrite the request while the quote dims to 60%.
6. Content presentation (copy untouched)
- No text under 13px (14px on phones) except 11–12px mono capitals and the kit's own copy label
- Measures held; headings balanced
- Code uses the kit
CodeBlock python3 scripts/parity.py /machines: 0 missing
Done here: Parity 106/106 text and 7/7 links. The renting steps are a plain numbered list of Hanzo's own sentences (no console echoing them); the zoom sheet prints only Hanzo's H100 values; no label outside Hanzo's copy remains.
7. Visual design system
python3 scripts/taste.pypasses (deck greys only; no hue)- No label, tag, badge or pill above a headline
- Radii 28 (objects), 16–24 (tiles); one shadow per raised object
One icon setn/a: no icons beyond the kit's and the GitHub mark- Differs from neighbours in hero medium and room order
Done here: Every value in Machines.css reads a page token (--mc-* on .mc, the deck ramp only: #000 to #fff, #e4e4e7); the off-deck Apple greys (#f5f5f7, #1c1c1e, #111112, #161617, #2c2c2e, #e3e3e6) are gone. tokens.css is not on main, so the tokens are declared once on the page (requested). The stale "Accent: green" comments are deleted.
8. UI component library
- Every control has hover (inside
@media (hover:hover)), press .97, focus-visible, disabled - Focus ring is the shared system's
Dialogs are native, trap focus and return itn/a: no dialog on this page- Inputs 16px or larger; no bare
:hoverin the page CSS - Forks this page deleted: listed above
Done here: Measured hovers: size tabs #a3a3a3 to #fafafa; spec rows, owner rows and related links fill #f5f5f5; tiles tilt (up to 2.5°) and run their diagram; the chapter dots get a soft well. Desktop walk: 1 of 14 hover targets unchanged (the size tab that was selected). Tapping the selected size re-rolls the quote.
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups (
variety.pyOK) - 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
setIntervalin the page (timers aresetTimeoutchains) - Sound only on the listed moments, through the one kit (
lib/sound.js, wired bycomponents/Sound.jsx): the ask taps, tabs, radios and pause toggles tick (radios carrydata-sound="tick"), copy chimes; the demos loop while seen and never finish, so no done chime
Done here: Five entrances, one per section (8 Nov: the CSS for all five now exists in Machines.css): glitch-in on the hero h1 and lede, a diagonal wipe that uncovers the zoom stage (it watches its section, since its own empty clip never intersects), the uses content snapping up with an overshoot, a page curl peeling off the renting steps from the bottom-right, and a grey grain dissolving off the ownership rows. Idle: the size cycle (first tick 1.2 s, then 4 s), the lit card's LED, the ownership map walking its three parts. Pointer: zoom scrubbed by scroll on fine pointers, tile tilt, row and step hovers. State: size tabs with a gliding pill, the rail, the zoom in/out button. Arrival: 80 counts up from 10 when the sheet first shows.
10. Media
n/a: no photo or film on Hanzo's pageFilmandPiconlyAt most 2 videos; pause on loopsn/a: no video- Nothing missing; no image without alt
No dimmed photo; 4+ real visuals togethern/a: Hanzo's page has no imagery
Done here: Product objects are drawn in HTML and CSS from Hanzo's words: the hero rack and quote, the single H100 card by its specs, the renting console, the tile diagrams and the closing rack.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320 (scrollWidth 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 four hero cards stand side by side so the $3.48 quote reaches the first screen; the zoom shows six racks in three columns (the lit card in the middle of the second row) and zooms itself on arrival, with a tap to zoom back out; the H100 sheet stacks (52px figure); the two spec lists stack (they ran off the right edge before 8 Nov); steps and owner rows one column; tiles on a snap rail. 320: scrollWidth 320, size tabs and account names fit their boxes.
12. Accessibility (WCAG 2.2 AA)
- Contrast: #0a0a0a and #525252 on white and #f5f5f5, #a3a3a3 and white on black
- Pause control (Cloud 3's
LivePause, 44px,aria-pressed) on every self-running object - Forms labelled (no form fields)
- One h1; no heading skips
- Keyboard reaches every control
Done here: Headings now run h1, then h2 (26px: NVIDIA H100, How renting one works, When you want a whole machine, Whose machine it is, Paste and ship, Get Machines) with h3 at 21px under each; the spec sheet no longer jumps from h1 to h3. The docs link is white 78% on black (well over 4.5:1).
13. Performance and engineering
- h1 and the hero object are in the server HTML
- Transform, opacity and clip-path only; demo timers run only while on screen
- No poller; no third-party request
- Nothing heavy run on James's laptop (filmed in the cloud)
Done here: New motion is transform, opacity and clip-path (row fills are ::before opacity, the cell fills ::after scale; the related links fade a background colour like the kit buttons); the count uses Motion's animate once; timers stop off screen and when paused (useLive, useSteps).
14. SEO and machine files
- Title and description from
content/pages.json - Canonical through the shared
<JsonLd route="/machines" /> <JsonLd route>renders; no broken URL- Every card is a real link
Done here: app/machines/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/machines" />.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.mdEvery card opens by Morphn/a: no catalogue cardsEvery maker and model page linkedn/a: not /models- One price figure everywhere (the page's own quote)
Done here: n/a for cards: a top-level cloud product launch page; one rounding rule for every quote figure (cents on hour and day, whole dollars on the month).
16. Developer experience
- One
CodeBlock; copy equals display Config blocks parse on their ownn/a: no config blockTerminal pauses and ends on a static framen/a: no typed terminal- No hand-typed version number
Done here: Hanzo's agent prompt uses the kit CodeBlock (via ShipPrompt); it wraps on the page (pre-wrap), and Copy still copies exactly the displayed text.
17. States and resilience
- Every state looks intended: static copy, reduced motion and JS off checked
- No live data, so nothing to block; no console errors
A failed submit keeps its valuesn/a: no form posts anywhere; the page's inputs are in-page demos and nothing is sent- A thrown island leaves the page: the shared
app/error.jsxkeeps header and footer
Done here: Server HTML carries the true 80 (the count only arms when the figure is below the fold and motion is allowed); reduced motion lights the H100 card and the closing rack at once. Console: only the shared FooterHTML hydration mismatch.
18. Measurement and handover
data-ctaon every primary (the kitCtasendscta_click);lib/track.jsis not on main yet- Nothing identifier-bearing; no field value in any payload
V2: 8/10line in the page file's top comment- Review read:
docs/build-notes/review/machines.md(6/10), all ten fixes worked through
Done here: machines.hero, machines.close and machines.deploy on the asks. Gallery: docs/gallery/machines/ (desktop.jpg, phone-1.jpg, phone-2.jpg refreshed 8 Nov; earlier round stills kept).