- 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
/datastore coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Datastore.jsx (+ Datastore.css) · gallery: docs/gallery/datastore/ · metric id: api_key_created (developers; the click is cta_click datastore.hero)
Open copy questions for James: "Which way in?" is our heading for the protocol picker, not Hanzo's (Hanzo's "SQL, on several protocols" sits under it as its caption); keep it or move it to content/ui-strings.json? The demo labels are ours too ("example" rows, "node", "replica", "partition", "TTL", "Raft quorum", the scene captions, "Reads N of 12 columns" past Hanzo's own "Reads 1 of 12 columns"). Live's "Get Datastore" line reads "Document datastore" on a column-store page; kept exactly as live. "4 stars" is the live page's static GitHub figure.
Shared changes requested (docs/build-notes/requests/datastore.md): none. Kit notes for the Cloud 1 owner: the kit Flap flips through other digits (banned by brief 2 rule 8), so this page no longer uses it; KeynoteClose's "Self-host" text link reads --ink in the dark room and the kit link asks are 21px tall (set white and 44px here).
Forks this page deleted: the kit Flap split-flap (flipped 8128 → 8123 through foreign digits; now a page-local board where each true digit drops in from behind its tile's mask, 60 ms apart); the hero count's opacity rise (now a mask cut); 3 setInterval loops (phone chapter scenes, the exploded table's phone cycle; now one pass each with setTimeout); the fake tablist without panels on the exploded table's rail (now a nav of buttons with aria-current); the scrolling-by-__lenis jump (now lib/scroll scrollToY); the accent --ac and every off-deck grey (#fbfbfd, #e3e3e8, #f0f0f3, #f2f2f5, #e8e8ed, #f5f5f7, rgba 115/115/115 tints); 4 box-shadows; the 44px h1 (size="md", now the kit's 52px), the 128px/96px port, the 40px port numbers, the 26px clamp SQL.
Tick what applies. Strike the rest as n/a: reason. Fill each Done here: line with one or two sentences of evidence (a value, a file, a number). A part counts once its Done here: line has text.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; label and href from Hanzo's copy (
lib/cta.jsdoes not exist yet; labels are the live hero's) - One h1; the page is clear in 5 seconds
- No dead or self-looping button;
prices fromn/a: no priceslib/plans.js - Open copy questions for James listed, none decided
Done here: The hero's one own solid is "Try Hanzo" → /login (datastore.hero, data-thumb); "Documentation" → docs.hanzo.ai is a kit text link (datastore.hero-2). The close's one solid is Hanzo's "Deploy to Cloud" (datastore.close) with the "Self-host" link. The first screen reads "A column store for analytical SQL" over the query console scanning one column of twelve.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Go,Moreorhref(); every card a real link Breadcrumb at depth 2 or moren/a: /datastore is depth 1- Link parity: 0 removed, 0 unexpected
Done here: Every link goes through the kit's Cta (hero and close) or A (close chips). parity.py /datastore: links 5/5.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
the kit's KeynoteStage stands in untilPageHeroPageHeromerges; nothing above the h1- JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in proof strip,
Band, footer (the close is Hanzo's own "Get Datastore" dark room) Card-to-page links use Morphn/a: no card opens into a page
Done here: With Next's JS blocked (prehyd.cjs), the scan beam runs down the event file in the server HTML (screens differ by 150 and 566 samples at 250–1000 ms). With JS off nothing is hidden (audit: 0 hidden text): the exploded table unpins and its four sentences stand stacked. Order: query console (hero) → what it does (six pinned facts) → where the speed comes from (pinned, quiet room) → what people point it at (index) → which way in (quiet room) → Get Datastore (dark).
4. Conversion system
<Cta>only; no raw.x-btn- Sticky ask in header and bar after the hero, same label
- Copy button copies exactly the displayed text (the close's kit
CodeBlock); failure never says Copied data-ctaanddata-thumbon every primary
Done here: datastore.hero, datastore.hero-2, datastore.close, datastore.close-self. On desktop the header's button outlines while the hero's solid is on screen (SYSTEM §5); on phones the bar stays away because the hero's words equal the header's.
5. Trust and proof
- No logo without documented permission; no seal; no invented number
- Every figure traces to Hanzo's copy; qualifier beside the number
Marquees pausen/a: no marqueePrivacy link and owner line beside every submitn/a: no form
Done here: The only figures are Hanzo's: 8123, 9000, 12 columns, Apache-2.0, "4 stars" and the index numbers 01–12. No counter or board ever draws a digit that is not the true one: the hero's count and the port board cut in from behind a mask. The example table's cells carry no values.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held; no orphan word in a heading
Tables, FAQ, tabsn/a: the console and exploded table are drawn objects; code uses the kitCodeBlock(close)python3 scripts/parity.py /datastore: 0 missing
Done here: Parity 78/78 text, 5/5 links. Sizes are deck only: h1 52 (40 phone), headings 26, H3 26 (kit chapters) / 21, lede 21, SQL 21 (16 phone), body 16, labels 14/13, mono 12 digits; figures: the port board 64px Air 220 (52 phone), ports 32px Air, the count 26px. Column names break only at their underscore (duration_ms), never mid-word.
7. Visual design system
python3 scripts/taste.py <files>passes; no literal hex outside the deck- No label, tag, badge or pill above a headline
- Radii, shadows and sizes from tokens; never box plus shadow
- One icon set; no icon in a rounded box
- Differs from neighbours in hero medium and room order
Done here: taste.py (main's 0.03 chroma) OK. Colours: #fff, #fafafa, #f5f5f5, #ededed, #e4e4e7, #d4d4d4, #a3a3a3 (lines), #737373, #525252, #0a0a0a, black 10%, white 0–40% (the scan light on ink). 0 box-shadows; radii 6/8/12/16/24/999. "SQL, on several protocols" now sits under "Which way in?"; the speed sentences' 01–04 sit under their words. A column being read fills with ink; a column that steps back keeps a hollow outlined name.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading
- Focus ring visible on every stop of a Tab crawl
Dialogsn/a: no dialog on this pageInputs 16pxn/a: no input; no bare:hover- Forks this page deleted: listed above
Done here: Column files (aria-pressed; event is aria-disabled, it is the query's own), the speed rail (aria-current), the protocol radios all press to .97 in 90 ms, hover by border or fill inside @media (hover: hover), focus with 2px solid var(--focus).
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups
- At least 3 kinds of movement; scroll-linked is half or less
- Something moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - Sound only on the listed moments, through the one kit
Done here: variety.py OK (useScroll; 0 Rise, 0 Flap). Idle: the console adds and drops columns by itself every 2.6 s (gated on live && !useStagePause()). Scroll (1 of 5 kinds): the pinned facts and the exploded table. State: pressing a column rewrites the SQL; the protocol board. Time: the scan beam, the streams running three times and resting, the rollups settling. Arrival: line masks and the board's digit drops. 0 springs; deck easing.
10. Media
n/a: no photo or film; the objects are drawn product UIFilmandPicAt most 2 videosn/a: no video- Nothing missing;
altn/a: no image No dimmed photo; 4+ real visualsn/a: Datastore has no Hanzo media
Done here: Every section's object is product UI in HTML and SVG: the console, six scenes, the exploded table, the index, the port board.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here: sweep.cjs datastore: no sideways scroll, no errors (desk + 375). audit2.cjs: 0 sideways at 320, 0 targets under 44px on phone. At 375×667 "Try Hanzo" sits at y≈299–343. The files grid is 4 across on phones, 6 at 900–1199, 12 above.
12. Accessibility (WCAG 2.2 AA)
- Contrast measured, text at 4.5:1 or better
- Pause control on every moving item
Forms labelledn/a: no form- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: On white #525252/#737373; in the quiet rooms and scenes --quiet/--body become #525252; on ink #fafafa. Headings: h1 → h2 → h3 ×6 → h2 → h3 ×4 → h2 ×3. The SQL line and the board are aria-live="polite"; the board's value is real text for readers.
13. Performance and engineering
- h1 and LCP element in server HTML
- JS and CSS inside budget;
every image sizedn/a: no image - No poller; no third-party request before consent
- Nothing heavy run on James's laptop
Done here: Only setTimeout steps, run while seen; the exploded table writes three CSS variables per scroll frame, no React render per frame beyond the step. Filmed in the cloud container.
14. SEO and machine files
- Title and description match live (from
content/pages.json) - Canonical equals og:url equals the live URL (
<JsonLd route="/datastore" />) <JsonLd route>parses; no broken URLEvery card is a real linkn/a: no cards
Done here: app/datastore/page.jsx is unchanged: metadata from content/pages.json and <JsonLd route="/datastore" />.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.mdEvery card opens by Morphn/aEvery maker and model page linkedn/aOne price figure everywheren/a: no price
Done here: Cloud product anatomy: identity (hero), the live object (the console), facts that open in turn (six pinned scenes, four layers), the close.
16. Developer experience
- One
CodeBlock; copy equals display (the close's agent prompt) Config blocks parsen/a: no config blockTerminal pausesn/a: no terminal; the self-running console has the Stage pause- No hand-typed version number
Done here: The agent prompt is the kit CodeBlock in KeynoteClose; the hero's SQL is a live readout of the pressed columns, not a copy target.
17. States and resilience
- Loading, empty, error and offline states designed (n/a beyond: no fetch)
- Blocked live data leaves a complete page, no console errors
A failed submitn/a: no form- A thrown island does not blank the page (site error boundary)
Done here: Dropping every extra column returns the console to Hanzo's own "SELECT count() …" and "Reads 1 of 12 columns"; paused, reduced-motion (the table rests on its last layer) and JS-off states read as intended. Console errors: none.
18. Measurement and handover
data-ctaon every primary; events only through the kit'sCta(cta_click)- Nothing identifier-bearing before consent; no field value in a payload
V2: 8/10 …in the page file's top comment- Review read: no
docs/build-notes/review/datastore.mdyet
Done here: ids listed in part 4; metric api_key_created. Gallery: docs/gallery/datastore/ (desktop.mp4, desktop.jpg, phone-1..3.jpg). Own score 8/10; the critic's verdict decides.