- 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
/registry coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Registry.jsx (+ Registry.css) · route: app/registry/page.jsx · gallery: docs/gallery/registry/ · metric id: api_key_created
Open copy questions for James: "View Source" and "View on GitHub" both point at the github.com/hanzoai org page, not a registry repo (Hanzo's links, kept as they are).
Shared changes requested (docs/build-notes/requests/<page>.md): none.
Forks this page deleted: the page CSS that forced the header's "Try Hanzo" to an outline; the second white "repository window" in the chapters (now the layer stack) and its six grey row lists (handshake, repos, artifacts, tags, people); the switch label that repeated the dark room's h2; the swap row that repeated the hero lede; the forever-looping push; the spring knob; a drop shadow on a non-floating row; the shared LaunchConsole (generic services, Builds caption) for a page-local registry console with the same words and links; the shared RelatedCards grey Sigil boxes for page-local cards drawn as layer stacks; the separate "Get started" strip and the Paste block, now folded into the close; off-deck greys (#a1a1a6, #6e6e73, #0b0b0c and seven more).
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 from Hanzo's own hero link
- One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a prices: no prices on the page
- Open copy questions for James listed, none decided
Done here: "View Source" is the hero's one solid (data-cta="registry.hero"); the shared Ask keeps the header outlined while it is on screen, then carries "View Source" solid in the header for the rest of the page (the page no longer overrides it). One h1 "Hanzo Registry".
2. Information architecture and navigation
- One
<main>; skip link reaches it (shared shell) - Every link through
A; every related card a real link - n/a breadcrumb: depth 1
- Link parity: 0 removed, 0 unexpected
Done here: python3 scripts/parity.py /registry: links 12/12. Order (breaks the shared cloud order on purpose): push → dark room "Delete the dockerconfigjson secret", straight off the lede's last words → "Built on Hanzo IAM" pinned stack (per 46svh, about 3.2 screens of scroll) → the registry console (acme's repositories, each opening into its layers and tags) → related capabilities drawn as stacks → one close that carries "Get started with Registry", View on GitHub and the agent prompt (the page ends once).
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- Stage hero with
LineMaskh1; nothing above the h1 - JS off: legible; the h1 is not hidden
- One idea per 100svh; heights vary (hero, 7-screen pin, dark room, console, rows, close)
- Ends in close (
LaunchClose), footer - Related card titles carry
data-morph(the site's Morph opens them into their page)
Done here: The push starts at first paint (docker push → 401 naming IAM → token → signature → layers → v1.2.3 + cosign signature) inside one outlined window, then rests on the signed image with a blinking prompt; on phone the registry is a strip above the terminal so the image lands on screen while it is pushed.
4. Conversion system
- Kit
lx-ctaasks; no raw.x-btn - Sticky ask in the header after the hero, same label "View Source"
- Copy buttons copy the displayed text (Frame
Code,Paste) data-ctaanddata-thumbon every primary
Done here: registry.hero and registry.close both carry data-thumb="View Source"; the header button takes those words once the hero ask scrolls away.
5. Trust and proof
- No logo, no seal, no invented number
- Figures (401, /v2/) are Hanzo's words; names (acme, ana…) are labelled examples in the code header
- n/a marquees: none
- n/a submit: no form
Done here: Status is read by ✓, a filled !, strike-through and weight, never colour; the console keeps Hanzo's "Example project…" note.
6. Content presentation (copy untouched)
- No text under 13px desktop, 14px phone
- Measures held (lede 44ch)
- Code uses Frame
Code; chapters usePinnedChapters python3 scripts/parity.py /registry: 0 missing
Done here: Parity 69/69 text, 12/12 links. "Related capabilities" and the chapter numbers raised to 13px (14px phone), "Agent prompt" and the close facts to 14px on phone. The credential sentence is said by Hanzo's lede, the pinned intro and the dark room only; the demo no longer repeats it.
7. Visual design system
python3 scripts/taste.pypasses; every literal hex is on the deck ramp- No label above a headline (chapter numbers sit under the title)
- The hero window is outlined, not raised; tiles flat
- One icon set; no icon in a rounded box
- Differs from neighbours
Done here: taste OK on both files. The chapters' object is one big inked stack of layer plates (about 330px plates, ink to #525252, a #f5f5f5 manifest plate) on the page's white with no window chrome, labelled on the object; the grey row lists are gone (one caption per chapter), so it no longer mirrors /o11y's or /metrics's white window; the hero is the only window. Section heads rest at 32px (26px phone); the dark room's ledger has one hairline.
8. UI component library
- Every control has hover, press, focus-visible
- Focus ring from the kit on every stop
- n/a dialogs: none
- No bare
:hover(all inside@media (hover: hover)) - Forks this page deleted: listed above
Done here: Quickstart fills white on hover and presses .97; About IAM, the console title, "Deploy to Cloud" and "hanzoai" thicken their underline and press .97; Replay turns its arrow; the switch knob leans 4px; pause and replay are 44px. Console rows select on hover, click or Enter (the image panel restacks its layers); sidebar icons show their name on hover and focus; "Open in the console" fills ink. Related cards play their drawing on hover or focus (layers spread, the project frame tightens, the staging stack lifts, source lines become layers) and press .97.
9. Motion and interaction
- One signature (the push that asks IAM first), supporting: line mask, pinned scene, wipe
- Kinds: idle, pointer, time, state, arrival, scroll (scroll is under half)
- Something moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - n/a sound: shared kit
Done here: The push runs once (~9 s) and rests; the caret blinks at rest; the layer stack floats ±6px over 6 s and each chapter acts on it: intro, an IAM token hovers with its time bar draining and strikes itself; 01, a struck "password" falls away while the token seats (a new facet, not the push again); 02, the top plate inks for acme; 03, signature and attestation dock; 04, the stack squares for /v2/; 05, a layer slides out and the storage bar shrinks; 06, four people fold into one row, one revoked. variety.py OK.
10. Media
- n/a Film/Pic: Hanzo has no Registry images or film; every object is product UI or drawn
- n/a videos
- n/a images
- n/a photos
Done here: Objects are the terminal/registry window, the layer stack, the console, the agent prompt and the close's Sigil.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Targets 44px or more; tapping a push step holds it (tap again to release)
- Primary ask above the fold at 375×667
Done here: Phone: the terminal (cause) comes first, then acme/api where v1.2.3 and its signature land (effect); the console's image panel drops under its list; related cards become rows with a small drawing; the pinned window shows the stack plus one short caption per chapter inside 40svh; related titles 21px so "Environments" no longer breaks.
12. Accessibility (WCAG 2.2 AA)
- Contrast 4.5:1 or better (#525252 lede on white, #a3a3a3 on black)
- Pause control first in the demo; Replay once it rests
- n/a forms
- One h1; h2s per section; the switch is named by its h2 (
aria-labelledby) witharia-pressed - Keyboard reaches every control
Done here: Reduced motion: push at end state, no caret blink, no float, swap without wipes.
13. Performance and engineering
- h1 in server HTML
- Page-local CSS only; no images
- No poller; one setTimeout chain that stops off screen, paused, hovered or done
- Filmed in the cloud
Done here: Animations are transform, opacity, clip-path and translate only.
14. SEO and machine files
- Title and description from
content/pages.json(unchanged) - Canonical unchanged
<JsonLd route="/registry" />unchanged- Every card is a real link
Done here: app/registry/page.jsx untouched.
15. Catalogue and product pages
- n/a model cards: a cloud product page
- n/a Morph
- n/a maker links
- n/a price
Done here: Cloud anatomy: identity (hero), console, facts (pinned chapters), the close.
16. Developer experience
- Frame
Codewith copy; copy equals display - n/a config blocks
- Terminal pauses and ends on a static frame (signed image + prompt)
- No hand-typed version number (v1.2.3 is an example tag)
Done here: Login-and-push terminal in the dark room, agent prompt with Copy, Quickstart to docs.
17. States and resilience
- Push states: running, paused, held (hover/tap), done (Replay)
- No live data; page complete with no console errors
- n/a submit
- Islands are page-local and plain React
Done here: 0 console errors at 1470×801 and 375×812 (Playwright check, 7 Nov).
18. Measurement and handover
data-ctaon every primary- Nothing before consent
V2:line in the page file's top comment- Review read:
docs/build-notes/review/registry.md
Done here: registry.hero, registry.close; gallery in docs/gallery/registry/.