- 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
/iam coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Iam.jsx · gallery: docs/gallery/iam/ · metric id: cta_click iam.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/iam.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
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/Iam.jsx; the one ask is Hanzo's "API reference" (iam.hero, iam.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 41/41 text and 7/7 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 IAM" with the ask), then the footer
- The h1 is the
data-morph-target, so cards elsewhere open into it
Done here: Hanzo IAM, Hanzo's line and the ask at the left; at the right the hanzo.id sign-in runs itself from its first frame (server and client paint the same frame, so no flash): a way in is picked, Authorization code and PKCE · S256 land, the token fills and reads RS256, JWKS ticks, the five stations light in step. Order after it: the 8-fact snap rail, the black Refresh tokens room, Paste and ship, Get IAM (the token at rest), Related capabilities last. Checked 7 Nov (C1) at 0 and 1 s: buttons at rest from first paint.
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="iam.hero">API reference</Cta>; the close repeats it (iam.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: No numbers on the page beyond Hanzo's own ("3 stars" from the live GitHub chip copy); the rail's figures (S256, argon2id, RS256 …) are lifted from Hanzo's sentences.
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 /iam: 0 missing
Done here: Parity 41/41 text and 7/7 links. Section labels sit under their headings as captions; phone labels raised to 14px (components/pages/cloud/Iam.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 on Iam.jsx/css and iam/IamMotion.*). 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 decode (heads and the facts' figures resolve on arrival and on hover/focus). Idle: the sign-in runs and loops while seen (pausable). Pointer: the card tilts up to 2.5°, hover re-decodes a fact. State: Previous / Next and the live 0N / 08, the refresh family (press the live token or a spent one). Scroll: only the stage recede and the dark room opening from a 16px (8px phone) inset to full width, now kept inside the text gutter (C1 fix: the inset used to cut the room's heading on phones). motion.mjs: 0 still on desktop, layout shift 0.000.
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: Every object is drawn from Hanzo's words: the sign-in card, eight line drawings in the rail, the token family, and the close's own token-at-rest SVG (not the hero card, not shared contour art).
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: native swipe rail with snap and a 40px next-card peek, counter follows the swipe; the family shows 4 across in two rows. check.mjs 7 Nov (C1): desk and phone 0 errors, 0 covered, 0 wide. Measured before: ask bottom at 613 of 667; pinned scenes stack under 900px, nothing floats over text.
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 sign-in is aria-hidden with its pause button outside it; the rail's Previous / Next are labelled buttons that disable at the ends; family tokens are buttons with aria-pressed.
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); 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="/iam" /> <JsonLd route>renders; no broken URL- Every card is a real link
Done here: app/iam/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/iam" />.
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: A headless JS-off pass shows every word; reduced motion stops each demo on its final frame.
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:
docs/build-notes/review/iam.mdround 4, all 9 fixes checked 7 Nov (C1)
Done here: iam.hero and iam.close on the asks. Gallery: docs/gallery/iam/ (desktop film, phone stills, and C1 stills c1-desk-hero.jpg, c1-desk-room.jpg, c1-phone-rail.jpg).