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

17 KiB
Raw Permalink Blame History

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

Page file: components/pages/cloud/World.jsx · gallery: docs/gallery/world/ · metric id: cta_click:world.primary

Open copy questions for James: none: every visible word is Hanzo's. Each is in content/ui-strings.json as needs_james; until approved the control is icon-only or the name is for screen readers only. Shared changes requested (docs/build-notes/requests/world.md): StageHero's phone pin keeps its sticky top offset (worked around in World.css); the footer hydration mismatch the critic logged. Forks this page deleted: the blue arcs and cyan accent (greys now), the blinking monitor lights, the centred hero shared with /search.

Measured on the dev server at 1470×801, 375×667 and 320×640 with audit.cjs (Playwright), JS on and off.

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
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js
  • Open copy questions for James listed, none decided

Done here: Persona is a team running models in production who wants one view of them; the one ask is Hanzo's "Open World Monitor" (data-cta primary in the hero, "close" as the later solid), metric cta_click:world.primary. lib/cta.js is not merged yet, so the label is the live page's own. h1 count 1. "Free for the first million events / month." is Hanzo's line, printed as written. Every button changes something on screen.

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
  • Breadcrumb at depth 2 or more (n/a: /world is depth 1)
  • Link parity: 0 removed, 0 unexpected

Done here: <main id="main">; the layout's "Skip to content" targets #main. 6 links in main, all through A or Cta. python3 scripts/parity.py /world reports every live link present. No breadcrumb: the page sits at depth 1.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero; 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
  • Card-to-page links use Morph; title lands within 12px (n/a: no card on this page opens another page)

