Files
Claude 07cf81bd47 Handoff layout: new README; build-chat notes moved to docs/build-notes/
- 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
2026-11-08 13:22:36 +00:00

10 KiB
Raw Permalink Blame History

/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 A or a real <a>; on-site cards are links with data-morph titles
  • 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: noscript shows 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 Cta only; no raw .x-btn
  • Sticky ask: the shared bar carries "Read the latest" (data-thumb)
  • n/a: no copy button
  • data-cta and data-thumb on 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.py passes; 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 Img for 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-cta on primaries; no analytics wired yet
  • Nothing identifier-bearing
  • V2: line in the page file
  • Review read: docs/build-notes/review/blog.md verdict 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.