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

8.6 KiB
Raw Permalink Blame History

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

Page file: components/pages/Tabs.jsx (+ Tabs.css, tabsTree.js) · gallery: docs/gallery/tabs/ · metric id: signup_start (app hand-off to tabs.hanzo.ai)

Open copy questions for James: "Browser", "Phone" and "Reset" are icon buttons with aria-labels only (not in content/ui-strings.json); add them to the register if visible labels are wanted. Shared changes requested (docs/build-notes/requests/tabs.md): none yet. Noted for shared owners (docs/build-notes/requests/templates.md covers all Business 2 pages): the header's "Try Hanzo" is now always solid beside the page ask; useEvery (cloud/Frame.jsx) uses setInterval; tokens.css is not merged, so page CSS still carries deck-grey literals. Forks this page deleted: the old title-left/stage-under hero, the eyebrow-styled "HANZO TABS" label, the dark room's duplicate "Read the source" button (now the MIT tile itself), the map's black button-like "Open Tabs" tile, every spring transition.

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport; label and href from Hanzo's copy ("Open Tabs" → tabs.hanzo.ai)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; n/a prices (no price on the page)
  • Open copy questions for James listed, none decided

Done here: Persona developers running coding agents in shells, metric signup_start. Gate script: 1 h1, max 1 solid per desktop viewport ("Open Tabs ↗" at y 0); the closing ask carries data-thumb so the bar steps aside.

2. Information architecture and navigation

  • One <main id="main">; the shared skip link reaches it
  • Every link through A; the MIT tile is a real link to the source
  • n/a breadcrumb: depth 1
  • Link parity: 0 removed, 0 unexpected

Done here: <main id="main" className="xtb w2 gx">; parity.py /tabs → links 2/2 (tabs.hanzo.ai, github.com/hanzo-apps/tabs).

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • Hero is the h1 line-mask cut-in + one primary + one object; nothing 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 a band ("Keep tabs on your agents.", a small window closing and reopening a pane, "Open Tabs"), then footer
  • n/a Morph: no cards that open into pages

Done here: h1 "Keep tabs on your agents." (52px) and "Open Tabs" share one line; the window below is the composition and splits its own panes from load (tree grows in its sidebar). Gate: JS-off hidden text 0. Sections: window hero → pinned chapters → light map (packets start when it is seen; hovering a machine sends its packet faster) → dark room of 4 objects with a pause → closing band.

4. Conversion system

  • Kit A with .w2-cta (no raw .x-btn); n/a <Cta> until it merges
  • Sticky ask in header and bar after the hero, same label ("Open Tabs" via data-thumb)
  • Copy button copies exactly hanzo link (displayed text, $ not copied)
  • data-cta and data-thumb on every primary

Done here: data-cta="tabs.hero" and "tabs.close" (both data-thumb="Open Tabs"), "tabs.source" on the MIT link. The primary appears twice (hero, close).

5. Trust and proof

  • No logo, seal or invented number
  • Every figure traces to Hanzo's copy (10k lines of scrollback, MIT)
  • n/a marquees: none
  • n/a submit: no form

Done here: the only figures are Hanzo's "10k lines of scrollback" and "MIT"; demo pane names (build, work, shell 3, shell 4) are UI state, not claims.

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Measures held; headings balanced
  • n/a tables/FAQ; Browser/Phone is a radiogroup with arrow keys
  • python3 scripts/parity.py /tabs: 0 missing

Done here: parity /tabs: OK text 26/26 links 2/2. Phone pane names raised 13 → 14px; Rhythm.css sets h2 26px, h3 17px, lede 21px, body 16px.

7. Visual design system

  • python3 scripts/taste.py passes (0 hues)
  • No label, tag, badge or pill above a headline
  • Tiles are flat fills; only the window and map card float
  • One icon set (inline 1.5px strokes); no icon in a rounded box
  • Differs from neighbours: hero medium is a full-width terminal window, not a split title/stage

