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

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

Page file: components/pages/integrations/IntegrationsIndex.jsx · gallery: docs/gallery/integrations/ · metric id: api_key_created

Open copy questions for James: none on Hanzo's copy. Two UI strings wait for the register: "Find your tool" and "Nothing matches" (see the request file). Shared changes requested (docs/build-notes/requests/integrations.md): the two UI strings; the components/Morph.jsx 4 s freeze; the phone header ask label and solid fill; header glass over dark rooms; public/hanzo.css smooth scrolling on phones. Forks this page deleted: the floating AskBar pill, cursor labels on badges and cards ("Open"), springs on the chip pill and grid, the setInterval language timer, the outlined second hero button (now a text link), shadows and lifts on cards.

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 — n/a for prices: none on the page
  • Open copy questions for James listed, none decided

Done here: // Persona / Goal / CTA / Metric: api_key_created / Signature / Beyond head the file. The one solid ask is Hanzo's "Get an API key" (hero), repeated once as the closing room's ask; "SDK docs" is a text link. The label and href are the live page's own (doc.actions).

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it (site chrome)
  • Every link through A, Go, More or href(); every card a real link
  • Breadcrumb at depth 2 or more — n/a: depth 1
  • Link parity: 0 removed, 0 unexpected

Done here: parity 21/21 links. All 19 cards are <a href="/integrations/<slug>">; the hub badges link the same guides (desktop).

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero; nothing above the h1 — PageHero not merged; the h1 cuts in by MaskLines
  • 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

Done here: "Works with everything" + the base URL lede + one ask; the ring of 19 marks gathers in (explode-gather) and turns from first paint around the count 19, the one big figure. JS off: legible, h1 cut in by CSS. Order: hub → editor (pixel-resolve arrival) → catalogue (pinned sideways track on desktop) → "Paste and ship" dark room (typewriter heading, lens sweep) → footer. A card press opens it in place: the card's own box grows into a sheet (shared layout, 600 ms in-out) with the tool's mark, Hanzo's line, the guide's first sample and the guide's headline as the way in; Esc / scrim / Close reverse it. The way in lands on the guide at scrollY 0 with the h1 at y=76 from the first destination frame on phone (measured 100 ms frames, 7 Nov).

4. Conversion system

  • <Cta> only; no raw .x-btn — kit .pf-btn until <Cta> merges
  • Sticky ask in header and bar after the hero, same label — an in-page sticky band (not floating) under Hanzo's header carries "Get an API key" (quiet) from the editor to the catalogue's end; the phone thumb bar uses data-thumb
  • Copy button copies exactly the displayed text; failure never says Copied
  • data-cta and data-thumb on every primary

Done here: data-cta="integrations.hero" + data-thumb="Get an API key"; data-cta="integrations.band" on the closing ask. Copy buttons use the kit Copy with the sample's own text.

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 — the ring has a Pause and freezes under reduced motion
  • Privacy link and owner line beside every submit — n/a: no form

Done here: the only figure is the count of Hanzo's own guides (19 cards). The badges are each guide's own emoji, drawn in grey.

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 — page-local APG tabs and code block until Tabs/CodeBlock merge
  • python3 scripts/parity.py /integrations: 0 missing

Done here: parity 71/71 text, 21/21 links. Body 14–16px; mono 12px only for numbers and file captions. Copy check (offline, 8 Nov rule): missing 0 of 40 lines; loose runs inside Hanzo's rich lede and the agent prompt sit in their own spans.

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; code is greys by white alpha steps (no syntax hues). Rhythm on ProofRhythm.css: h1 52, headings 26, one moment (19 at 84). The ring's marks sit bare on white discs over the ring's hairline (no grey rounded tile; the disc turns ink on hover), and the phone rows show the mark bare (no white tile). Cards are flat #f5f5f5 tiles (no outline, no shadow). Hero medium: a turning ring, unlike /open-source's canvas sky.

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

Done here: chips, tabs, cards, Pause and Copy press at scale(.97) in 90 ms; hovers inside @media (hover: hover); disabled chips (no match) are styled; the search field is 56px with 16px text.

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: sound kit not merged

Done here: Signature: the card that opens into its sheet (state). Idle: the ring turning and the local band's mini ring. Time: the editor switching Python / TypeScript / Go on a per-step timer with a progress bar, the room's heading typing itself. Pointer: card lean (2.5°), ring hover naming the tool in the core, the lens over the agent prompt. Scroll: the pinned sideways track on desktop (one of five kinds). State: the chip pill glides (300 ms), cards cross-fade out 150 ms / in 300 ms, the family writes #frameworks to the URL and opens by hash. No springs, no setInterval. motion.mjs: CLS 0.001 desk / 0.000 phone, 0 STILL screens on desktop.

10. Media

  • Film and Pic only; sizes and posters set — n/a: no images or film on the live page
  • At most 2 videos playing — n/a
  • Budgets met; nothing missing; alt on every image — n/a
  • No dimmed or filtered photo — n/a (the emoji badges are greyed by the 0-hue rule; they are glyphs, not photos)

Done here: No photos or film on the live page; the visuals are each tool's own mark (Simple Icons CC0 / LobeHub MIT, ink) and Hanzo's own code. Hanzo-hosted media is not used here (nothing to verify offline).

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: At 1470×801 and 375×812 nothing overlaps (check.mjs: 0 console errors, 0 wide; its "covered" hits are text scrolling beneath the in-page sticky band, the same as under the header: false positives). Phone: the ask is full width above the fold; the ring is a picture (no taps); the catalogue is 72px+ rows that now show Hanzo's sentence on one line, so touch sees what hover shows; chips scroll in their rail; starter code keeps its shape and scrolls inside the window with a fading edge.

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 — the search field has an accessible name
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: the ring and the editor each have a 44px Pause (aria-pressed). Chips and language tabs are role=tab with arrow keys; the hub centre is aria-live.

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 ring is one CSS animation (paused off screen by [data-off]); the editor's timer runs only in view. No canvas, no video.

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: app/integrations/page.jsx unchanged (metadata from content/pages.json, <JsonLd route="/integrations" />).

15. Catalogue and product pages

  • Model card matches SPEC.md — n/a: no model cards
  • Every card opens by Morph
  • Every maker and model page linked in the DOM — n/a: every guide is linked
  • One price figure everywhere — n/a: no prices

Done here: 19 numbered cards (01 / 19); each family's first guide is wide; on desktop the track runs sideways as you scroll, then lets go into the dark room (which rises 40px over its end: no empty band). Every card opens into its sheet, and every guide is a real <a href>.

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 — the editor pauses (button, a pick, or reduced motion)
  • No hand-typed version number

Done here: each sample's Copy copies its own text; the agent prompt's Copy copies the prompt exactly.

17. States and resilience

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

Done here: Static data (no fetch); the search's empty state ("Nothing matches" + All reset) and disabled chips are designed. Hydration: 0 errors in 12 painted loads at both sizes (the earlier style mismatch on the search field was Playwright's screenshot caret-hiding writing a style attribute before hydration, not the page).

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/integrations.md fixes worked through (Ready line)

Done here: data-cta="integrations.hero", "integrations.band", "integrations.open"; no tracking code on the page. Gallery: docs/gallery/integrations/ (current proof: c1-desktop-hero.jpg, c1-desktop-track.jpg, c1-phone.jpg, c1-open.jpg). Review read; every fix item answered (see the Ready line).