- 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.0 KiB
/base — James-eye review
Reviewed 2026-11-07, walked moving at 1470x801 and 375x812 (wheel steps of 400px every 700ms, rest pairs on the first screen and mid-page, hover/press/type/open/copy/Esc/Tab crawl). Proof: docs/build-notes/review/base/ (desktop-first.jpg, phone-first.jpg, desktop-walk.jpg, phone-walk.jpg).
Verdict: 7.5/10 Ready: 8 Nov, held up next to /api and /affiliate (James's new bar, no score). The first record lands at 0.6 s, author cells show the users record they point at, the new record's title fills in as it lands, the deploy console carries Hanzo's own caption again, and on phones the map's zoom ends with the collection card whole across the width (it overshot and cut 'posts' mid-word). copycheck missing 0 of 47; taste/unique OK; 0 console errors (also under reduced motion), no overflow at 1470 and 375. Usable: declare a collection, run the binary, deploy, with Hanzo's docs and GitHub links. Left alone: title cells are still bars (no invented titles under the copy rule).
First complaint: "It's clean, but it looks like a wireframe. Every row and every card is grey placeholder bars, and for the first three seconds the admin just sits there. Make it feel like a real product that's alive the moment I land."
The 11 answers
- Sells in 5 seconds, moves within 1 second? Sells: yes. "An app backend in one file", the lede, one solid "Try Hanzo" and a live admin window on the right read at once at both sizes. Moves within 1s: no, not visibly. Frames at 0.5s and 1.5s are identical apart from the header button. The first record lands between 1.5s and 3.5s. No h1 cut-in was visible: the h1 was already at rest at 0.5s. The "live" dot is 6px and doesn't count as motion a person sees.
- One in, one out? Mostly yes on desktop. Hero → binary card → pinned "Declare a collection" (tiles build one by one as the steps advance, with the left text swapping) → six cards → deploy window → dark "Get Base". On phone the pinned scene unpins to paragraph, tile, paragraph, tile. That is correct per the brief, but the page grows to 12,388px and the middle reads like a document.
- A real object in every section? Yes. Admin, binary card, build-up tiles, six drawn cards, the deploy window with four places and apps, the agent-prompt CodeBlock. The weakness is fidelity: the admin's TITLE/AUTHOR cells and the card drawings are blank grey bars (skeleton look). They read as "loading" or "mock", not as Base.
- One ask, sticky after the hero? Yes. The header's "Try Hanzo" outlines while a page solid is on screen and fills between them. Exactly one solid per viewport in every walk frame. Nothing floats over content (the only fixed layers are the header, progress hairline and the shared veil/canvas). Scale: h1 52/40, h2 26, 44px mono "base", 21px H3. It is calm, but almost everything sits at medium. Nothing grows into a moment and settles back (the "Get Base" h2 at 44px is the only lift).
- Every hover and press answers? Nearly. Hero solid hovers to #262626 and presses to scale .98. Text links step their arrow 4px and press 1px. Row hover inks the id and writes
/v1/collections/posts/records/f1bbcd88into the address pill (excellent). Records/Schema toggle, Pause (aria-pressed), step buttons scroll to their step, cards lift 4px and open into a dialog that closes on Esc and returns focus, the place buttons ink on click, and console tabs fill #f5f5f5. Typing "orders" rewrites every records path down the page (the best moment on the page). Misses: the close's "Copy" copied the right text but showed no visible "Copied" at 400ms, and its hover does not change (kit CodeBlock). It is also 74x32 on desktop. - Overlap, font swap, layout shift? CLS 0.0002 desktop (two header micro-shifts at 1.4s), 0 phone. No horizontal overflow at either size. No console errors. The Next badge holds 0 issues and is hidden. No font swap seen. Small: on phone the "ONE STREAM" tile's landing rows overlap each other mid-animation (phone-walk.jpg). At 375 the "SQLite file on disk →" pill leaves its arrow pointing at nothing, and its sentence drops to the next line. At 0.5s the header "Try Hanzo" flashes a grey fill before settling to outline (shared header, not counted).
- Which reference, and is its motion there? apple.com product page: one idea per screen, a pinned scene where one panel changes, the product as hero. The pin and the step-by-step tile build are really there. The card-opens-in-place dialog nods at synchronized.studio, but it is a modal, not a card becoming the page. The idle, pointer, time and state kinds are all present, and scroll is under half.
- Different from its neighbours? Yes in layout. /datastore centres a wide query window under a split head, while /base puts the admin to the right of the h1. Both share the same "window with three dots" and "pause + mono caption" grammar, so the family resemblance is strong but acceptable.
- All 18 parts covered? The card has 18 of 18
Done here:lines. The claims I checked hold: parity OK (text 70/70, links 11/11), one solid per viewport, no sideways scroll, 44px targets in main, focus ring 2px solid on every Tab stop (the collection field shows it on its label), Esc closes the card dialog, and the typed name carries through. One claim is overstated: "something moves within 1 s" (see 1). - Banned tells? None outright. No hue, no gradient text, no Inter, and eyebrows sit below headings ("WHAT IS HANZO BASE", "CAPABILITIES", "HANZOAI/BASE"). Borderline: the capability tiles carry a 1px outline (MASTER part 7: tiles are flat fills, no outline). The unbuilt build-up tiles render text at ~22% (reads as low-contrast, though it is a state). "Deploy to Cloud" in the close fills with #f5f5f7, an off-deck Apple grey (kit KeynoteClose, but visible on this page).
- Copy untouched? Yes per parity (70/70, 11/11). The UI labels the builder added ("the moment it exists", "declare", "it exists", "one stream") are listed as open questions on the card.
Fixes (ordered, most important first)
- Make the hero move inside the first second. Land the first record at about 600ms instead of after the 2.6s cadence, and run the h1 line-mask cut-in (translateY 105% → 0, 700ms ease-emphasis, 60ms stagger). Right now 0.5s and 1.5s frames are identical.
- Replace the skeleton bars with real-looking content. The admin's TITLE and AUTHOR cells are 60–80px grey bars, and so are the card drawings' rows ("schema" card, "count" card, "record" card), the deploy window's record rows and the build-up's stream rows. Use short mono strings built from Hanzo's own words on the page (collection names, field names,
posts, ids), or give the bars one moment of text. It reads as a wireframe, and that is the "lazy look" James rejects. - Give scale one moment. Everything rests at medium (52/26/21). Let one thing grow while it is the moment and then settle: the "base" mark in the binary card, or the collection name in the pinned scene (32px → larger as it is declared). The brief asks for "some start small and grow".
- Copy confirmation in the close. "Copy" showed no visible change after clicking (clipboard was correct). Show "Copied" or a tick for about 1.5s, give it a hover fill, and make it 44px tall at desktop too (now 74x32). This is the kit CodeBlock, so file it in
docs/build-notes/requests/base.mdif it can't be fixed locally. - Phone polish. (a) The "ONE STREAM" tile's landing rows overlap each other mid-animation; clip each row in its own slot. (b) "SQLite file on disk →" wraps, leaving the arrow pointing at empty space; stack the pill and sentence without the arrow under 400px. (c) The phone page is 12.4k px. Tighten the build-up spacing so each paragraph and tile pair fits one screen.
- Capability tiles: drop the 1px outline (flat #f5f5f5/#fff fill only, per part 7), or drop the fill. "Deploy to Cloud" in the dark close: fill with #fafafa, not #f5f5f7.
- "Run the binary" desktop: the h2 block sits vertically centred beside a 600px window, leaving ~220px of empty white above it. Align the head to the window's top or bottom (the 8/5 split, bottom-aligned).