- 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
/stream coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Stream.jsx · gallery: docs/gallery/stream/ · metric id: cta_click:stream.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/stream.md): none. The shared code pane (components/pages/cloud/Frame.jsx) animates a multi-tab pill with a spring; this page uses single-tab panes only and holds the pane to the deck colours in components/v2/x-hamilton/Launch.css.
Forks this page deleted: the teal boxes (greys now), the label squeezed over the title, the off-screen phone points (swipe rail now).
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 with Kafka clients who want Hanzo PubSub behind them; the one ask is Hanzo's "GitHub" (data-cta primary in the hero, "close" as the later solid), metric cta_click:stream.primary. lib/cta.js is not merged yet, so the label is the live page's own. h1 count 1. no prices on the live page. Every button changes something on screen.
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 more (n/a: /stream is depth 1)
- Link parity: 0 removed, 0 unexpected
Done here: <main id="main" data-ask="off">; the layout's "Skip to content" targets #main. 4 links in main, all through A or Cta. python3 scripts/parity.py /stream 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:0on 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 frame (the tape full-bleed behind the title, then clipped into a card); the object is a tape of records across four partitions, moving from arrival, with the committed-offset marker, so the record tape moves within the first second. The h1 sits about 130px clear of the last lane at 1470×801; partition labels sit on a solid black edge and the refused batch's INVALID_RECORD stamp has its own slot at the lane's right end, so no digits collide. 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 Stream" at opacity 1, 0 hidden headings or paragraphs. Rooms: hero (dark) → the offset ruler (light, pinned on desktop, swipe rail on phones) → one line to change (light) → closing band (dark). 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-ctaanddata-thumbon every primary
Done here: 0 .x-btn without data-cta in main; CTAs found: primary*, close*, 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.
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 /stream: 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, lede 20px, body 15px, figures 64px Air, growing only in their moment. Lede 44ch, body 66ch, headings balanced. Code: a producer snippet in the shared code pane (copy equals display) and the agent prompt. 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. /sentinel and /telemetry open light.
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) and changes fill or border only; press is scale .97 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: none. 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: your scroll is the consumer (pinned sideways tape). Supporting: proximity snap (scroll), offset counter (time), the check that answers (state; the twelve API names are buttons that fill it), the record on stage consuming its strip (idle), the consumer group in the close (idle, Pause). scripts/variety.py OK. Kinds: idle (the hero object), time, state, pointer, with scroll only in the pinned scene. Timers are timeout chains (useTick), no setInterval. Reduced motion (useCalm) renders the settled frame. No springs: every transition is 300 ms ease-emphasis or shorter.
10. Media
FilmandPiconly; 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 and SVG; each loop over 5 s carries a 44px pause button (2 on the page): the hero tape and the close's consumer group (four partitions, committed offsets climbing, one consumer dropping and coming back), its own object rather than the hero lane again.
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 and 0px at 320. 0 controls under 44px at 375 after scrolling the whole page. The primary ask's bottom edge sits at 694px on a 667px screen. Pinned scenes stack below 900px; every hover state also answers a tap. Phone: no fixed layer at all; the committed offset now sits in the rail heading, and the record on stage consumes its strip at rest and stands its offset up, so the stacked records move without input.
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 4.74:1 (0 runs flagged). Headings 12333333222 with 0 skips. Pause controls: the hero tape and the close's consumer group. 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.
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 /stream/ 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 at both widths (0 desktop, 0 phone).
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 Stream — Hanzo AI". Canonical https://hanzo.ai/stream/, og:url https://hanzo.ai/stream/. 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 tape as console, the six facts as records on the ruler, the band. Prices: no prices on the live page.
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: a producer snippet in the shared code pane (copy equals display) and the agent prompt. 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-ctaon every primary; events only throughlib/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/stream.mdverdict 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/Stream.jsx. Ready (7 Nov, D2 run): held up next to /api and /affiliate.