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

7.0 KiB
Raw Permalink Blame History

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

Page file: components/pages/apps/Sign.jsx (+ Sign.css) · gallery: docs/gallery/sign/ · metric id: signup_start

Open copy questions for James: functional labels not in content/ui-strings.json: the pad's "Sign here", "draw here", "ready to sign", "signed", "Clear", "Sign", "Signed "; the plan switch "Run it yourself" / "We run it" uses Hanzo's lede words as button labels. Shared changes requested (docs/build-notes/requests/sign.md): none. Noted: no skip link in shared chrome; useEvery/useSteps use setInterval; tokens.css not merged. Forks this page deleted: the separate hero (now the pinned story's lead), the floating desk pause, the "09"/"10" tile numbers, the "Most Popular" pill (now a line), the three equal dark cards (now one ask and text links), the white "Get started with Sign" box (now a hairline row), the pad's rewritten certificate sentence, every spring, the "ink indigo" comments.

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport; "Try Hanzo" → /login
  • One h1; clear in 5 seconds
  • No dead button; prices are Hanzo's plan copy (n/a lib/plans.js until it merges)
  • Copy questions listed

Done here: gate: 1 h1, max 1 solid per desktop viewport. The pad's "Sign" is a page solid (button.solid), so the ask bar steps aside while it is on screen.

2. Information architecture and navigation

  • One <main id="main">; n/a skip link (shared chrome)
  • Every link through A; part cards open sheets
  • n/a breadcrumb
  • Link parity 0 removed

Done here: parity links 9/9.

3. First impression and page narrative

  • Sells in 5 s; the desk moves within 1 s (it starts at "fields placed")
  • h1 CSS cut-in painted by the server; nothing above the h1
  • JS off legible
  • One idea per screen: hero desk → 5 steps on the same page → parts → pad → price → open source → dark close
  • Ends on one ask, then footer
  • n/a Morph

Done here: the hero and the five steps are one pinned story on one page object; under reduced motion the desk shows the signed, stamped final state. Gate JS-off hidden 0.

4. Conversion system

  • Kit A + .w2-cta
  • Sticky ask "Try Hanzo" in header and bar
  • n/a copy button
  • data-cta and data-thumb on the primary

Done here: sign.hero (data-thumb), sign.close. The close has one solid; docs and source are text links.

5. Trust and proof

  • No logo, seal or invented number
  • Figures are Hanzo's ($30, $50, twelve languages, five steps)
  • n/a marquees
  • n/a submit (the pad sends nothing)

Done here: the "09"/"10" decoration numbers are gone; demo names are "signer 1–3" and "person 1–5".

6. Content presentation (copy untouched)

  • Phone text 14px+ (gate small375 fixed for "Most Popular")
  • Measures held; long language names step down a size so "Brazilian Portuguese" fits
  • Part sentences live in their sheets; n/a tables
  • parity.py /sign: 0 missing

Done here: parity text 106/106 links 9/9.

7. Visual design system

  • taste.py passes (0 hues)
  • No label above a headline; the sheet kicker now sits under its title
  • Plans legible when not chosen (muted price, full opacity)
  • One icon set
  • Differs from neighbours: a paper desk with a contract, not a window or editor

Done here: gate hues []. Headings rest at 26px (Rhythm.css); "$30"/"$50" are the figures.

8. UI component library

  • Hover inside @media (hover:hover), press .97–.98, focus-visible
  • Focus ring on every stop; the pad canvas is focusable (Enter writes the ink line)
  • Sheets trap Tab, close on Esc and return focus to the card
  • No bare :hover; chips 44px with hover and press
  • Forks deleted: listed above

Done here: components/v2/OpenSheet.jsx now traps Tab and restores focus on close.

9. Motion and interaction

  • Signature (the self-signing page), supporting: PinChapters, sheets, magnetic; 0 fade-ups
  • Idle (desk, five recipients, languages), state (sheets, plan switch), pointer (pad, magnetic), arrival (h1 and five headings cut into their line), scroll (pin)
  • Something moves without input; every control answers
  • Reduced motion: signed final state; no springs
  • n/a sound (shared kit)

Done here: variety.py OK; chapter 04 advances its three recipients one by one; the ink path is hidden until it draws (no stray dots).

10. Media

  • Kit Img only (the file icon)
  • n/a video
  • Sized (38×38)
  • n/a photos

Done here: one decorative Img with alt="".

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap
  • No horizontal scroll at 320
  • Targets 44px+
  • Primary above the fold at 375×667

Done here: the phone desk has one top bar (name left, pause right) and the step counter below it; the checkbox tick sits in its own box, off the label.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured (muted plan price #737373 on #f5f5f7 is large text)
  • Pause on every moving item, in the object's bar or above its rows
  • n/a forms; the pad's result line is role="status"
  • One h1; h2 → h3 order ("Built on Open Source" is now an h2)
  • Keyboard reaches every control

Done here: sheets trap focus; the desk's step names are repeated in an x-sr line.

13. Performance and engineering

  • h1 and lede in server HTML
  • One small image, sized
  • No poller, no third party
  • Nothing heavy on James's laptop

Done here: one client island.

14. SEO and machine files

  • Title and description from content/pages.json
  • Canonical from shared layout
  • <JsonLd route="/sign" />
  • n/a cards

Done here: app/sign/page.jsx.

15. Catalogue and product pages

  • n/a
  • n/a
  • n/a
  • Prices shown once each (plan cards)

Done here: n/a, not a catalogue or model page.

16. Developer experience

  • n/a: no code on the page
  • n/a
  • n/a
  • n/a

Done here: n/a.

17. States and resilience

  • Pad states: empty, ready, signed; Clear resets
  • Blocked network leaves a complete page, no console errors
  • n/a submit
  • n/a islands that throw

Done here: look.cjs both widths: errors none. Slice D, 7 Nov: check.mjs at 1470×801 and 375×812: 0 console errors, no Next issue badge, scrollWidth 1470/1470 and 375/375; desktop-1.jpg, desktop-2.jpg, phone-1..3.jpg refreshed.

18. Measurement and handover

  • data-cta on every primary
  • Nothing identifier-bearing
  • V2: line in app/sign/page.jsx
  • Review 8 or more (re-review pending)

Done here: previous review 6/10 (on an older build); its seven fixes are addressed. Slice D, 7 Nov: the 7 Nov review's six fixes: no rewind (probe: autoplay reaches 04, a wheel moves it on to 05, never back to 01), checkbox tick in its corner, the close fits one screen at 1470 (two-column ledger), tiles preview their first sentence on hover, "Built on Open Source" has no late mask any more, phone pricing is a snap rail (about 1 screen instead of 3.5).