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

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

Page file: components/pages/oss/OrgPage.jsx (+ oss.css, ossData.js; route app/oss/[slug]/page.jsx, 56 organizations) · gallery: docs/gallery/oss/ · metric id: GitHub or weights click

Open copy questions for James:

  • The sort and filter icons and the open card's controls are named from the register: oss_sort*, oss_language, oss_all, oss_clone_from, oss_copy, oss_show_all, oss_loading, oss_no_match. All need James.

Shared changes requested (docs/build-notes/requests/oss.md):

  • n/a. Site-level: kit Copy swaps its aria-label instead of role=status.

Forks this page deleted:

  • The black ledger card and the pinned word-and-card chapters, the composition oss shared with /products and /solutions.
  • The repeated figures and the giant zeros.
  • The dark close that repeated the h1 and the lede.
  • The four even rows of grey tiles.
  • The layout-animated clone pill.
  • From earlier rounds: the accent colours, the kicker over the h1, the chapter counters, the invented sort and "Open on …" labels, the 96–168px type, the springs, and the cursor label.

1. Strategy and conversion

  • Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
  • One solid fill per viewport: " on GitHub" (Hanzo's hero link)
  • One h1 (the organization's name); clear in 5 seconds
  • No dead or self-looping button; n/a prices
  • Open copy questions for James listed, none decided

Done here: "hanzoai on GitHub" is magnetic, with data-thumb and data-cta="oss.hero". The open card's solid is the repository link, and the close repeats the ask.

2. Information architecture and navigation

  • One <main> (the site's skip link reaches it)
  • Every link through A; every tile and card a real link or button
  • Breadcrumb: n/a. Hanzo's page has none; "Every organization" leads back, in the hero and under the cards.
  • Link parity: 0 removed, 0 unexpected (hanzoai 123/123, hanzo-app 25/25, crowdstart 9/9)

Done here: The page runs: the year (hero), GitHub's figures, the forge's own figures, the numbered repositories, the next four organizations under their link line, then the quiet close.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • Nothing above the h1 ("Open source · Hanzo" is a caption under the lede)
  • JS off: legible (0 hidden blocks; chapters stack)
  • One idea per 100svh: ledger, chapters, tiles, cards, close
  • Ends in its own moment, then the footer: a quiet room with the organization's contour full width (it leans toward the pointer), its id, and the one ask. It does not repeat the h1 or the lede.
  • Card-to-page uses Morph (data-morph into data-morph-target). The 12px landing can't be checked on the dev server.

Done here:

  • The hero object is the year laid flat: a light, full-width strip with the strongest true figure set on it (hanzoai 568,900 commits, hanzo-app 11 repositories, never a zero). Behind it are the month bars, read by a playhead, and the organization's contour. An organization without commits shows its own repositories passing along the strip instead.
  • The strip is on the first screen at 1470×801 and 375×812, and it moves within 1 s untouched.
  • Every figure is said once: GitHub's other figures sit in a small row under the strip, and the forge's own (merges, repositories, commits by people and agents) in hairline rows. Nothing repeats 568,900 or 461/1,602/154.
  • The dead bands are closed: the rail sits right under its link line, and sections pad 72–116px.

4. Conversion system

  • No raw .x-btn (v2f-btn; Cta not merged yet)
  • Sticky ask in header and bar after the hero, same label (data-thumb)
  • Copy copies exactly the displayed git clone … text
  • data-cta and data-thumb on the primary (oss.hero, oss.card, oss.close)

Done here: The tiles' GitHub and Forge links are a quiet icon and chip, never solid.

5. Trust and proof

  • No logo, seal or invented number; every figure is Hanzo's, read from GitHub and Hanzo Forge on the date the page states
  • The qualifier sits beside the figure (the ledger's corner: "GitHub Nov 6, 2026")
  • The ticker freezes under reduced motion; its duplicate names are aria-hidden
  • n/a: no submit

Done here:

  • The forge rows draw their shares from two of Hanzo's own numbers: 2,178 private of 2,732 repositories, and 159,289 of 568,900 commits by Hanzo's people and agents.
  • Zeros never stand big. They drop into one small grey line ("0 merges in the past year · …").
  • The rows keep Hanzo's own "N commits this year" and "Pushed …" lines.

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • h1 at 52 (sized to the longest word on narrow columns), headings 26, tile names 21 and 26, body 16
  • The open card's labels are Hanzo's own (stars, forks, "N commits this year", "Pushed …") or icons
  • parity.py: hanzoai 208/208, hanzo-app 37/37, crowdstart 28/28, hanzo-community 72/72 text

Done here: No more than three sizes among the headline, lede and body in any one view. The figures rest at 64; one per screen grows only as it passes, and the small row sits at 32.

7. Visual design system

  • taste.py passes; deck greys only (#fafafa, #a3a3a3, #737373, #d4d4d4, #ededed, #0a0a0a) plus white or black alpha
  • No label above a headline
  • Radii 24 and 16; the ledger is a flat black surface (no shadow); only the open card floats (--float)
  • One icon set (inline strokes); no icon in a rounded box
  • Differs from neighbours by the org's own contour (Sigil seeded with /oss/<org>), figures, waveform or ticker

Done here:

  • Its own face among the families: a light full-width strip, no black card on the right, no pinned chapters, no dark close.
  • Bars are silver, the playhead and shares are ink, and the chips are ink when pressed.

8. UI component library

  • Hover (in @media (hover:hover)), press (scale .97 or .96), focus-visible and loading (the "Show all" spinner with aria-busy) on every control
  • Focus ring on a Tab crawl (site ring; tiles show an inset ring)
  • The open card is a modal: focus goes to Close, Escape closes it, and focus returns to the tile (tested)
  • Search input is 16px with Hanzo's own label
  • Forks deleted: listed above

Done here: The sort is three icons in one pill that glides (300 ms, no spring). The language chips are a swipe rail on phones.

9. Motion and interaction

  • One signature (a row grows into its card, 600 ms in-out) plus 3 supporting: the lead's rise and grow, the strip's playhead or ticker, the contour. Fade-ups: 0.
  • Five kinds of movement; scroll is 1 of them:
    • idle: playhead or ticker, contour drift;
    • pointer: magnetic asks, a hovered row's playhead, the contour leaning, drag rail;
    • state: open card, sort pill, re-flow, a clone pill placed by CSS;
    • arrival: the name arriving large and settling, digits rising;
    • scroll: one figure growing as it passes.
  • Moves without input; every control answers
  • Reduced motion: 0 running animations after load (tested); no setInterval
  • n/a: sound kit not merged yet

Done here: Counters never pass through other numbers; every frame shows Hanzo's figure.

10. Media

  • n/a: Hanzo has no film or photograph for an organization. The objects are the ledger, the waveform or ticker of its own repositories, and its contour.

Done here: Canvases: 2 live contours (the strip and the close) plus 4 still (6 of 12).

11. Mobile and responsive

  • 375×812 and 1470×801 with no overlap (hanzo-app, crowdstart, hanzoai walked)
  • No horizontal scroll (scrollWidth 375)
  • Targets 44px or more on phones (chips, sort, Forge, GitHub icon, close)
  • Primary ask above the fold at 375×667

Done here:

  • Repositories are 72px list rows on phones: number, name, language and stars; the row opens the same card.
  • A sideways swipe turns to the next organization (hanzo-app → hanzo-apps, hanzoai → hanzobot).
  • The open card rises from the bottom.

12. Accessibility (WCAG 2.2 AA)

  • Contrast: text #525252 or ink on white; #a3a3a3 or white on black
  • The ticker and playhead stop under reduced motion. The playhead is a 6.5 s read, and pause controls are n/a for decorative loops.
  • n/a: forms (search only, labelled)
  • One h1; h2 per chapter and the repositories; icon controls named
  • Keyboard reaches every control

Done here: The waveforms are role=img with Hanzo's own label ("Commits a month over the past year").

13. Performance and engineering

  • h1 and ledger in server HTML
  • Transform, opacity and clip only; tile re-flow skips layout animation above 80 items
  • No poller; the GitHub read happens only on "Show all"
  • Filmed in the cloud only

Done here: CSS animations pause off screen through the site's [data-off].

14. SEO and machine files

  • Title and description unchanged
  • Canonical unchanged (site-level)
  • <JsonLd route> unchanged
  • Every repository and sibling is a real link

Done here: Hidden tiles stay in the DOM as hidden.

15. Catalogue and product pages

  • n/a: model card
  • Sibling cards open by Morph; tiles open their card in place
  • Every repository linked (GitHub and the forge)
  • n/a: no price

Done here: The next four organizations are cards with their own contour, their org id (so a second "Hanzo Apps" reads "hanzo-apps"), their figures, and one line on hover (always shown on phones). Arrows are outlined, so the ask stays the only solid.

16. Developer experience

  • git clone box; copy equals display
  • n/a: config blocks
  • n/a: terminal
  • No hand-typed version

Done here: The open card's clone box switches between GitHub and Hanzo Forge.

17. States and resilience

  • Empty search shows an icon, the query and a screen-reader status. Loading is a spinner with aria-busy. If the GitHub read fails, it falls back to Hanzo's own link.
  • Blocked GitHub leaves a complete page (everything listed is served)
  • n/a: no submit
  • A failed Sigil leaves the page

Done here: JS off shows every figure, chapter and tile.

18. Measurement and handover

  • data-cta on the primaries (lib/track.js not merged yet)
  • Nothing identifier-bearing
  • V2: line in OrgPage.jsx (v6)
  • Review read: docs/build-notes/review/oss-family.md was 6/10 (v4); v6 answers its six fixes. A re-score is pending.

Done here: Film and phone shots for hanzoai and hanzo-app are in docs/gallery/oss/, re-shot over the same names.