- 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
/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,Moreorhref(); 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 —PageHeronot merged; the h1 cuts in byMaskLines- 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
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-btnuntil<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-ctaanddata-thumbon 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/CodeBlockmerge 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
FilmandPiconly; 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-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/integrations.mdfixes 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).