- 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
10 KiB
/idv coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Idv.jsx · gallery: docs/gallery/idv/ · metric id: cta_click idv.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/idv.md): none filed; 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, the kicker added beside the h1
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.jsis not on main yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button; no prices on this page
- Open copy questions for James listed, none decided
Done here: // Persona: to // Beyond: head components/pages/cloud/Idv.jsx; the one ask is Hanzo's "View on GitHub" (idv.hero, idv.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
Aor the kitCta; related cards are real links Breadcrumb at depth 2 or moren/a: a depth-1 page- Link parity: 0 removed, 0 unexpected
Done here: Parity 28/28 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 (PageHerois not on main yet); nothing above the h1 - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; loud and quiet sections alternate
- Ends in one close in Hanzo's words ("Get IDV" 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, the ask, Hanzo's intro (first sentence in ink at first paint, the rest inked word by word, resting in full ink; it leads on a phone) and one live object: the switchboard where the four calls stay put while the vendor turns (Jumio, Onfido, Plaid, the rest) and the verdict lane answers each one's own way (HMAC-SHA256, polled from the provider, refuse with only "approved" struck). It moves within 1 s, pausable.
4. Conversion system
<Cta>only; no raw.x-btnin 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-ctaanddata-thumbon every primary
Done here: Hero <Cta thumb id="idv.hero">View on GitHub</Cta>; the close repeats it (idv.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 duplicatesn/a: no marqueePrivacy link beside every submitn/a: no form submits
Done here: The only figures are Hanzo's own (four calls, the five-year record clock); 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 /idv: 0 missing
Done here: Parity 28/28 text and 2/2 links. Section labels sit under their headings as captions; phone labels raised to 14px (components/pages/cloud/Idv.css).
7. Visual design system
python3 scripts/taste.pypasses (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 setn/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); the vendor-tab hover fill is a deck step, not an invented grey. Hex literals remain in page CSS because tokens.css is not on main yet.
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 itn/a: no dialog on this page- Inputs 16px or larger; no bare
:hoverin the page CSS - Forks this page deleted: listed above
Done here: Kit Cta, CodeBlock, Copy and Cloud 3's LivePause; segmented controls get a grey veil on hover and press .97 from v2scale.css.
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups (
variety.pyOK) - 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
setIntervalin the page (timers aresetTimeoutchains) - Sound only on the listed moments, through the one kit (
lib/sound.js, wired bycomponents/Sound.jsx): the ask taps, tabs, radios and pause toggles tick (radios carrydata-sound="tick"), copy chimes; the demos loop while seen and never finish, so no done chime
Done here: Signature: a verdict, or nothing. Idle: the vendor turns every 3 s while seen (pausable). Pointer: the board leans 2.5°, a vendor hover previews its verdict and names how it answers. State: the vendor pill glides (layoutId); the forge's three choices recompute a real HMAC-SHA256 and the verdict leads with its word (accepted, polled, refusal). Time: the intro inks in. Arrival: sheet titles cut into their line, the 4 counts up, the hash and the KMS tree draw. Scroll: the six sheets stack (outgoing ones step back with a 16px edge, words kept) and the forge opens from a 16px (8px phone) inset kept inside the text gutter (C1 fix: the old 32px inset cut its heading while opening).
10. Media
n/a: no photo or film on Hanzo's pageFilmandPiconlyAt most 2 videos; pause on loopsn/a: no video- Nothing missing; no image without alt
No dimmed photo; 4+ real visuals togethern/a: Hanzo's page has no imagery
Done here: Objects are drawn from Hanzo's words (the switchboard, the counting 4, "approved" struck over "refuses", the full-width hash, the polling dots, the KMS tree, IDV beside Risk, the forge); the close is the shared GetIt with its contour art. No Hanzo media exists for this page.
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: the lede leads, the four vendors sit in two rows of two (none faded), each sheet shows its title and object before its paragraph, the forge reads provider, callback, choices, verdict in order. check.mjs 7 Nov: phone OK; desk flags only the stacked sheets covering the sheet beneath, which is the design (the outgoing sheet keeps a 16px edge, no text in it).
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
- 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="/idv" /> <JsonLd route>renders; no broken URL- Every card is a real link
Done here: app/idv/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/idv" />.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.mdEvery card opens by Morphn/a: no catalogue cardsEvery maker and model page linkedn/a: not /modelsOne price figure everywheren/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 ownn/a: no config blockTerminal pauses and ends on a static framen/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 valuesn/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.jsxkeeps header and footer
Done here: If WebCrypto is unavailable the forge keeps the server-rendered verdict for the callback as sent (the HMAC values are in the HTML), and nothing leaves the page; the verdict stamp is aria-live="polite".
18. Measurement and handover
data-ctaon every primary (the kitCtasendscta_click);lib/track.jsis not on main yet- Nothing identifier-bearing; no field value in any payload
V2: 8/10line in the page file's top comment- Review read: no
docs/build-notes/review/idv.mdyet
Done here: idv.hero and idv.close on the asks. Gallery: docs/gallery/idv/ (earlier film and stills plus C1 stills c1-desk-hero.jpg, c1-desk-forge.jpg, c1-phone-hero.jpg). Shared request kept in docs/build-notes/requests/cloud2.md (CodeBlock overscroll-behavior under reduced motion).