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

12 KiB
Raw Permalink Blame History

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

Page file: components/pages/cloud/Ingress.jsx · gallery: docs/gallery/ingress/ · metric id: cta_click ingress.hero

Open copy questions for James: none. Round 3 (conductor copy rule) removed every invented visible string: the Beyond's h2 is now Hanzo's own sentence "Name one in an annotation, or chain several into a named pipeline and name that."; the chain's ends read "hanzo.ai" and "backend"; the empty chain shows an em dash; the board's labels are "hostname", "middleware", "backend", its routes are hanzo.ai/skill.md, docs/index.html and pricing.html (all on the page), its notes are Hanzo's "out of rotation", "put back when it recovers", "no reload, no dropped connection", "from disk"; the invented example hostnames, backend names, "certificate…" and the "Drag" cursor label are gone. Shared changes requested (docs/build-notes/requests/ingress.md): the phone header ask swap (second solid fill), the cookie card over the hero board, ShipPrompt's 32px Copy (wants 44px), the hero ask's hover (done page-local meanwhile). GetIt's spacing is now done page-local. Still waiting on tokens.css, lib/cta.js, lib/track.js, PageHero to land on main. 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, Frame useEvery (now useTick)

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.js is not on main yet)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; no prices on this page
  • Copy questions: none (invented strings removed, round 3)

Done here: // Persona: to // Beyond: head components/pages/cloud/Ingress.jsx; the one ask is Hanzo's "View on GitHub" (ingress.hero, ingress.close). Measured with a headless walk: one solid button on the first screen at 1470×801 and 375×812.

2. Information architecture and navigation

  • One <main>; the layout's skip link reaches #main
  • Every link through A or the kit Cta; related cards are real links
  • Breadcrumb at depth 2 or more n/a: a depth-1 page
  • Link parity: 0 removed, 0 unexpected

Done here: Parity 29/29 text and 2/2 links; Hanzo's header and footer are untouched; every link goes through A/Cta (lib/route.js).

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 (PageHero is not on main yet); nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; loud and quiet sections alternate
  • Ends in one close in Hanzo's words ("Get Ingress" with the ask), then the footer
  • The h1 is the data-morph-target, so cards elsewhere open into it

Done here: The first screen is the name (its two lines cut in by the kit line mask, visibly in the 0 ms frame), the ports 80 and 443 as figures (64px, grey), Hanzo's line, the ask, and the signature: a turning globe where requests arc in to the one edge and on to a backend, the middle backend leaving rotation and coming back (IngressGlobe.jsx); drag or swipe to spin, arrow keys on focus, pausable. Order after it: What happens at the edge (six facts on a snapping carousel), the routing board, Paste and ship, Chain your own pipeline (dark room), Get Ingress.

4. Conversion system

  • <Cta> only; no raw .x-btn in 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-cta and data-thumb on every primary

Done here: Hero <Cta thumb id="ingress.hero">View on GitHub</Cta>; the close repeats it (ingress.close); Hanzo's other buttons are quiet or link Ctas.

5. Trust and proof

  • No logo, seal or invented number
  • Every figure traces to Hanzo's copy
  • Marquees pause, freeze, hide duplicates n/a: no marquee
  • Privacy link beside every submit n/a: no form submits

Done here: The only figures are Hanzo's own (80 and 443); demos use Hanzo's words, never invented numbers.

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 /ingress: 0 missing

Done here: Parity 29/29 text and 2/2 links. Section labels sit under their headings as captions; phone labels raised to 14px (components/pages/cloud/Ingress.css).

