- 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
/blog coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/BlogIndex.jsx (+ BlogIndex.css, story.css, StoryClose.jsx, StoryPause.jsx) · gallery: docs/gallery/blog/ · metric id: post opens (data-cta="blog.*"). The post template is docs/build-notes/coverage/blog-family.md.
Open copy questions for James: none decided.
Shared changes requested (docs/build-notes/requests/about.md, shared by the Story pages): kit Band word blur; v2/Lines timing; the floating ask bar.
Forks this page deleted: the page's own buttons and text links (now kit Cta); the cover's repeated date; the h1's nowrap; the "Blog" kicker above the h1, "Every post" above "Contents", the tag above the cover headline and above each phone row; the red accent; the italic "&"; the curtain on hand-picked stories; the corner numerals and circle buttons on the on-site cards (they echoed /about's tiles); 18 of 24 archive rows on first view (behind "All 24"); the outlined second button in the masthead; the page's own dark close (now StoryClose).
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; labels are Hanzo's own
- One h1; clear in 5 seconds
- No dead or self-looping button
- Open copy questions listed, none decided
Done here: one solid per screen: on desktop "Read the latest" (the newest post, data-cta="blog.hero") is the solid in the masthead while the header's "Try Hanzo" goes outlined, then the header carries it solid; on phones the header's "Try Hanzo" stays solid and the masthead ask is outlined; "Every post" (hanzo.blog) is the Band's solid; "hanzo.blog" (underline, arrow nudges on hover) and "Read the docs" are text links.
2. Information architecture and navigation
- One
<main id="main"> - Every link through
Aor a real<a>; on-site cards are links withdata-morphtitles - n/a: breadcrumb (depth 1)
- Link parity: 0 removed, 0 unexpected
Done here: parity links 29/29; the three on-site posts open into their pages by Morph; the archive links out to hanzo.blog as Hanzo's own index does.
3. First impression and page narrative
- Sells in 5 s; moves within 1 s (h1 cut-in, the curtain lifting off the cover plate)
- Page-owned masthead; nothing above the h1 ("Blog" runs into the lede)
- JS off:
noscriptshows the masthead and the first cover story - One idea per 100svh
- Ends in Band, footer
- Morph on the on-site cards
Done here: the masthead (52px), the cover story with its plate (the one big thing) and the six-headline index all fit 1470×801; then the on-site posts, the contents (the newest month; the bars bring in one month at a time; "All 24" opens all), the Band.
4. Conversion system
- kit
Ctaonly; no raw.x-btn - Sticky ask: the shared bar carries "Read the latest" (
data-thumb) - n/a: no copy button
data-ctaanddata-thumbon the primary
Done here: data-cta="blog.hero" and blog.band.
5. Trust and proof
- No logos, seals or invented numbers
- Titles, dates and summaries are Hanzo's
- n/a: no marquee (the cover has a pause control)
- n/a: no form
Done here: every word and date from content/live/blog.json.
6. Content presentation (copy untouched)
- No text under 13px except 12px mono capitals
- Measures held; the cover summary clamps to 3 lines visually (the full text is in the HTML and in the contents)
- n/a: no tables, FAQ, tabs or code
parity.py /blog: 0 missing
Done here: parity 95/95 text, 29/29 links; the archive reads as a book's contents, a dotted leader to each date.
7. Visual design system
taste.pypasses; deck greys only; the curtain is the deck's silver gradient- No label above a headline (tag and date follow the cover headline; captions after "Contents")
- Radii 20 on art cards and the plate
- One arrow, one chevron
- Differs from neighbours: a magazine cover (About: drawn frontier; History: running year)
Done here: headings rest at 26px, the h1 52px, the cover headline 32px; Hanzo's Kai art on the Kai cover stories is the only colour source.
8. UI component library
- Hover, press (.97), focus-visible on every control
- Focus ring 2px ink with white halo
- n/a: no dialogs
- n/a: no inputs
- Forks deleted: listed above
Done here: index buttons aria-pressed; strip bars are buttons with spoken counts; empty months are not controls; "All 24" expands.
9. Motion and interaction
- One signature, 2 supporting by script (variety OK), 0 fade-ups
- Kinds: time (the cover turns), pointer (index hover cuts in under 250 ms; contour fields lean to the pointer), state (strip filter, All 24), scroll (bars rise, month pins), arrival (h1)
- Something moves without input
- Reduced motion final states; no
setInterval - n/a: sound is the shared kit's
Done here: signature = the self-turning cover (silver curtain on the timer's turn only); its pause button has its own column and works by mouse click (tested 7 Nov: elementFromPoint hits the button, aria-pressed="true", the cover held 8 s). Below the cover: the on-site trio rises in on arrival and its art tilts up to 2.5° toward a fine pointer; the post count counts up 0 → 24 at 1.75× when the contents are reached and settles at 64px (and grows again on a month press); an idle silver light runs across the strip's bars every 8 s; each contents row slides in on arrival while its dotted leader draws to the date.
10. Media
- kit
Imgfor the Kai art; Sigil fields elsewhere - n/a: no films
- Decorative art
aria-hidden - No dimmed photo
Done here: Hanzo's Kai art on the two Kai cover stories; the three on-site cards play Hanzo's own films (kit Film: Zen for Synthesis, Enso for Pareto Frontier, Kai for Kai 1; the first model each post is about, as its post plate does), so the cover plus three films show four real visuals; contour fields on the other cover stories, paused off screen.
11. Mobile and responsive
- 375×812 and 1470×801 pass
- No horizontal scroll at 320
- 44px strip bars (the strip scrolls sideways), 44px links
- Ask above the fold at 375×667
Done here: plate above the story (343px wide with four corners at 375, aspect 4:3), then the story, the pause, and the index as a swipe rail (the index sits in the single column; it no longer forces a second one); the "All 24" pill sits on its own row under the bars; cover headline links are at least 44px tall; month headers stick under the header; tags follow summaries on phone.
12. Accessibility (WCAG 2.2 AA)
- Contrast: #0a0a0a, #525252 on white; white 78% in the Band
- Pause control first in the cover's DOM (44px,
aria-pressed, register name) - n/a: no forms
- One h1; months are labelled sections
- Keyboard: index, strip, All 24, pause
Done here: the carousel is aria-roledescription="carousel", inactive stories inert and aria-hidden; outline H1 → H2 (cover stories) → H2 "Posts on hanzo.ai" (visually hidden, on the trio) → H2 Contents → H2 Band, no skipped level; no nowrap on the h1; under reduced motion the pause is hidden and the index takes the full row (no indent).
13. Performance and engineering
- h1 in server HTML
- The Kai art sized; Sigil canvases pause off screen
- No poller
- Nothing heavy run on James's laptop
Done here: the cover timer is a timeout per turn, the index line is CSS.
14. SEO and machine files
- Title and description from content/pages.json
- Canonical: shared metadata layer
<JsonLd route="/blog" />renders- Every card is a real link
Done here: all 24 posts and the six cover stories in server HTML.
15. Catalogue and product pages
- n/a: not a catalogue or model page
Done here: n/a: Story page (the on-site cards open by Morph).
16. Developer experience
- n/a: no code
Done here: n/a: no code on the page.
17. States and resilience
- Empty months are gaps, not controls; filtering never empties the list
- n/a: no live data
- n/a: no submit
- Reduced motion and JS off designed
Done here: reduced motion: no turning, no curtain, bars at rest, films show posters; JS off (shared NoJs, no <noscript>): masthead and only the first cover story visible (the other five hidden), every month of the contents open, controls that need JS hidden.
18. Measurement and handover
data-ctaon primaries; no analytics wired yet- Nothing identifier-bearing
V2:line in the page file- Review read:
docs/build-notes/review/blog.mdverdict 6/10, fixes pushed, re-review pending
Done here: docs/build-notes/review/blog.md (6/10 at 9afbb4b); round 3 fixed the phone cover grid (round 2 had left the index on columns 2/-1, which broke the 375 cover), made the masthead ask outlined, gave the trio a heading, tilt and arrival, added the count-up moment, the idle bar sweep and row arrival, aligned Contents with its caption and closed the gaps. Proof: docs/gallery/blog/v3-*. Round 4 (review 7/10): JS-off cover fixed, one solid per screen, films on the trio, contents one month at a time (newest first; a bar swaps its month in as the last leaves; All 24 opens all), the count moved under Contents to fill the empty column, less air between the cover and the trio. Round 5 (review 7/10): phone strip scrolls inside the 343/288px column with a peek and "All 24" at the left under it (Oct and All tapped at 375 and 320); the masthead h1, lede and ask arrive by CSS from the first paint; the cover's contour plate is a server-drawn SVG frame until the canvas takes over (also the JS-off picture); the header's ask is outlined from the first paint on desktop while the page's own solid is on screen (no Try Hanzo / Read the latest flip); card art clipped to its 20px radius while it scales; the big card runs the full height of the two small ones; AnimatePresence in popLayout (no console warning). Round 6: on phones the nine month bars are nine equal columns inside the column (38px each at 375, 32px at 320, 150px tall targets, no sideways rail; every month and All tapped); the active "All 24" is an ink outline, not a fill; one "All 24" control (the strip's, with the chevron) instead of two; the gap between the cover tabs and the films is tighter.