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

13 KiB
Raw Permalink Blame History

/brand coverage (MASTER.md part 2, the 18 parts)

Page file: components/pages/Brand.jsx (+ Brand.css) · gallery: docs/gallery/brand/ · metric id: cta_click brand.hero (one contact click: the assets ZIP)

Open copy questions for James: the aria strings Pause, Replay, Copy, Font weight, Background and the three WCAG verdict names (WCAG AA 4.5:1, WCAG AA 3:1, below WCAG AA) wait for approval in content/ui-strings.json; the WCAG verdict shapes are new (computed from Hanzo's hex values, no new visible words or figures; the earlier ratios, the 560 / 100 / 900 readout and the bench echo are gone): keep them only with James's yes; Hanzo's "Success Badge" sample is shown in greys with a tick, because the deck allows no green. Shared changes requested (docs/build-notes/requests/brand.md): mirror /press/hanzo-press-kit.zip into public/ (the dev server proxies it from hanzo.ai; a static export would 404). Forks this page deleted: the forked Btn hero and contact buttons (now the kit's Cta); the kit Copy replaced by a copy control that never ticks on a failed write; the card hero /press shared.

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 from Hanzo's copy ("Download Assets"; lib/cta.js does not exist yet)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices n/a: no prices
  • Open copy questions for James listed, none decided

Done here: "Download Assets" is the hero's only solid (Cta id="brand.hero" thumb). The ZIP link in the assets panel carries the same data-thumb, so the ask bar steps aside there. "Press Kit" and "Contact Us" are quiet Ctas.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it
  • Every link through A, Go, More or href(); every card a real link
  • Breadcrumb at depth 2 or more n/a: depth 1
  • Link parity: 0 removed, 0 unexpected

Done here: The layout's skip link reaches #main. The links are Ctas plus the ZIP download link and the mailto. Parity is 4/4 links.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero not merged in the kit yet; the hero is page-local and nothing sits above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; no 3 same-height sections in a row
  • Ends in proof, assets close, footer
  • Morph n/a: no card opens into a page

Done here:

  • After the curtain (useArrived), the h1 cuts in by line. The construction guides draw full-bleed across the right of the stage (not a card, so it differs from /press), the five pieces land, and the mark opens once.
  • The pieces then lean toward the pointer anywhere in the hero, and the compass turns with a Pause control.
  • With JS off the lede, asks and whole drawing show (page <noscript>).
  • The narrative: hero, then pinned principles (giant numerals), the black colour room (the strip fans open), the specimen, the bench, the assets.

4. Conversion system

  • <Cta> only; no raw .x-btn (bench samples are content)
  • Sticky ask in header and bar after the hero, same label
  • Copy button copies exactly the displayed text; failure never says Copied
  • data-cta and data-thumb on every primary

Done here: The swatches and the [email protected] copy write exactly the hex or the address. They tick only when navigator.clipboard.writeText resolves; on a blocked clipboard the icon stays as it was. data-cta covers brand.hero, brand.press, brand.assets and brand.contact.

