- 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
10 KiB
/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
Copyswaps itsaria-labelinstead ofrole=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-morphintodata-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;Ctanot merged yet) - Sticky ask in header and bar after the hero, same label (
data-thumb) - Copy copies exactly the displayed
git clone …text data-ctaanddata-thumbon 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.pypasses; 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 witharia-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
#525252or ink on white;#a3a3a3or 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 clonebox; 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-ctaon the primaries (lib/track.jsnot merged yet)- Nothing identifier-bearing
V2:line inOrgPage.jsx(v6)- Review read:
docs/build-notes/review/oss-family.mdwas 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.