- 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
8.4 KiB
/commerce — James-eye review
Reviewed 2026-11-07 17:15, walked moving at 1470x801 and 375x812.
Verdict: 7/10 Ready: 8 Nov, copycheck missing 0 of 134 (hanzo.ai live), held up next to /api and /affiliate (James's new bar, no score). Every endpoint path is one run of text again (they were split by wbr tags and missed), spec, ways and close titles are real text runs, the close stands alone a full section below the ways, and the header goes quiet while the close's solid ask shows. Usable: the order rail, the endpoint finder with every group's full list, processors and docs links. taste/unique OK; 0 console errors, no overflow at 1470 and 375.
First complaint: "You tell me the same five steps twice in a row: the little card runs along the rail, then I scroll and get the same five steps again as big panels that get chopped off in the middle of a word. And after the payment switch it goes back to being a document: rows of names, rows of links, two asks crammed into one screen."
The 11 answers
- Sells in 5 seconds, moves within 1 second? Yes. "Hanzo Commerce" at 52px, the lede and "Read the docs" all sit inside 801px, and the order card has moved to 02 by about 1.1s (shots at t0, t1.2, t3.5 show 01, 02, 03). It runs by itself every few seconds, has a 44px pause, and the stops answer on click. On the phone the same holds, with the ask at about y 350. But the hero object is small: the order card is about 340x172 on a 1470-wide grey band, so the band reads as a strip of dots more than "the product as the hero". About 75px of empty white sits under the band on the first desktop screen.
- One in, one out? Partly. The pinned journey does it: the left column stays put while the 01–05 panes slide in and the number changes. But it is the hero's story told a second time, under the same heading ("An order, start to end"). From "Who takes the money" onward it is a stack of documents: the integrations rows, the four tiles, the spec accordion, the four ways in, "Get Commerce", the close. At 1470x801 one screen holds the four ways rows, the "Get Commerce" block, the 52px "Create a product, then sell it" and the solid "Read the docs" all at once.
- A real object in every section? Mostly. The rail card, the journey line drawings, the noun card, the black finder, the processor switch, the shape tiles and the install drawing are all real objects. The integrations section (three rows of names) and the four ways in / "Get Commerce" section have no object at all, only text.
- One ask, sticky after the hero? On desktop the header swaps to a solid "Read the docs" after the hero, which is good. At the close, though, the header's solid "Read the docs" and the close's solid "Read the docs" are on screen together: two solid fills in one viewport. On the phone the header keeps a solid "Try Hanzo" beside the hero's solid "Read the docs" (shared chrome, so noted but not counted). Scale: the rhythm is mostly right (52 h1, 26 heads, 64 figure in the journey). In the finder, though, three 32px "0"s sit at the same weight as the real counts.
- Every hover and press answers? Yes. Rail stops (fill, aria-pressed), pause/play, noun rows (fill, then a dialog), suggestion chips (white fill, columns refilter), Clear (returns to the 31/5/20/10/8 counts), processor radios (pill glides,
'Klarna'swaps in), spec rows (aria-expanded), group pills (a drawer rises from the right), ways rows (fill), "View on GitHub" (fill). The hero "Read the docs" hover only darkens to #2c2c2e (that comes from the kit). No jumps seen. - Overlap, font swap, layout shift? CLS 0.0004 desktop, 0 phone, overflow 0 at both sizes, no font swap seen. The real defect is in the pinned journey: the panes are cut by a hard vertical mask at about x 555. Mid-scroll, "Capture" reads "apture" and the paths read "d}/capture". At rest, the last pane (05 Refund or return) keeps its left border and corners cut off. A hydration-mismatch console error appeared under shared load; on 6 clean reloads (3 per size) it did not come back, so it is not counted. One reload showed the red badge for
components/pages/cloud/Analytics.jsx(another page's parse error), so that is not counted either. - Which reference, and is its motion there? Apple product page: a pinned, scrubbed scene with one panel changing, and the stop drawings draw themselves in. The motion is there in the journey and the idle rail. The editorial pointer details from osply/hamol are thin: nothing answers the pointer beyond hover fills and the tile art drift.
- Different from its neighbours? Yes. The hero medium is a full-bleed order rail with a riding card. That is unlike /payments (a phone) and /captable (a figure), and no other page has the endpoint finder in its black room.
- All 18 parts covered? The card is filled to 18 parts. Claims I checked hold: parity 272/272 text and 7/7 links, overflow 0, the 44px pause, the radiogroup, aria-expanded spec rows, the drawers, and the ask label swapping in the header. Some claims are overstated. Part 3 says "no 3 same-height sections in a row" and "ends in proof strip, Band": the tail is integrations rows, tiles, accordion and ways rows with no proof strip. Part 2/3 say the noun cards "open panels in place", but a click opens a centred modal dialog on top of the page.
- Banned tells? None outright: no hue, no gradient, no Inter, no icon boxes. The one borderline case is the 11px "HEADLESS E-COMMERCE PLATFORM" eyebrow on desktop. It sits at y 170, above the h1's line (h1 at y 267), in the right column. On the phone it correctly sits under the h1, and the desktop should match.
- Copy untouched? Yes.
parity.py /commerce: OK, text 272/272, links 7/7.
Fixes (ordered, most important first)
- Stop the journey clipping its own panes. The mask at about x 555 (the left edge of the pane track, 1470x801) cuts headings and paths mid-word during the scrub ("apture", "d}/capture"). At rest, pane 05 has its left border and radius cut off. Either fade the outgoing pane out (opacity plus a 16px slide) before it reaches the mask, or move the mask edge to the column gutter so it falls in the gap between panes. The last pane must settle fully inside the track, with all four corners visible.
- Don't tell the five stops twice back to back. The hero rail already walks Product and variant → Cart → Authorize → Capture → Refund under "An order, start to end". The pinned journey then repeats the same heading and the same five stops. Make the journey read as the zoom-in of the rail rather than a second telling. For example, carry the rail's active stop into the journey's first pane (same card position, then grow), and drop the duplicate small "01" rail state once the journey pins. Keep the copy, change the presentation.
- Give the tail one thing per screen and an object. At 1470x801 the ways rows (y 140–490), "Get Commerce" (y 320–480) and the close heading plus solid ask (y 575–760) share one screen. Separate the ways section from the close by a full section pad (about 116–188px) so the close stands alone. Give the integrations rows something to look at: for example, the selected processor from "Who takes the money" stays lit as the rows pass, or a hover on a name shows its group count.
- One solid fill at the close. The header's solid "Read the docs" and the close's solid "Read the docs" (1146,710 at 165x48) are both on screen. Hand the fill back to the header outline while the close ask is in view, as already happens in the hero.
- Quiet the zeros in the finder. With "refund", three of five columns show a 32px "0" plus an em dash. MASTER says a zero never gets hero size. Drop the zero counts to the 13–14px mono caption size, or dim the whole empty column to 30%. On the phone the stacked zeros take a whole screen (see phone-walk.jpg), so collapse empty groups to one line there.
- Smaller: Put the desktop eyebrow under the lede's line or align it to the h1's baseline instead of above the h1's level. Make the order card larger in the hero (it is 340x172 on a 1470 band), or let the band's height grow with it, so the product reads as the hero. Fix the coverage card's "panels in place" wording, since it is a modal, and its "ends in proof strip" claim.
Proof: docs/build-notes/review/commerce/desktop-first.jpg (rail at stop 02, 2.3s), phone-first.jpg, desktop-walk.jpg (pane cut mid-word), desktop-close.jpg (ways, Get Commerce and close in one screen), phone-walk.jpg (zero columns on the phone).