Done here: Hero is side (copy at left, the globe at right), dark; the object is a turning globe with requests arcing to the GPUs that served them, and latency by model ticking, so the globe turning from paint moves within the first second. PageHero is not merged; the existing equivalent (StageHero or the page's own hero with the same line-mask cut-in, 700 ms ease-emphasis) is used, and the mono caption sits under the h1. JS off: h1 "Hanzo World" at opacity 1, 0 hidden headings or paragraphs. Rooms: hero (dark) → the control room of six monitors (light) → closing band (dark). One in, one out: on desktop the globe shrinks to .9, rises 24px and slows its spin across the hero's last stretch (from about y=140; scale .95 by y=600), and the hero object is min(590px, 70svh) so the latency panel clears the 801 fold (bottom 792). Then the room pins (about 3 screens of scroll) with one large monitor on air at a time; the heading, the rolling 64px "0n" figure 44px under it and the numbered rail of six sit as one block on the floor of the left column. Each drawing is sized to the stage (topology 384px, latency 292, drift 284, replay 289, clouds 251, evals 232 of a 481px picture at 1470x801). Scroll swaps the monitor as a cut: the old one leaves alone in 150ms with its header and caption hidden at once, the new one's opacity waits those 150ms (0 frames with two monitors visible in a 120-frame burst of 40 wheel notches through all six swaps). While pinned the monitor shows no counter of its own (the 64px figure and the rail already count; it keeps its header hairline), so one fact has two marks, not three. The drawings read as product UI: latency lanes under a P50 / P95 / P99 key (the hero panel's own labels, a swatch of each lane's fill), the two evals as 16px score rows on a pale track with a 1px ink baseline and quarter gridlines, and the five sources sized to their names (no row of equal tiles) above a hairline-framed "One unified view", so the room has no solid fill. The room hands straight to the band with no white gap. Phones: the six ride a sideways snap rail (cards 78vw, next card peeking 14.5%, scroll-snap-type: x proximity) under the rolling "01 / 06"; the topology runs top to bottom there so no nodes collide. Each phone card is as tall as Replay, so its drawing takes the spare height and centres in it (no blank strip above the caption). Reduced motion on desktop stacks the six (7/5, 12, 5/7, 12, never three equal boxes), and the hero object drops to min(520px, 62svh) with the pin's sticky offset cleared, so at 1470x801 the globe and panel end at y=621 with the stage (0px overhang onto the room, was 60). The live page has no proof strip, so it ends on the band and the footer.

4. Conversion system

  • <Cta> only; no raw .x-btn
  • Sticky ask in header and bar after the hero, same label
  • Copy button copies exactly the displayed text; failure never says Copied
  • data-cta and data-thumb on every primary

Done here: 0 .x-btn without data-cta in main; CTAs found: primary*, primary-2, close*, close-documentation, deploy (* = solid). The header carries the sticky ask at every width; the page bar is off (data-ask="off") because the critic's shared note (15:00) fails any pill seen over content. Copy is the kit Copy, which copies the prompt string it shows. 1 data-thumb in main. data-ask="off" is gone: on desktop the header is quiet ("Try Hanzo" outlined) while the hero's "Open World Monitor" shows, then carries "Open World Monitor" solid; the phone header's solid "Try Hanzo" is the shared phone branch.

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
  • Marquees pause, freeze under reduced motion, hide duplicates (n/a: no marquee)
  • Privacy link and owner line beside every submit (n/a: nothing is submitted)

Done here: No partner logos; product names appear as text only. Parity holds every printed figure. Demo values (counts, offsets, machine names) are labelled examples in the header comment and drawn as objects, not claims.

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
  • python3 scripts/parity.py /world: 0 missing

Done here: Small text: 0 runs under 13px on desktop, 0 under 14px on the phone (mono capitals excepted). Sizes follow the deck: h1 52px (40 phone), section heads 26px, h3 17px (21px only on the monitor on air), lede 20px, body 15px, the on-air figure 64px Air, growing only in their moment. Replay step labels wrap to two lines instead of ellipsis (0 truncated labels at 1470 and 375; the only clipped node is the screen-reader name of the range). Lede 44ch, body 66ch, headings balanced. Code: the agent prompt in the band. Parity: 0 missing.

7. Visual design system

  • python3 scripts/taste.py <files> passes; no literal hex outside tokens
  • 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 on the page JSX and CSS and the Cloud 4 shared files; only the deck neutrals and #e4e4e7. Captions sit under headings. Radii 6, 8, 12, 16, 20, 24 (28 on the search composer only); objects are outlined with a hairline and carry no shadow. Icons are one inline 16px stroke set. /search keeps the centred hero; World is side and dark.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs are native, trap focus and return it
  • Inputs 16px or larger; no bare :hover
  • Forks this page deleted: listed below

Done here: Hover sits under @media (hover: hover): the hero ask turns brand silver #e4e4e7 and leans toward a fine pointer (at most 8px, from 22px out); a monitor draws a hairline across its header; a rail stop inks and its title steps 6px right. Press is scale .97 to .98 in 90 ms; focus-visible draws a 2px ink or white ring; disabled controls drop to 40%. Nothing on the page loads data, so no loading state. Dialogs: none. Inputs: the replay range input (labelled "Forensic Replay"). Forks deleted: see the top of this card.

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 (n/a: the page plays no sound of its own; the kit owns it)

Done here: Signature: every model, everywhere, live (canvas globe); the hero panel's drift line always holds its slot, at 30% while production holds and 92% (rising 4px) when the alert fires, opacity and transform only. Supporting: latency bars ticking (time), the pinned control room (useScroll, the only counted technique: scroll picks the monitor on air), topology trace on hover or press (pointer), replay scrub (state), magnetic hero ask (pointer). Each monitor plays one moment as it comes on air (desktop) or scrolls in (phone, once): its h3 cuts in by line mask; topology nodes appear 60 ms apart and the paths draw edge to GPU; latency bars grow 60 ms apart and the cost-spike dot blinks; the drift line draws in 900 ms and the alert dot lands and blinks; v2 fills its score row and "pinned" slides in; the five clouds gather and "One unified view" wipes in; the replay steps rise in. After its arrival, the monitor on air keeps one idle beat (useTick, only while the room is on screen, only on that monitor, none under reduced motion): the traced route swaps zen/kai every 2s until a node is touched; the latency fills re-draw every 1.2s inside their own P50/P95/P99 lanes (order never changes; the spike dot re-blinks when a P99 runs long); the drift alert, now a hollow ink ring at the line's end, sends a pulse ring every 1.5s; the pinned v2 bar nudges within 95-100% of itself; each source lights its signal dot in turn; the replay steps itself every 1.5s until the scrub is touched. Measured: two frames 1.7s apart differ on all six monitors at 1470x801. Transform, opacity and clip-path only; deck curves (0,0,.2,1 / .4,0,.2,1 / .16,1,.3,1) and 90 to 500 ms, 900 ms for line draws. scripts/variety.py OK (0 fade-ups). Kinds: idle, time, state, pointer; scroll is the pin and the hero exit only. Timers are timeout chains (useTick), no setInterval. Reduced motion: stacked room, every drawing whole, getAnimations() 0 after 3 s at both sizes. No springs.

10. Media

  • Film and Pic only; sizes and posters set (n/a: no photo or video)
  • At most 2 videos playing; pause button on loops over 5 s
  • Budgets met; nothing missing; alt on every image (n/a: 0 images, 0 without alt)
  • No dimmed or filtered photo; 4+ real visuals together where the page has them (n/a: no photos)

Done here: 0 videos. The moving objects are drawn in HTML, SVG and one canvas; each loop over 5 s carries a 44px pause button (1 on the page): the hero globe and panel (one pause for both).

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: Overflow 0px at 375 (scrollWidth 375 after a full walk). 0 controls under 44px at 375 or 1470. Phone hero: the globe sits at 64% width to the right, partly off-canvas behind the ask, and the latency panel starts 40px under it, so the h1, ask, globe and panel header are all inside the first 660px; the pause button lives in the panel's header row, off the art. Below 900px the room is a sideways snap rail (78vw cards, a 14.5% peek of the next, the rolling "01 / 06" above it follows the card in view), each monitor playing its moment once as it comes into view; overflow stays 375 after swiping to card 6. Every hover state also answers a tap.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item
  • Forms labelled; first error focused
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: Lowest measured text contrast 7.11:1 (0 runs flagged). Headings 1233333322 with 0 skips. Pause controls: the hero globe and panel (one pause for both, first in the object's DOM, in the panel header). Every input has a label or a register name; nothing validates, so there is no error to focus. Controls are native buttons, links and inputs. In the pinned room the monitors off air are inert, and the rail's six buttons (aria-current="step") jump to any monitor, so the keyboard reaches all six.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized (not measured by this chat; no media to size)
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: curl /world/ returns the h1 in the HTML. Demos run only while on screen (useInView) and stop when paused or off screen. No fetch, poller or third-party script on the page. 0 console errors and 0 hydration warnings over 16 cold loads at domcontentloaded (4 browser launches x 1470 and 375, with and without reduced motion); inline style values (bar widths and fills) are rounded so the server and first client render print them identically; everything that depends on media queries, reduced motion or the pointer is read after mount; the Replay range renders after mount (a still track of the same size in the server HTML), which removes the hydration mismatch on its style.

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> parses; no broken URL
  • Every card is a real link

Done here: Title "Hanzo World — Hanzo AI". Canonical https://hanzo.ai/world/, og:url https://hanzo.ai/world/. 2 JSON-LD blocks, all parse. Metadata comes from content/pages.json through the route file.

15. Catalogue and product pages

  • Model card matches SPEC.md (or n/a: not a catalogue or model page)
  • Every card opens by Morph (n/a: no cards that open pages)
  • Every maker and model page linked in the DOM (n/a)
  • One price figure everywhere

Done here: Not a model page. Cloud product anatomy: identity, the globe as console, six monitors, the band. Prices: "Free for the first million events / month." is Hanzo's line, printed as written.

16. Developer experience

  • One CodeBlock; copy equals display (or n/a: no code on the page)
  • Config blocks parse on their own
  • Terminal pauses and ends on a static frame
  • No hand-typed version number

Done here: Code: the agent prompt in the band. The agent prompt is one string shown and copied as is. No version numbers are typed into the page.

17. States and resilience

  • Loading, empty, error and offline states designed (n/a: the page reads no live data)
  • Blocked live data leaves a complete page, no console errors
  • A failed submit keeps its values and shows no success (n/a: no submit)
  • A thrown island does not blank the page

Done here: Every word is in the server HTML and every demo is local, so a blocked network still shows the whole page; JS off was checked above. Each demo is its own component; the page has no shared runtime state to lose.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js
  • 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/world.md verdict 8 or more

Done here: data-cta on every primary (kit Cta); the page imports no analytics itself. V2: line present in components/pages/cloud/World.jsx. Last critic verdict on file: 7/10 (docs/build-notes/review/world.md: three monitors read as placeholders, reduced-motion hero overlap, swap ghosting, three counters, Multi-Cloud 3-up, empty phone cards, dead drift slot, intermittent hydration warning); fixes 1 to 8 are in (keyed latency lanes, thin gridded score rows, chips sized to text, hairline unified view, reduced-motion object inside the stage, cut swaps, monitor counter hidden while pinned, centred phone drawings, drift line always present, hydration re-checked clean); this version waits for the next walk.