- 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
13 KiB
/insights coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Insights.jsx · gallery: docs/gallery/insights/ · metric id: cta_click insights.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/insights.md): the solid-button hover token, the kit CodeBlock greys and the .v2-dark text colour onto the deck ramp (done page-locally meanwhile), and the phone header ask label. Still waiting on tokens.css, lib/cta.js, lib/track.js, PageHero, and the kit Tabs swap to land on main.
Forks this page deleted: the page's own hero shell (Frame Hero), hand-made buttons (.v2-btn became the kit Cta), a second ending (the agent prompt moved mid-page), the sticky phone visual over text (chapters now stack), every spring transition, the invented rollout percentages, the Frame code pane (now the kit CodeBlock), Frame useEvery. Round 2 removed the invented strings: the ten "Ask it a question" questions, the trimmed answer sentences, and the made-up event names in the drawings ($autocapture, $pageview, signup_completed, TypeError: …, select … from events, kill switch · no deploy). Each was checked against content/live/insights.json, content/pages and content/ui-strings.json first and was in none of them.
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 are Hanzo's hero ask (
lib/cta.jsis not on main yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button; no prices on this page
- Open copy questions for James listed, none decided
Done here: // Persona: to // Beyond: head components/pages/cloud/Insights.jsx; the one ask is Hanzo's "Open Insights" (insights.hero, insights.close). Measured with a headless walk: one solid button on the first screen at 1470×801 and 375×812.
2. Information architecture and navigation
- One
<main>; the layout's skip link reaches#main - Every link through
Aor the kitCta; related cards are real links Breadcrumb at depth 2 or moren/a: a depth-1 page- Link parity: 0 removed, 0 unexpected
Done here: Parity 67/67 text and 4/4 links; Hanzo's header and footer are untouched; every link goes through A/Cta (lib/route.js). Rounds 3-4: the separate finder block is gone; its ten tool names are the tour panels' own sub-nav, so the page draws each view once.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- Hero built from the kit's line mask (
Lines) and one object (PageHerois not on main yet); nothing above the h1 - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; loud and quiet sections alternate
- Ends in one close in Hanzo's words ("Get Insights" with the ask), then the footer
- The h1 is the
data-morph-target, so cards elsewhere open into it
Done here: The first screen is the name, Hanzo's line, the ask, and one live object: the new-dashboard flag rolled out to a percentage, then a cohort, then one account across a field of 120 people (20×6 on desktop, 12×10 on phone) who light up and send events, until the kill switch turns it off with no deploy. Measured at 1470×801 in round 2: the h1 is top-aligned with its bottom at 302px (38% of 801), the object runs from 100 to 595 so it ends inside the first screen, and "Ship it, then find out" peeks at 735. The h1 (52px, 40px on phones) cuts in by CSS line mask at first paint; a headless JS-off pass found 0 hidden text blocks. Rounds 3-4: the hero field lights in its stagger at 150 ms and the first event lands at 300 ms; "one account" grows to one big dot (scale 2.6), the page's one scale moment; the dark room sits on the section token (clamp 72-188px), no empty black above and below the code.
4. Conversion system
<Cta>only; no raw.x-btnin the page- Sticky ask: the shared ask bar carries the hero label (
data-thumb) - Copy buttons copy exactly the displayed text (kit
CodeBlock/Copy) data-ctaanddata-thumbon every primary
Done here: Hero <Cta thumb id="insights.hero">Open Insights</Cta>; the close repeats it (insights.close); Hanzo's other buttons are quiet or link Ctas.
5. Trust and proof
- No logo, seal or invented number
- Every figure traces to Hanzo's copy
Marquees pause, freeze, hide duplicatesn/a: no marqueePrivacy link beside every submitn/a: no form submits
Done here: The only figures are Hanzo's own (none; the rollout shows Hanzo's three ways in words, never a percentage); demos use Hanzo's words, never invented numbers.
6. Content presentation (copy untouched)
- No text under 13px (14px on phones) except 11–12px mono capitals and the kit's own copy label
- Measures held; headings balanced
- Code uses the kit
CodeBlock; tabs are the page's own APG-style tablist (kitTabsswap listed below) python3 scripts/parity.py /insights: 0 missing
Done here: Parity 67/67 text and 4/4 links. The tool finder uses only Hanzo's tool names and shows each one's whole sentence (its own clause in ink), never a cut. Section heads rest at 26px, the Events/Flags/OSS figures are 21px Zen Mono, and the tool name and "Start with autocapture" are 32px. Phone labels are 14px (components/pages/cloud/Insights.css).
7. Visual design system
python3 scripts/taste.pypasses (deck greys only; no hue)- No label, tag, badge or pill above a headline
- Radii 28 (objects), 16–24 (tiles); one shadow per raised object
One icon setn/a: no icons beyond the kit's- Differs from neighbours in hero medium and room order
Done here: Greys from Hanzo's deck only: the page defines the deck ramp once as tokens on .in and every rule uses them. The Apple greys (#fbfbfd, #e3e3e6, #f5f5f7, #161617, #1d1d1f, #f2f2f5), the dot glow and the "Accent: violet" note are gone. A computed-colour sweep of <main> finds no grey off the ramp; the kit's CodeBlock and the button hover are mapped page-locally and requested. One dark room (the code and the app it flips). Rounds 3-4: one surface in the hero card (no inner white cards), the tour window is outlined, not raised, the selected tab is marked by its ink underline (no lift shadow), radii on deck values.
8. UI component library
- Every control has hover (inside
@media (hover:hover)), press .97, focus-visible, disabled - Focus ring is the shared system's
Dialogs are native, trap focus and return itn/a: no dialog on this page- Inputs 16px or larger; no bare
:hoverin the page CSS - Forks this page deleted: listed above
Done here: Kit Cta, CodeBlock, Copy and Cloud 3's LivePause. Hovers tell you something: hovering a rollout mode lights a ghost of the dots it would reach (29 for "a cohort") without committing; the kill switch's knob leans 3px toward the other state and the track darkens, with a .97 press; a tour tab's number steps to ink and a hairline draws under its title. Round 4: a pointer resting on the tour window holds the tab (so its words can be read) while the panel's own views keep cycling every 2.6 s, and a pointer on the tool names holds the view; tour tabs preview their panel on hover and tick; the mode labels invert as the pill passes (mix-blend difference).
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups (
variety.pyOK) - 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
setIntervalin the page (timers aresetTimeoutchains) - Sound only on the listed moments, through the one kit (
lib/sound.js, wired bycomponents/Sound.jsx): the ask taps, tabs, radios and pause toggles tick (radios carrydata-sound="tick"), copy chimes; the demos loop while seen and never finish, so no done chime
Done here: Signature: a flag you roll out by hand. Idle: the rollout steps through its three ways and the kill switch; the window tours its tabs; the app flips with the flag. State: rollout radios and the kill switch; the tab pill glides; the finder's drawing and sentence swap per tool. Round 2 kept every move and added the mode-hover ghost. Scroll: none beyond the headline cut-in. No springs: every move is ease-emphasis at 300 ms. Rounds 3-4: each panel is a product view built from page words (event stream and SQL, flag rows and kill switch, a replay whose cursor travels its path, a heatmap, an experiment wired flag-to-metric with A/B bars, funnel / retention / paths, a rage-click spike over a stack trace, an LLM cost waterfall), each drawing itself in when its tab opens.
10. Media
n/a: no photo or film on Hanzo's pageFilmandPiconlyAt most 2 videos; pause on loopsn/a: no video- Nothing missing; no image without alt
No dimmed photo; 4+ real visuals togethern/a: Hanzo's page has no imagery
Done here: Product objects are drawn in HTML and CSS from Hanzo's words. The close carries the product's own Sigil over a field of dots, the hero's people, so it is not the shared contour close. CLS measured with a 30 s idle and a full scroll: 0.0004 at 1470×801 (all from the shared header) and 0.0000 at 375×812. Before round 2 it was 0.158 and 0.088.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320 (scrollWidth 320)
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here: At 375 the name, line and ask come first, then the rollout. The window's tabs become a swipe row, and the six panels share one grid cell, so the window holds at 736px while it tours (it used to swing between 651 and 761). The finder's ten tools become a proximity snap rail with a peek, with the answer directly under it. The code and the app stack. Nothing floats over text. Round 4: check.mjs at 375 and 1470: errors 0, covered 0, wide 0; the phone tab rail keeps the active tab fully in view as the tour moves; "Deploy to Cloud" measured 44px tall at 375.
12. Accessibility (WCAG 2.2 AA)
- Contrast: #0a0a0a and #525252 on white and #f5f5f5, #a3a3a3 and white on black
- Pause control (Cloud 3's
LivePause, 44px,aria-pressed) on every self-running object - Forms labelled (no form fields)
- One h1; no heading skips
- Keyboard reaches every control
Done here: The live object is aria-hidden with its pause button outside it; tabs and radios carry aria-selected/aria-checked; aria-live where a demo answers.
13. Performance and engineering
- h1 and the hero object are in the server HTML
- Transform, opacity and clip-path only; demo timers run only while on screen
- No poller; no third-party request
- Nothing heavy run on James's laptop (filmed in the cloud)
Done here: Timers stop off screen and when paused (useLive and useTick); bundle size not measured on this page.
14. SEO and machine files
- Title and description from
content/pages.json - Canonical through the shared
<JsonLd route="/insights" /> <JsonLd route>renders; no broken URL- Every card is a real link
Done here: app/insights/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/insights" />.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.mdEvery card opens by Morphn/a: no catalogue cardsEvery maker and model page linkedn/a: not /modelsOne price figure everywheren/a: no prices
Done here: n/a: a top-level cloud product launch page; its h1 is the data-morph-target for cards that open into it.
16. Developer experience
- One
CodeBlock; copy equals display Config blocks parse on their ownn/a: no config blockTerminal pauses and ends on a static framen/a: no typed terminal- No hand-typed version number
Done here: Hanzo's agent prompt and the app.tsx sample use the kit CodeBlock, whose Copy copies exactly what is shown.
17. States and resilience
- Every state looks intended: static copy, reduced motion and JS off checked
- No live data, so nothing to block; no console errors
A failed submit keeps its valuesn/a: n/a: no form posts anywhere; the page's inputs are in-page demos and nothing is sent- A thrown island leaves the page: the shared
app/error.jsxkeeps header and footer
Done here: A headless JS-off pass shows every word; reduced motion stops each demo on its final frame.
18. Measurement and handover
data-ctaon every primary (the kitCtasendscta_click);lib/track.jsis not on main yet- Nothing identifier-bearing; no field value in any payload
V2: 8/10line in the page file's top comment- Review read:
docs/build-notes/review/insights.md(6/10); fixes 1 to 8 done in round 2, and fix 9 (shared header) is requested
Done here: insights.hero and insights.close on the asks. Gallery: docs/gallery/insights/ (desktop film, phone stills, and round 2 frames round2-desktop.jpg, round2-phone.jpg and round2-finder.jpg). Round 4: review round 2 (7/10) fixes 1 to 7 and 9 done (rounds 3 and 4); 8 is shared chrome, filed in docs/build-notes/requests/insights.md. Proof docs/gallery/insights/round4-*.jpg.