- 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
14 KiB
/about coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/About.jsx (+ AboutZen.jsx, About.css, story.css, StoryClose.jsx, StorySheet.jsx) · gallery: docs/gallery/about/ · metric id: signup_start (data-cta="about.*")
Open copy questions for James: "1700+" repositories in the page copy against "1,600+" in its meta description and on /history (left as Hanzo has them). "Illustration, not data" and "2 of 4 kept" were strings the page had added; both are gone rather than registered.
Shared changes requested (docs/build-notes/requests/about.md): Unfold spring → tween; kit Band word blur; kit Tabs spring pill; v2/Lines timing; the floating ask bar; taste.py --fix rewriting copy ("#299").
Forks this page deleted: the page's own buttons and text links (now kit Cta: solid, quiet, link); the cursor labels (data-cursor); three equal buttons in three places (now one solid plus text links); the page's own dark close (now StoryClose); raw <img>/<video> on the model cards and portraits; the badge above the h1 and every kicker above a heading; the ultramarine accent, the green status dot and the italic accent words; the auto-rotating tile cue and Zen auto-turn (nothing loops past 5 s).
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 own (no
lib/cta.jsentry exists for /about yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a: no prices on this page
- Open copy questions for James listed, none decided
Done here: kit Cta everywhere; two solid labels on the whole page: "Get Started" (/pricing) in the hero and "Explore Open Roles" in the closing Band. "Start Building" after the track record is now a text link; every other action is a text link with a chevron. Story pages' one action is the closing link, carried by data-cta="about.band".
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it (shared chrome) - Every link through
A; every card a real link - n/a: breadcrumb (depth 1)
- Link parity: 0 removed, 0 unexpected
Done here: <main id="main">; parity links 36/36; model cards are real <a href> (WebGL opener on click), papers and commits link out with rel.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- Page-owned hero (no shared
PageHeroyet); nothing above the h1 - 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 the opener (model cards) and Morph (paper titles carry
data-morph)
Done here: h1 (52px, cut in by line by a CSS animation from first paint, 60 ms apart) with the lede and one ask to its right on 8/5 columns, at full opacity in the server HTML; the frontier, its ghost axes and its head draw by CSS from 0.1 s (no hydration wait); with JS off the frontier shows fully drawn. The lede and asks never move (lede top measured identical at 0.3, 1 and 3 s); on phones the frontier is its own taller plot of the whole 2014–2026 curve at 343px (Techstars '17, all four axis names and every year at 12–13px, y 221–451 of 812), straight under the h1, with the lede and "Get Started" below it. Order: hero, Why (one figure, switches and the principles index on one screen), figures, founders, Zen (the one pinned scene: the scroll turns its six principles one at a time), black room (enters as a rounded card), models and papers, roles, Band. At 1470×801 the hero leaves the next section's head peeking under the fold. 8 Nov: Why we build is two beats on desktop: the figure and its four switches, then the six principles as their own 3×2 row.
4. Conversion system
- kit
Ctaonly (solid, quiet, link); no raw.x-btn - Sticky ask: the shared ask bar carries the hero's "Get Started" (
data-thumb) - n/a: no copy button on this page
data-ctaanddata-thumbon every primary
Done here: <Cta thumb id="about.hero"> puts "Get Started" in the phone bar; about.record and about.band ids; the header carries the desktop ask (shared). On phones the header's solid "Try Hanzo" turns quiet (html[data-ask=quiet], the /bounty pattern) while the hero's solid ask is on screen, so one solid fill shows at a time. 8 Nov: while the band's solid "Explore Open Roles" is on screen the header ask goes quiet at every width (html[data-ask=quiet], re-said after the shell's scroll pass), so one solid fill per viewport.
5. Trust and proof
- No logo, no seal, no invented number
- Every figure traces to Hanzo's copy
- n/a: no marquee
- n/a: no form
Done here: 100+, $1B+, 2024 and 1700+ are Hanzo's (content/live/about.json); commits link to GitHub; the frontier has no values on its vertical axis.
6. Content presentation (copy untouched)
- No text under 13px except 12px mono capitals
- Measures held (headings 24ch, lede 44ch, body 66ch); headings
balance - Tabs use kit
Tabs/TabPanel python3 scripts/parity.py /about: 0 missing
Done here: parity 167/167 text, 36/36 links; the black room's two panes are kit tabs (one at a time), every panel in the HTML.
7. Visual design system
taste.pypasses; deck greys only (#0a0a0a, #525252, #737373, #a3a3a3, #d4d4d4, #f5f5f5, #171717)- No label above a headline: Hanzo's labels sit under their heading as a caption
- Radii 24 tiles, 20 art, full buttons; tiles are flat fills, no shadow; only the sheet floats with a shadow (the commit log is outlined only, no drop shadow)
- No icon set needed (one arrow and one chevron, 1.6px stroke)
- Differs from neighbours: hero object is a drawn frontier (History: a running year; Blog: a magazine cover)
Done here: headings rest at 26px (h1 52px, Book 497; founders' names 26px beside 230px plates), figures rest at 64px in Air 220 and only the one nearest the middle of the screen grows to 1.75× (one big figure at a time, handing over down the staircase); one big thing per screen. Why We Build is one screen (878px at 1470, 1212px at 375): one diamond figure whose four corners the four switches push out (all four = the full frontier), beside the switches and the six principles as a compact index; a hand or focus on a principle swaps the diamond for its radar, a click grows the row into its sheet. Model cards answer a hand with the SPEC's perspective tilt (under 3°, no scale, lift or shadow); paper rows take a soft fill and ink their kind and date; row-head links come up from grey to ink.
8. UI component library
- Every control has hover (inside
hover:hover), press (.97, 90 ms), focus-visible - Focus ring: 2px ink with a white halo (white with black halo in the black rooms)
- The sheet traps focus and returns it to the tile; Esc closes
- n/a: no inputs
- Forks deleted: listed above
Done here: switches are role="switch", ease-emphasis 300 ms (no overshoot); the dark room's quiet button is a light outline on black that fills light on hover (it was light text on its own white fill); runtime cards lift their render 6px and ink their kind on hover, and press to .98; the sheet footer's counter sits centred on its arrows; the sheet is StorySheet (a page-owned tween copy of v2/Unfold, not a native <dialog>: noted).
9. Motion and interaction
- One signature, 3 supporting, 0 fade-ups (
variety.pyOK) - Kinds: state (tile → sheet, tabs, switches), pointer (the year under the hand, role tracks, tile peek), time (the frontier and its four ghost axes draw), arrival (h1 cut-in); scroll-linked: the pinned Zen scene (apple.com), count-up, figures' moment, commits landing
- Something moves without input; every control answers
- Reduced motion shows final states; no
setInterval - n/a: sound is the shared kit's
Done here: signature = tile opens into its sheet (600 ms ease-in-out). The Zen of Hanzo pins for six steps (AboutZen.jsx, useScroll): the old principle leaves before the new one rises, a bar fills with the scroll, and a hover, key or click still picks any one (a click moves the scroll to its step). The curve draws once in 4 s; after it the first screen idles by CSS: the head's halo breathes (3.2 s) and a reader walks the curve 2014 → frontier every 9 s while no hand is on it (hidden while the pointer reads a year). Both pause off screen and never run under reduced motion. The switch hint breathes twice; the live dot is still.
10. Media
- kit
Imgfor portraits and model art, with sizes - n/a: no films playing (hover films removed)
- Alt on every image (portraits named; decorative art
alt="") - No dimmed photo; Kai, Zen and Enso art shown together
Done here: 3 model artworks plus a Sigil plate for Hanzo Engine in one row; the founders' portraits are not in public/authors yet, so app/about/page.jsx asks for them only when the files exist (no 404s); no portrait exists anywhere in the repo (public, content, /team and /investors use the same missing /authors/* paths), so each founder is a 230px Sigil plate (contour field from their name, 26px initials) with the name, role, bio and links beside it, two cards side by side (no dead half-screen). The plate opens as a circle from its initials' corner as it scrolls in (CSS view() timeline), its hills lean toward a hand and darken under it. When a portrait ships, it loads over the Sigil. (8 Nov) public/authors/ now holds both portraits, so the founders show their photos (the server checks the files exist; the Sigil stays only as the failure fallback).
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Targets 44px (socials in a clean 2 × 2, commit links, github.com/hanzoai, and every text link on phones); every hover has a tap path
- Primary ask above the fold at 375×667
Done here: phone composition stacks the hero with the frontier cropped at true scale, with its year labels and three axis names set larger so they read at about 13px; the commit log runs repo and date on one line (149px / 130px columns, "Nov 6, 05:53 UTC" on one line), message under it; the black room's two tabs wrap onto two rows (nothing cut); the Zen scene shows its plate with a row of six numbers under it; the switches go two by two, tiles stack with the radar top right, the sheet rises from the bottom, the black room's tabs sit above the log; scrollWidth 375 at 375. 8 Nov: switches stack one per row on phones (no 3-line wraps, no orphaned arrow); papers show two rows and the commit log three on phones (the rest stays in the HTML behind Papers → and the dashboard link); phone page 14,020px (was 14,605).
12. Accessibility (WCAG 2.2 AA)
- Contrast: #0a0a0a and #525252 on white, #525252 on #f5f5f5, #a3a3a3 and white 78% on black
- The hero's idle loops (halo breathe, curve reader) have a pause control (WCAG 2.2.2, MASTER part 12): a 44px quiet
StoryPausebutton ("Pause",aria-pressed), first in the hero's DOM, tucked into the plot's lower right corner; it pauses both by class. They also pause off screen, and under reduced motion they never run and the button is hidden - n/a: no forms
- One h1; h2 per section, h3 inside; names start with visible text
- Keyboard reaches every control (tiles, sheet arrows, tabs, switches, Zen index); the role rows are no longer empty tab stops
Done here: tiles carry aria-haspopup; the sheet is a labelled role="dialog"; decorative SVGs are aria-hidden; the curve has an accessible name.
13. Performance and engineering
- h1 and LCP element in server HTML
- Every image sized; transform and opacity only
- No poller; no third-party request
- Nothing heavy run on James's laptop (filming in the cloud)
Done here: the pointer cursor writes motion values (state only when the year changes); the curve stops off screen; CLS 0 on the last film.
14. SEO and machine files
- Title and description from content/pages.json (unchanged)
- Canonical: shared metadata layer
<JsonLd route="/about" />renders- Every card is a real link
Done here: app/about/page.jsx keeps its metadata and JsonLd; all text in server HTML.
15. Catalogue and product pages
- n/a: not a catalogue or model page (the four model cards keep the WebGL opener)
Done here: n/a: Story page; its model cards are links into /kai, /zen, /engine and /enso.
16. Developer experience
- n/a: no code on the page
Done here: n/a: no code blocks; commit hashes are real links.
17. States and resilience
- Image failure: Sigil with initials (portraits), Sigil (Hanzo Engine)
- n/a: no live data (commits are a build snapshot from Hanzo's page)
- n/a: no submit
- Reduced motion and JS off designed
Done here: without the portrait files the page is complete with Sigil portraits and no console errors from the page (the shared FooterHTML hydration warning is requested in docs/build-notes/requests/about.md); JS off shows the frontier drawn at rest (a noscript rule stops the draw and the idle loops and hides the pause); reduced motion shows the curve drawn and figures at rest, with document.getAnimations() empty after 3.5 s.
18. Measurement and handover
data-ctaon every primary; no analytics wired yet (needslib/track.js)- Nothing identifier-bearing
V2:line in the page file's top comment- Review read:
docs/build-notes/review/about.mdverdict 7/10, every fix applied, re-review pending
Done here: docs/build-notes/review/about.md: Ready 8 Nov (new bar, no score). Proof in docs/gallery/about/ (desktop-hero, phone-1..3).