- 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
12 KiB
/open-source — James-eye review
Verdict: 7/10
Ready: 8 Nov, copycheck missing 0 of 302 (live hanzo.ai, read once live's count-ups settle: copycheck.mjs with a 6 s settle, twice; the stock 0.8 s run lists 9–12 of live's Lux/Zoo repository figures caught mid count-up, e.g. "59 contributors" on the way to 64 and "in the past 6 days" on the way to 7, which Hanzo never shows at rest). Every figure now comes from the same read hanzo.ai's build baked in (api.hanzo.ai/v1/git/activity + GitHub, read Nov 7, 08:16; openSource/read.mjs writes openSource/snapshot.js), and on the hanzo.ai origin openSource/live.jsx GETs /v1/git/activity after first paint and refreshes the forge figures it serves; restored: the window "Commits a day, from Nov 8, 2025 to Nov 7, 2026" under the year of commits, the Nov 7 latest commits, language shares and repositories as one line each, every organization's commits this year with its months drawn as 13 bars, "38 organizations · 1,734 repositories"; / leaves and the letter-cascade heading flattened so each line is one leaf. taste/unique OK; 0 console errors, no overlap at 1470x801 and 375x812, no sideways scroll at 320. Before that: 7 Nov, held up next to /api and /affiliate (no score). The h1 cuts in first with the lede, asks and figures following, the page closes on a centred black room ("Join the Community", Start Contributing, Join Discord, Founder Program), the Built-on glyphs are drawn in ink with marks and credits lighting each other, organization cards answer hover with their own bar, the charter signs in 1.1 s with a 24px mark, the phone shows one ask (local band desktop-only) and the desktop pause sits above the fold (the invented Article labels were already gone). taste/unique/parity OK (417/417 text, 139/139 links); 0 console errors, no overlap at 1470x801 and 375x812. Shared, not this page: phone header ask following the page ask, FooterHTML hydration, cookie card (docs/build-notes/requests/open-source.md).
Dark: 8 Nov, matches live hanzo.ai in dark side by side (docs/gallery/open-source/dark-*.jpg); darkcheck OK, lightcheck OK, copycheck 0. (darkcheck's remaining lines are intended: the light month bars and language segments are data marks, as live draws its light commit squares, and the selected tab labels sit in a sibling of their light pill. The hero and the close stay the black rooms they are in both modes.)
First complaint: "The top is alive and it's ours: the dots gather into Hanzo, Lux and Zoo. Then it turns into grey boxes, eight of them, then twelve with greyed-out emojis on top, and it reads like a spreadsheet of repos. And on the phone the pause button is sitting on top of the stars number."
Walked 7 Nov 2026 on the dev server at 1470x801 and 375x812 (recorder walk at both sizes, all 12 desktop and 18 phone scroll stops, a vs b idle frames; my own Playwright probes: hero arrival every 100 ms for 1.6 s, Total count-up final value, Zoo organization tab, org card hover, "Read more" sheet open and Esc, Built-on mark hover, charter signature draw, phone overlap measure, reduced motion, JS off).
Frames: phone pause over 5,125 · Built on: emoji row over 12 equal tiles · "Article III/IV/V" labels
What works
- The hero object is Hanzo's own and it moves. A black room with a dot-field canvas (
canvas.x-gl). On load the dots arrive scattered and gather into three clusters labelled LUX, HANZO, ZOO with their real organization and repository counts. The field keeps drifting while idle: the LUX label moved from y 91 to y 153 between the 3 s frame and the first scroll stop, with a non-zero idle diff. It moves within 1 s, it is a real data object, and no other page has it. - The h1 cuts in by line mask. The 1.2 s probe frame shows "Building in the" half out of its mask. The probe then read
transform: noneat y 204, with no shift while fonts loaded. The h1 is 52px/497, and nothing sits above it: "OPEN SOURCE FIRST" is set below it as a caption. - Figures are honest and they count. Total across Hanzo counts up and rests on 805,254 / 2,247 / 6,041, byte-identical to
openSourceData.jsTOTAL and the page source. Under reduced motion it renders 805,254 at once, andgetAnimations()returns 0 after 3 s. - State changes are real. The ecosystem tabs (Hanzo 1,733 / Lux 456 / Zoo 58) and the organization tabs (Hanzo 37 / Lux 15 / Zoo 4) swap their content; clicking Zoo shows the 4 Zoo orgs. "Read more" opens a sheet with the full commit list, the date range and a "Read the source" link, and Esc closes it. The Contribute language chips (Go, TypeScript, Rust…) re-weight the ecosystem percentages.
- The heat map is the best object on the page. It is a year of commits per day in the ink ramp, with Less/More, languages and latest commits. Proof, made visible.
- It holds up with JS off (19,984 characters of main text render), CLS is 0.0015 on desktop and 0 on phone, and there is no horizontal overflow at either size.
The 11 answers
- Sells in 5 s, moves in 1 s? Mostly. At 1,000 ms the lede, buttons and figures are already up but the h1 is not. The h1 arrives about 1.2 s, so the page reads lede first and headline second. The dot field makes the first second worth watching. On the phone the field crowds the h1 top (h1 at y 336), and the primary bottom sits at 668px, 8px past the 660 budget.
- One in, one out, or a document? Half and half. Hero → What we publish (tabs, heat map, sheet) → Total (count-up) works as a sequence. After that, Every organization (8 equal tiles) and What Hanzo is built on (12 equal tiles) come back to back as two 4-column walls of the same
#f5f5f5rounded card. Then a six-article list and a repo list follow. From Total onward it scrolls like a long document. - A real visual object in every section? Hero: canvas, yes. Publish: heat map, yes. Total: big figure, yes. Organizations: tiles with a bar, weak. Built on: a row of 12 greyscaled emojis (
filter: grayscale(1) contrast(1.25)) over text tiles, which looks cheap. Charter: a signature line that draws in, with the Hanzo mark. Mid-draw it reads as a stray "/" squiggle and a 10px mark (desktop screen 08, phone screen 10). Contribute: chips and a repo list. - One ask in the header, scale rhythm? On desktop the header ask swaps from "Try Hanzo" to "View on GitHub" once the hero ask leaves view. That is correct, and it is the only solid in the chrome. On the phone the header keeps a solid "Try Hanzo" while a local band directly under it carries an outlined "View on GitHub". The two stacked bars take 117px of an 812px screen, and they carry two different asks. Scale: h1 52, hero figure 64, Total 84-ish as the moment, h2s at 26, and "Contribute" at h1-like size near the end. The rhythm is good in the top half. In the tile walls everything is the same medium size.
- Every hover and press answers? Buttons, tabs, the pause control, stat tiles and links answer. The org card hover is only a fill change (transparent to rgb(245,245,245)) and tells you nothing new. On the Built-on mark row, hovering the React mark showed no visible change in either the mark or the React tile in my probe. The recorder's "dead" items were the already-active tabs (Hanzo 1,733, Hanzo 37), which is correct, and "Zoo 58", which was under the cookie card. I clicked Zoo 4 myself and it works.
- Overlap, font swap, shift? One overlap, on the phone: the hero's 44px Pause button (
.xos-pause, absolute, right gutter, bottom 27px) sits on the "5,125" GitHub stars figure. It was measured as an intersection at x 315, y 907. There is no font swap and no shift. During arrival the canvas dots drift across the lede for about half a second. - Which reference, and is its motion there? It wants to be apple.com (one idea per screen, the product as hero) and the anthropic launch (figures as heroes). The hero and Total deliver that. There is no pinned scene, and the cards do not open into their pages (the organization arrows link out, with no Morph). The osply/hamol editorial confidence is missing from the bottom half.
- Different from its neighbours? Yes in the hero: an ecosystem dot field is its own medium and signature. No below it: the tile grids are the kit's generic card, the same as catalogue pages.
- 18 parts? Most are present: one h1, one
<main>, tabs, a sheet, a pause control on the moving field, reduced motion final state, JS-off legibility,data-ctaand the sticky ask. Missing: the closingBand. The page ends on Contribute's repo list and goes straight into the footer, with no proof strip or band in the page's own words. The phone overlap fails part 11. - Banned tells? No hue, no gradient text, no kicker above the h1. The greyscaled emoji row is a filtered-image tell and reads as AI-made. The two runs of 8 and 12 equal grey boxes in rows of four are the "equal boxes" clutter James rejects. They are not three in a row, but they repeat one tone and one shape.
- Copy untouched? One invented string. "Article I" to "Article VI" (
OpenSource.jsx:499ROMAN,:515Article {ROMAN[i]}) appears over each stewardship commitment. "Article" is in neithercontent/live/open-source.json,content/pages/open-source.htmlnorcontent/ui-strings.json. Everything else I checked traces to Hanzo's words: "Forge listing · read…", "What we publish", "Total across Hanzo", "as GitHub counts them", "UTC", "Start Contributing", "Read more", "Pause" and every figure.
Fixes (in order)
- Remove the invented "Article I–VI" labels. In
components/pages/OpenSource.jsx, delete theROMANarray (line 499) and the<span className="pf-mono xos-art-n">Article {ROMAN[i]}</span>(line 515). If the list needs a marker, use a hairline or the numeral alone drawn as a non-text mark, never a word Hanzo did not write. - Fix the phone overlap.
.xos-pause(OpenSource.css:21) is absolutely positioned at bottom 27px over the hero figure row. Under 899px, move it into flow above the figures (or top-right of the room, below the header), and reserve its 44px so it never meets "5,125". Check it again at 320 and 375. - Break the two tile walls. Every organization and What Hanzo is built on must not be two back-to-back 4-column grids of identical
#f5f5f5cards.- Make one of them a list. Built on, for example, could be 48px rows with the licence in mono at the right and the maintainer in grey, plus a row hover fill.
- Or give the organizations a true scale object: bars sized by repositories, so hanzoskill 749 is visibly ten times zap-proto 55.
- Show the first row and open the rest with the existing "Read more" pattern. That keeps one thing in and one out.
- Replace the greyscaled emoji row. The emoji glyphs (🐍 ⚙️ 🐹 …) with
grayscale(1) contrast(1.25)look cheap and filtered.- Either drop the row (the copy survives in the tiles), or render each as a plain mono monogram in ink.
- Whichever you keep, make the pointer link real: hovering a mark must visibly light its credit (ink border-free fill, the licence chip inverting), and the reverse. My probe saw no change.
- Add the closing
Band. End on one proof strip and one Band in the page's own words before the footer (part 3). "Start Contributing" plus Join Discord and Founder Program is the natural band; set it as the closing centred room rather than a left column beside a repo list. - Give the arrival a sensible order. Hold the lede, buttons and figures until the h1 cut-in has started (60 ms stagger after the h1 lines), so the 1 s frame shows the headline, not a headless lede. Keep the dot field off the lede column while it gathers. On the phone, end the field above the h1 and bring the primary inside 660px.
- Make the charter signature read as a signature. Draw it once, 800–1,400 ms, when the last article is 60% in view. Then hold it fully drawn with the Hanzo mark beside it at a readable size (24px, not 10.8px). Partly drawn, it looks like a stray slash.
- Use one ask on the phone. Either the local band drops its "View on GitHub" (the header can carry it, as on desktop), or the header shows the band's label. Two bars with two different asks take 117px of an 812px screen.
- Make card hovers tell you something. The org card hover should reveal something already on the card's data (its commits this year as a bar filling, or the repositories bar extending), not only a fill change. Keep the arrow nudge within the allowed transforms.
Shared chrome, not scored: the FooterHTML hydration mismatch, which produces the red "1 Issue" badge on both sizes, and the phone cookie card covering about 200px of every screen.