- 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
/functions coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Functions.jsx (+ Functions.css) · gallery: docs/gallery/functions/ · metric id: api_key_created (proxy on this page: the functions.hero click)
Open copy questions for James: (1) "One handler, your choices" (the composer's h2) and "Compose yours" are not Hanzo copy; both were added by the earlier rebuild and are kept, "Compose yours" now set under the h2 as its caption (it used to sit above it). (2) The composer's read-back lines join Hanzo's sentences to the chosen runtime, trigger or move ("Node.js: name a runtime and point at a handler file."), and "Choose at least one trigger." is ours. (3) The hero's demo words ("Triggers", "Kubernetes", "replicas", "scaled to zero", "warm pool", "node 1", "editing", "deployed") and the scenes' labels are illustration. (4) The hero's primary is Hanzo's "Try Hanzo" (→ /login), the same words as the header's ask; any change is James's call. lib/cta.js does not exist yet.
Shared changes requested (docs/build-notes/requests/functions.md): none filed; kit gaps reported to the Cloud 1 lead: KeynoteChapters' "01 / 06" count is 12px (13px here, 14px on phones), the close's CodeBlock caption "Agent prompt" and Copy are 12 to 12.5px on phones, the stage's text-link secondary is 21px tall (44px here).
Forks this page deleted: Frame's Related (now page-local hairline rows on the graphite close), Frame's useEvery and useLive (the 380 ms setInterval and the scenes' interval loops: now single timeouts, scenes run once and rest), the replica count that climbed through invented numbers (now filled against hollow slots and a word), the hero-sized "0" in the warm scene (now three slots that empty), the overshoot curve cubic-bezier(.34, 1.56, .64, 1), the springs on the composer pills, the per-page accent.
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.jsnot built yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button;
prices fromn/a: no price on this pagelib/plans.js - Open copy questions for James listed, none decided
Done here: // header lines at the top of Functions.jsx (V2, Persona, Goal, CTA, Metric, Signature, Motion kinds, Beyond). The page's solids: "Try Hanzo" in the hero (functions.hero, data-thumb) and "Deploy to Cloud" in the close (functions.close), screens apart; "View Documentation" is the kit's text link (functions.hero-2).
2. Information architecture and navigation
Oneone<main id="main"><main>; the layout's skip link reaches its#mainmark- Every link through
A,Go,Moreorhref(); every card a real link Breadcrumb at depth 2 or moren/a: /functions is depth 1- Link parity: 0 removed, 0 unexpected
Done here: python3 scripts/parity.py /functions: links 7/7 (/login, the docs, GPUs, Machines, Containers, GitHub, deploy), all through the kit's A or Cta.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
the kit'sPageHeroKeynoteStage(h1 52px near 38% of the screen, lede, ask, the function's life); 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, closing room, footer
- Card-to-page links use Morph (related rows carry
data-morphon the name)
Done here: handler.js writes itself line by line by CSS from 0.3 s, a cursor riding the newest line, before hydration (scratchpad/f-functions-d.jpg); after hydration the calls and replicas run while seen and not paused. With JS disabled, 0 text blocks are hidden on desktop or phone (the whole file stands). Order: hero, six pinned chapters, the composer (quiet room), stacking use-case sheets, the graphite close.
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; failure never says Copied
data-ctaanddata-thumbon every primary
Done here: data-cta ids functions.hero (thumb "Try Hanzo"), functions.hero-2 and functions.close. The close's agent prompt is the kit CodeBlock, which copies exactly what it shows.
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 pause, freeze under reduced motion, hide duplicatesn/a: no marqueePrivacy link and owner line beside every submitn/a: no form
Done here: The replica count that climbed 0 to 12 (numbers Hanzo never states) is gone: the hero shows filled against hollow slots on three nodes and "replicas" or "scaled to zero". The hero-sized "0" in the warm scene is gone (MASTER part 5: a zero never gets hero size). The only figures left are Hanzo's names: v1/v2 as version labels, "/v1/function".
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: none on this page; code is the hero's own file (drawn product UI) and the close's kitCodeBlockpython3 scripts/parity.py /functions: 0 missing
Done here: Parity text 79/79, links 7/7. Deck sizes: h1 52, section headings 26 (were 32 to 128), H3 17 (sheets), chapter titles 26 (kit), lede 21, body 16, code 14, captions 13 to 14, v1/v2 44/220. On phones the hero code wraps instead of scrolling sideways. The only text under 14px at 375 is the kit close's "Agent prompt" and Copy.
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 the deck; never box plus shadow
- One icon set; no icon in a rounded box
- Differs from neighbours in hero medium and room order
Done here: Every hex in Functions.css is a deck value (#0a0a0a, #525252, #737373, #a3a3a3 on black only, #d4d4d4, #e5e5e5, #f5f5f5, #fafafa, #fff); 0 box-shadow (the GPU node's highlight is an outline ring); radii 6/8/12/16/24/999. "What you get" and "Compose yours" moved under their h2s; the sheets' "01" sits beside the title, not above it. State is filled against hollow (slots, trigger dots, the count dot, the toggles' tick), never a colour.
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 16px or largern/a: no input; no bare:hover- Forks this page deleted: listed above
Done here: Every :hover sits inside @media (hover: hover); composer buttons and related rows press to .97 (rows .99) in 90 ms; focus 2px solid var(--focus) (white on the graphite close). The two radio rows are real radiogroups with arrow keys and a roving tab stop; the toggles use aria-pressed with a tick that firms up.
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: python3 scripts/variety.py: OK (layoutId, pathLength; 0 Rise). Kinds: arrival, time (the file writing, calls arriving), idle (replicas filling and emptying), state (composer pill 300 ms [0.16,1,0.3,1], read-back lines by line mask, scenes stepping), scroll (stage, chapters, stacking sheets). 0 setInterval, no spring or overshoot; phone scenes step once and rest; the hero loop pauses with the stage's control. Reduced motion: the file stands written, replicas shown, scenes on their last step. No page sound.
10. Media
n/a: Hanzo has no image or film for Functions; the objects are drawn product UIFilmandPiconlyAt most 2 videos playingn/a: no video- Budgets met;
alt on every imagen/a: no image 4+ real visuals togethern/a: no Hanzo media for this page
Done here: Every object is HTML and SVG (the life, six scenes, the composer card, the sheets); no media weight.
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 functions: no sideways scroll, no errors. 320×640 scrollWidth 320; primary bottom at 234px at 375×667; 0 targets under 44px. On phones the hero stacks (triggers 2×2, the file, the nodes), chapters unpin (kit) and each scene plays once as it is seen.
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 (the composer's groups have legends)- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: On white #0a0a0a / #525252 / #737373; on #f5f5f5 (composer room, scene tiles) only #525252 or darker; on black #fafafa, white 78%, white 55%, #a3a3a3. Headings: h1; h2 (chapters, composer, use cases, Get Functions); h3 (chapters, sheets). The composer's read-back list is aria-live="polite".
13. Performance and engineering
- h1 and LCP element in server HTML
- JS and CSS inside budget; every image and video sized
- No poller; no third-party request before consent
- Nothing heavy run on James's laptop
Done here: Frame.jsx is no longer imported; the hero's writing is pure CSS; its tick is one timeout at a time, stopped off screen and when paused. Motion is transform, opacity and outline colour only. Filming ran in the cloud container.
14. SEO and machine files
- Title and description match live (from
content/pages.json, unchanged) - Canonical equals og:url equals the live URL
<JsonLd route="/functions">parses; no broken URL- Every card is a real link (related rows)
Done here: app/functions/page.jsx unchanged (metadata from INDEX['/functions'], <JsonLd route="/functions" />); every word, including the whole handler.js, is in the server HTML.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.md- Every card opens by Morph (related rows)
Every maker and model page linkedn/a: not a catalogueOne price figure everywheren/a: no price
Done here: Cloud product anatomy: identity (hero), the live object (the function's life), the facts that open in turn (six chapters), the composer, the use cases, the close.
16. Developer experience
- One
CodeBlockfor copyable code (the close's agent prompt); the hero's handler.js is the product object, not a copy surface Config blocks parse on their ownn/a: none- Terminal pauses and ends on a static frame (the file rests written; the stage's pause holds the calls)
- No hand-typed version number
Done here: The only copyable text is "Read https://hanzo.ai/skill.md and use Hanzo Functions in my project. Start with: hanzo functions list", byte for byte.
17. States and resilience
- Loading, empty, error and offline states designed (n/a in part: the page fetches nothing; "scaled to zero" is the drawn empty state)
- Blocked live data leaves a complete page, no console errors
A failed submit keeps its valuesn/a: no form- A thrown island does not blank the page (
app/error.jsxkeeps header and footer)
Done here: Console errors: none (film, sweep, look script; desk and phone). No trigger chosen reads "Choose at least one trigger."; paused, reduced-motion and JS-off states each read as intended.
18. Measurement and handover
data-ctaon every primary; events only through the kitCta'scta_click(hz-event;lib/track.jsis not built yet)- Nothing identifier-bearing before consent; no field value in a payload
V2: 8/10 …in the page file's top comment- Review read:
docs/build-notes/review/functions.mddoes not exist yet (no critic verdict to answer)
Done here: data-cta ids in part 4; metric api_key_created. Gallery: docs/gallery/functions/desktop.mp4, desktop.jpg, phone-1.jpg to phone-3.jpg, filmed with 0 console errors and no sideways scroll.