7. Visual design system

  • python3 scripts/taste.py passes (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 set n/a: no icons beyond the kit's
  • Differs from neighbours in hero medium and room order

Done here: Greys from Hanzo's deck only (taste.py OK); one dark room (the pipeline). C1: the page CSS's #0a0a0a literals (11) now read var(--ink); the remaining greys wait on tokens.css. No floating shadows on tiles (the old chapter-card shadow went with the wipe).

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 it n/a: no dialog on this page
  • Inputs 16px or larger; no bare :hover in the page CSS
  • Forks this page deleted: listed above

Done here: Kit Cta, CodeBlock, Copy and Cloud 3's LivePause. Round 2, the dark room: off chips hover to a 40% white border and #fafafa text, on chips to #fafafa; the ↑/↓ buttons hover to white 14%; chips and arrows press to scale(.97) in 90 ms; focus is a 2px white ring with a black halo. Walk: 13/14 desktop hovers answer (the 14th is a disabled ↑).

9. Motion and interaction

  • One signature, at most 3 supporting techniques, at most 2 fade-ups (variety.py OK)
  • 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 in the page (timers are setTimeout chains)
  • Sound only on the listed moments, through the one kit (lib/sound.js, wired by components/Sound.jsx): the ask taps, the pause toggle and the middleware chips tick (aria-pressed, data-sound="tick"), the ↑/↓ reorder buttons and a finished drag tick, copy chimes; the board loops while seen and never finishes, so no done chime

Done here: Signature globe (idle turn, pointer/touch drag with inertia, keys). Entrances one per section: side-carousel (facts glide in and snap), stretch-scroll (the board), inertia-drag (the prompt card coasts in and can be thrown), count-roll (pipeline step numbers), curtain-rise (the close). Idle: the globe and the routing board (a request a second; a backend leaves and is put back). Time: each fact's drawing plays once as its card arrives. State: the pipeline's chips toggle (aria-pressed), rows reorder by drag or arrows and a request walks the chain. Scroll-linked: only the board's stretch.

10. Media

  • Film and Pic only n/a: no photo or film on Hanzo's page
  • At most 2 videos; pause on loops n/a: no video
  • Nothing missing; no image without alt
  • No dimmed photo; 4+ real visuals together n/a: Hanzo's page has no imagery

Done here: Objects are drawn from Hanzo's words: the globe, six fact drawings, the routing board (C1: the two pod backends now carry Hanzo's "health checks" like the static one carries "from disk", so no tile reads as a loading skeleton), the pipeline, and the shared GetIt contour art at the close.

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 (C1 fixes): the globe sits on top of its stage with the legend and note under it (they were squeezed beside it and covered by the canvas); each fact is one card, words then drawing, the next card peeking 40px (the 5/6 split had squeezed the text to a word a line and the source pills ran out of their panel); the board's lit row keeps its place so Let's Encrypt never crowds its edge. check.mjs 7 Nov: desk and phone 0 errors, 0 covered, 0 wide.

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: The live object is aria-hidden with its pause button outside it; tabs and radios carry aria-selected/aria-checked; aria-live where a demo answers.

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: Timers stop off screen and when paused (useLive and useTick); bundle size not measured on this page.

14. SEO and machine files

  • Title and description from content/pages.json
  • Canonical through the shared <JsonLd route="/ingress" />
  • <JsonLd route> renders; no broken URL
  • Every card is a real link

Done here: app/ingress/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/ingress" />.

15. Catalogue and product pages

  • Model card matches SPEC.md n/a: not a catalogue or model page
  • Every card opens by Morph n/a: no catalogue cards
  • Every maker and model page linked n/a: not /models
  • One price figure everywhere n/a: no prices

Done here: n/a: a top-level cloud product launch page; its h1 is the data-morph-target for cards that open into it.

16. Developer experience

  • One CodeBlock; copy equals display
  • Config blocks parse on their own n/a: no config block
  • Terminal pauses and ends on a static frame n/a: no typed terminal
  • No hand-typed version number

Done here: Hanzo's agent prompt use the kit CodeBlock, whose Copy copies exactly what is shown.

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 values n/a: n/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.jsx keeps header and footer

Done here: A headless JS-off pass shows every word; reduced motion stops each demo on its final frame.

18. Measurement and handover

  • data-cta on every primary (the kit Cta sends cta_click); lib/track.js is not on main yet
  • Nothing identifier-bearing; no field value in any payload
  • V2: 8/10 line in the page file's top comment
  • Review read: docs/build-notes/review/ingress.md (round 2, 7/10): fixes 1-4, 6, 7, 8 done page-local; fix 5 (phone header ask) filed in docs/build-notes/requests/ingress.md

Done here: ingress.hero and ingress.close on the asks. Gallery: docs/gallery/ingress/ (earlier rounds plus C1 stills c1-desk-hero.jpg, c1-desk-board.jpg, c1-phone-hero.jpg, c1-phone-facts.jpg). Shared asks in docs/build-notes/requests/ingress.md (item 7: GetIt's Deploy to Cloud 44px target).