Done here: taste.py components/pages/Tabs.{jsx,css} OK; gate hues []. The rail title, window name and URL sit inside the objects, never above a heading.

8. UI component library

  • Every control has hover (in @media (hover:hover)), press .98, focus-visible
  • Focus ring visible on every stop (pane actions, icon radios, reset, pause, copy, MIT link)
  • n/a dialogs: none
  • No bare :hover (all 6 hover blocks are wrapped)
  • Forks deleted: listed above

Done here: phone pane actions are 32px glyphs with a 44px ::after hit area; "split right" folds away on phone; machine rows slide 6px on hover.

9. Motion and interaction

  • One signature (the live tree), 3 supporting (Settle, PinChapters, magnetic), 0 fade-ups
  • Idle (tree, chapter visuals, tile loops), pointer (split/close, magnetic), state (Browser/Phone flip), arrival (h1 cut-in), scroll (pin, settle)
  • Something moves without input; every control answers
  • Reduced motion shows the final state; n/a setInterval (shared useEvery)
  • n/a sound: shared kit not merged

Done here: variety.py OK. No springs: every transition is ease-emphasis 300ms or the Morph 600ms curve. Dark-room tiles run scrollback paging, a pane that closes and comes back by name, and a key row pressing; hover holds each.

10. Media

  • n/a Film/Pic: the page has no Hanzo media; every object is drawn UI
  • n/a videos
  • n/a budgets/alt
  • n/a photos

Done here: no images or video on the live page; the objects are the product's own UI drawn in HTML.

11. Mobile and responsive

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

Done here: phone first screen shows h1 (2 lines at 40px), "Open Tabs", and four live panes inside 660px; the phone caps splits at 4 panes so Close always fits.

12. Accessibility (WCAG 2.2 AA)

  • Contrast: pane text #d1d1d6 / #a1a1a6 on #0b0b0c, body #48484a on white
  • Pause control on every moving item (window bar, chapter visual, the dark room's heading row)
  • n/a forms
  • One h1; h2 → h3 order; names start with visible text
  • Keyboard reaches every control (arrow keys on Browser/Phone)

Done here: the chapter pause sits under the visual; the hero pause lives in the window bar; the dark window and the command block draw a light focus ring (data-room="dark").

13. Performance and engineering

  • h1 and lede in server HTML
  • No images; nothing unsized
  • No poller; no third-party request
  • Nothing heavy run on James's laptop (filmed in the cloud)

Done here: one client island; LineMask cut-in is CSS so the h1 paints before hydration.

14. SEO and machine files

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

Done here: app/tabs/page.jsx reads INDEX['/tabs'] and renders <JsonLd route="/tabs" />.

15. Catalogue and product pages

  • n/a: not a catalogue or model page
  • n/a
  • n/a
  • n/a

Done here: n/a, a product launch page with no model cards or prices.

16. Developer experience

  • Copy equals display (hanzo link)
  • n/a config blocks
  • Self-running panes pause and rest
  • No hand-typed version number

Done here: the one command block copies hanzo link; the $ is drawn, not copied.

17. States and resilience

  • n/a loading/empty/error: no live data
  • Blocked network leaves a complete page, no console errors
  • n/a submit
  • Reset restores the window if every pane is closed

Done here: look.cjs at both widths reports errors none; closing every pane is refused for the last one, and Reset rebuilds the default split.

18. Measurement and handover

  • data-cta on every primary
  • Nothing identifier-bearing; no tracking code in the page
  • V2: line in app/tabs/page.jsx
  • Review read: docs/build-notes/review/tabs.md verdict 8 or more (re-review pending after this rework)

Done here: tabs.hero, tabs.close, tabs.source. Reviews: 5/10, then 7/10; the second review's five fixes are addressed (keep tile animates by transform only, map wakes in view, light focus on dark, closing band, phone key caps, tree 330px).