- 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
11 KiB
/computer coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/ComputerPage.jsx (+ ComputerPage.css, shared components/v2/AppType.css, AppStage, AppScenes) · gallery: docs/gallery/computer/ · metric id: signup_start
Open copy questions for James: none decided.
Shared changes requested (docs/build-notes/requests/apps1.md): only the Band id prop is still open (this page closes on its own Band markup with <Cta id> until then). The header ask and the phone ask bar landed in the shared system, so data-ask="off" is gone from <main>.
Forks this page deleted: two kickers over headlines ("computer.hanzo.ai", "Before you run it"; both now captions under their text), the outlined "Documentation" and "View on GitHub" buttons (now text links), the solid "Deploy to Cloud" (now a text link before the Band), the "-with-ocr" / "-with-som" chips and the voice pill that floated over the desktop (the voice now lights in the desktop's own menu bar), raw <img> (now kit Img), spring transitions, the motion pathLength tick (now a CSS stroke), the violet hue, grey bars where the desktop's windows had text (now Hanzo's lines).
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 own "Try Hanzo Computer" → computer.hanzo.ai) - 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 comment names Persona (someone stuck with software that has no API), Goal, CTA, Metric: signup_start, Signature and Beyond. check.mjs: one solid on the first screen at both sizes; one <h1>.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Go,Moreorhref(); every card a real link Breadcrumb at depth 2 or moren/a: /computer is depth 1- Link parity: 0 removed, 0 unexpected
Done here: parity reports links 4/4 (computer.hanzo.ai, docs.hanzo.ai, github.com/hanzoai/computer, platform.hanzo.ai/deploy).
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 kit 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,
Band, footer (the repo meta "Apache-2.0 · hanzoai/computer · 3 stars" sits just before the Band "For the software with no API") Card-to-page links use Morphn/a: no cards; the desktop carriesdata-morph-target
Done here: At 1470×801 the h1 (52px), lede, "Try Hanzo Computer" and the desktop share the first screen; the agent cursor travels and the pixel grid scans within 1 s (check.mjs: 54 changes, 2 animations). Order: black hero → 3 pinned lenses → pre-flight → paste and repo → black Band (two black rooms, never back to back; the Band opens from a rounded card).
4. Conversion system
<Cta>only; no raw.x-btn- Sticky ask in header and bar after the hero, same label (the shared header always carries a solid "Try Hanzo"; on phones the slim quiet bar carries this page's own
data-thumbask; no floating bar on desktop) - Copy button copies exactly the displayed text; failure never says Copied (kit
Copy) data-ctaanddata-thumbon every primary
Done here: The primary appears twice: computer-hero-try (thumb) and computer-band-try. Text links: computer-hero-docs, computer-deploy, computer-band-github.
5. Trust and proof
- No logo without documented permission; no seal; no invented number
- Every figure traces to Hanzo's copy; qualifier beside the number ("3 stars", "2009", "twenty pixels" only)
Marquees pause, freeze under reduced motion, hide duplicatesn/a: no marqueePrivacy link and owner line beside every submitn/a: no form
Done here: The pre-flight meter shows how many of the three warnings you ticked (0 to 3, your own count), never a counted or invented figure.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals (the desktop's window titles hide on phone, where the render is too small for them)
- Measures held; no orphan word in a heading
- Tables, FAQ, tabs and code use the kit parts (the six modes are real tabs; the agent prompt is kit
Copy) python3 scripts/parity.py /computer: 0 missing
Done here: Parity text 33/33, links 4/4. Lede 21px (19px phone), body 16px, captions 12px mono capitals.
7. Visual design system
python3 scripts/taste.py <files>passes; no literal hex outside tokens (deck greys only)- 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 OK; check.mjs 0 labels over headlines. The only page in the group whose hero is a black room with a full-bleed desktop; /bot is an org chart beside its headline, /design a workspace window under oversized type.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading (pause, tabs, checks: press scale .97, hovers in
@media (hover: hover)) - 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 - Forks this page deleted: listed above
Done here: The three checks are role="checkbox" buttons with aria-checked, a drawn stroke tick and a 48px box; arrow keys move between the six mode tabs.
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups (variety.py: magnetic, layoutId, useScroll, clip reveal; 0 Rise)
- 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 (
lib/sound.js; tabs, switches and pressed buttons tick throughcomponents/Sound.jsx)
Done here: Idle (the cursor works the desktop through six modes), pointer (magnetic ask), state (tab pill at 300ms ease-emphasis, ticks drawing), time (the field fills after the click), arrival (h1 line cut-in), scroll (Stage settle, pinned lenses, the Band opening). No springs. Sound: play('done') when all three pre-flight warnings are checked; data-sound="tick" on the three checks. 8 Nov: a picked hero step holds for about 14 s, then the demo carries on by itself, so the hero is never left frozen.
10. Media
FilmandPiconly; sizes and posters set (kitImg, 1600×900,priorityon the desktop wallpaper)At most 2 videos playing; pause button on loops over 5 sn/a: no video- Budgets met; nothing missing; alt on every image (the wallpaper is decorative,
alt="") - No dimmed or filtered photo; 4+ real visuals together where the page has them (n/a in part: one Hanzo image, Mori's wireframe, as the wallpaper)
Done here: The wallpaper is Hanzo's own /models/mori.webp, shown undimmed.
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, one solid, the moving desktop and its pause control in the first screen, CLS 0.000, 0 small targets; the desktop becomes 4:3 and the lenses stack.
12. Accessibility (WCAG 2.2 AA)
- Contrast measured, text at 4.5:1 or better (#fafafa and white 78% on black; #0a0a0a / #525252 on white)
- Pause control on every moving item (the desktop's pause is its first control, 44px,
aria-pressed) Forms labelled; first error focusedn/a: no form- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: The desktop render is aria-hidden; its six modes are told by the tab labels and the chapter text.
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: The cursor and overlays are transform and opacity only; the mode timer stops off screen and while paused.
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="/computer" />) <JsonLd route>parses; no broken URL- Every card is a real link
Done here: app/computer/page.jsx keeps Hanzo's metadata and renders <JsonLd route="/computer" />.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.mdEvery card opens by Morphn/aEvery maker and model page linked in the DOMn/aOne price figure everywheren/a: no prices
Done here: n/a for every item: /computer is a launch page with no catalogue or prices.
16. Developer experience
- One
CodeBlock; copy equals display (the agent prompt copies exactly the displayed line) Config blocks parse on their ownn/a: no configTerminal pauses and ends on a static framen/a: no terminal demo- No hand-typed version number
Done here: Copy gives "Read https://hanzo.ai/skill.md and use Hanzo Computer in my project. Start with: hanzo desktop", the line shown.
17. States and resilience
- Loading, empty, error and offline states designed (n/a in part: no live data)
- Blocked live data leaves a complete page, no console errors
A failed submit keeps its values and shows no successn/a: no form- A thrown island does not blank the page
Done here: No live calls; look.mjs and check.mjs report no console errors at either size.
18. Measurement and handover
data-ctaon every primary; events only throughlib/track.js(kitCta)- 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/computer.mdverdict 8 or more (no review yet)
Done here: data-cta ids: computer-hero-try, computer-hero-docs, computer-deploy, computer-band-try, computer-band-github.