5. Trust and proof

  • No logo without permission (only Hanzo's own mark); no seal; no invented number
  • Every figure traces to Hanzo's copy (the contrast ratios, weight readout and px sizes were removed as new figures)
  • Marquees n/a: none
  • Privacy link beside every submit n/a: no form

Done here: The page shows only Hanzo's hex values and its own components. The WCAG verdicts are worked out from those hex values and shown as shapes, not as new figures.

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Measures held; no orphan word in a heading
  • Tables, FAQ, tabs and code n/a: none (the background switch is a two-button segmented control)
  • python3 scripts/parity.py /brand: 0 missing

Done here: Parity is 76/76 text and 4/4 links. "Design System" and "Design Principles" are section names, "01 / 03" is each principle's giant numeral, and Hanzo's group words are h3 titles.

7. Visual design system

  • python3 scripts/taste.py <files> passes; no literal hex outside the token block
  • No label, tag, badge or pill above a headline
  • Radii 24 / 16 / 12, deck shadow only on the floating slider thumb; never box plus shadow
  • One icon set; no icon in a rounded box
  • Differs from neighbours in hero medium and room order

Done here:

  • taste.py passes (3 checked). Brand.css declares its colours once on .xbr, aliasing company/deck.css (--ink, --ink2, --muted, --quiet, --tile, --line, --float, --e-em) where it has them; no literal hex or rgba below that block, and the JSX --acc and badge tick use tokens. The ramp is the deck's (#0a0a0a, #525252, #737373, #a3a3a3, #d4d4d4, #f5f5f5, #ededed, #171717, #262626, #fafafa, #000) and company/deck.css sets the type: headings at weight 497, h1 clamp(52px, 7vw, 84px).
  • Two dark surfaces, not back to back: the colour room and the assets card.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading
  • Focus ring visible on every stop of a Tab crawl
  • Dialogs n/a: none
  • Inputs n/a: the one slider is fully styled (no browser default); no bare :hover
  • Forks this page deleted: listed above

Done here:

  • Press is scale .97 at 90 ms on the swatches, the bench and the copy. Hovers sit inside @media (hover:hover): the gray swatch widens (flex-grow), the big swatches lift their name, the inactive segment lightens, Link Button's underline drops and [email protected] thickens.
  • The background segment is a gliding pill (layoutId, 300 ms ease-emphasis) with a .97 press.
  • The focus ring is ink with a white halo (white with a black halo in the colour room).

9. Motion and interaction

  • One signature, at most 3 supporting techniques, at most 2 fade-ups
  • 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 setInterval
  • Sound the shared sound kit is not in yet

Done here:

  • Signature: the specimen's weight sweeps once (200 → 900 → 560, 4.6 s) when it is 60% in view, then the slider takes over.
  • Supporting: line masks, the hero drawing (draw, lean, compass with Pause; its ticks fade in after their circle draws) and the pinned principles.
  • One in, one out in the colour room: when the contrast board is 60% in view, Hanzo Black glides in under the six grays (the segment's pill slides across, every verdict flips), then Hanzo White comes back at 3.6 s and the switch is yours. Once; a tap stops it; reduced motion skips it.
  • There are no springs (ease-emphasis 300 ms for the hand, 800 ms for the landing). The kinds are idle, pointer, state, arrival and scroll (2 of 5).

10. Media

  • Film/Pic n/a: no photograph or film; the objects are Hanzo's SVG mark, gradients and swatches
  • Videos n/a
  • Nothing missing that this page can fix (ZIP requested)
  • No dimmed or filtered photo

Done here: The assets panel shows the three logo plates the ZIP holds (mark on black, white and grey). The ZIP mirror is requested.

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap
  • No horizontal scroll at 320
  • Every target 44px or more; every hover has a tap path
  • Primary ask above the fold at 375×667

Done here:

  • At 375 the h1, lede and both asks come first and the drawing follows inside the first screen (84px top, 260px drawing; the mark builds at y 566 to 597 of 812). All six grays show in the 2-column grid (the fan is desktop only; the press stays). The principles stack with their numerals, the swatches go 2 across and the contrast list 1 column.
  • At 360 and under, the assets headline is 30px and the segment labels do not wrap.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item (the compass; the sweep is a single 4.6 s run)
  • Forms n/a
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: The heading order is h1, then h2 (each principle, Color Palette, Typography, Components, the assets headline), then h3 (groups), then h4 (sample card). The verdicts are role=img shapes with names, never colour alone.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • Transform, opacity and SVG only (font-weight on the specimen once)
  • No poller; no third-party request
  • Nothing heavy run on James's laptop

Done here: The one continuous mover (the compass) runs only while the hero is seen. The tick coordinates are rounded so the server and browser markup match (no hydration warning). No markup depends on reduced motion: the Pause button always renders (CSS hides it under reduce) and the drawing's on class is set after mount; 0 console errors at 1470 and 375, with and without reduced motion.

14. SEO and machine files

  • Title and description match live
  • Canonical belongs to the shared layout owner
  • <JsonLd route="/brand"> unchanged
  • Every card is a real link n/a: no cards link

Done here: app/brand/page.jsx keeps Hanzo's title "Hanzo Brand Guidelines. — Hanzo AI" and its description.

15. Catalogue and product pages

  • n/a: not a catalogue or model page

Done here: n/a. /brand is treated as a Story page.

16. Developer experience

  • CodeBlock n/a: no code; hex values copy exactly as displayed

Done here: n/a beyond the copyable hex values.

17. States and resilience

  • Copy fails quietly (no tick, no claim)
  • Blocked data leaves a complete page, no console errors
  • Failed submit n/a: no form
  • A thrown island does not blank the page

Done here: All figures are computed or static, so there is no loading state. The console was clean on the last walk.

18. Measurement and handover

  • data-cta on every primary (through Cta)
  • Nothing identifier-bearing before consent
  • V2: 8/10 … in the page file's top comment
  • Review read: docs/build-notes/review/brand.md round 2 was 7/10; all six fixes are done, awaiting re-review

Done here: Round 4 (7/10) fixes: the hero is whole on the first frame. Guides, circle, ticks and the assembled mark are plain server SVG, the lede and asks are visible in the server HTML with a transform-only rise, and the h1 cuts in from 0 ms in 0.6 s, even under the curtain. On cold loads at 1470 and 375 the 0.2 s frame shows the h1 (offset 2 to 10px), the lede and the mark. useArrived now only starts the idle life: the mark parts along its guides once and closes, the compass turns, the pieces lean. JS off hides Pause. The desktop colour room is one scene of 1,376px (was about 2,300): swatches on 8 of 13 columns, the contrast board as one column of rows on the other 5 (no 3-across tiles), gradients below, and a ring marks the brand swatch the board stands on. 88px from the assets band to the footer (was about 220). The 01 panel's hairline follows PinScenes' 28px corners. Round 3 (7/10) fixes: the slider's --p is no longer a React style (CSS rests it at 57.5%, the weight writes it after mount; the input has suppressHydrationWarning against screenshot tools' caret style), so no hydration diff points into Brand.jsx on 8 cold loads screenshotted at 0.1/0.3/0.6 s (the remaining badge is the shared FooterHTML, requested); h1 52px (40px phone), principle h2s, Color Palette, Typography, Components and the assets headline 44px (28px phone), so the numeral, swatches and "Aa" lead; the gaps before Typography and Components are 118px and about 170px (were 235 and 470), and "Need brand assistance?" sits level with the card's headline; Card Title, Secondary and Link Button hovers are visible; the 02 panel is a quiet room with the Brand Glow as a disc, so the page has two dark rooms (colour room, assets card), not back to back. Round 2 (7/10) fixes: all six phone grays (fan triggered by the strip, desktop only); no hydration error under reduced motion; big swatch title at line-height 1.05; Components to the assets band now 72 + 72px (was 235 + 206); the mark builds in the first phone screen; hovers on the gradient cards (lift), scale rows (ink rule, name nudges) and the ZIP row (pill fill). Earlier, re-walked 7 Nov (v3-): fixed the colour room's "Brand Colors", "Gray Scale" and "Gradients" h3s, which deck.css's .vc .vc-title had set ink on black (now #fafafa); added the colour swap scene. The review's six fixes are done in its order: the arrival after the curtain and a live hero; scenes instead of a list; JS off; the signature in view; the hero split from /press; and the tidy list (except the ZIP mirror, which is requested). Gallery: docs/gallery/brand/ (v3-desktop.jpg, v3-phone.jpg, v3-colour-swap.jpg, v3-desktop-walk.webm).