Files
site/docs/build-notes/coverage/node.md
Claude 07cf81bd47 Handoff layout: new README; build-chat notes moved to docs/build-notes/
- 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
2026-11-08 13:22:36 +00:00

13 KiB
Raw Permalink Blame History

/node coverage (MASTER.md part 2, the 18 parts)

Page file: components/pages/cloud/Node.jsx (+ .css) · route: app/node/page.jsx · gallery: docs/gallery/node/ · metric id: api_key_created

Open copy questions for James: none decided. One to confirm: the spec row shows Hanzo's counted words as numerals ("One Rust binary" → 1, "Three commands" → 3, the five levels Hanzo lists → 5, "a tenth of the block reward" → 1/10); the words themselves stay in the chapters. Shared changes requested (docs/build-notes/requests/node.md): Frame's Paste on the deck (page-local overrides until then); Copy press to .97; the desktop ask bar floats over content; a hue in the shared nav icon; the pinned chapter count above the h3; lib/cta.js and lib/track.js. Forks this page deleted: the useSpring lean (now a CSS-eased tilt of 2.5° at most), the 52px "Why Run a Hanzo Node" h2 that sat on one screen with 64px figures (now 26px), the black room right after a dark terminal (now a quiet #f5f5f5 room), the terminal's drop shadow, three equal "hanzo fabric" buttons (now one command bar), the LED's halo ring, every Apple-grey literal (#6e6e73, #8e8e93, #c7c7cc, #e3e3e8, #ececf0, #f2f2f5, #f5f5f7, #2c2c2e, #a1a1a6, #d2d2d7), the 600–900 ms line and bar animations (now 400–500 ms).

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 lib/cta.js (n/a for the file: it does not exist yet; the label and href are Hanzo's live hero ask)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; prices from lib/plans.js (n/a: no prices)
  • Open copy questions for James listed, none decided

Done here: Persona: Developer with a machine to lend · Goal: run a node · CTA: "Run a Node" → docs.hanzo.ai/docs/proof-of-ai/node-operator · Metric: api_key_created, plus Signature, Beyond and V2:, head Node.jsx and app/node/page.jsx. fs-audit.cjs counts one solid ("Run a Node") on the first screen at both sizes.

2. Information architecture and navigation

  • One <main id="main">; skip link reaches it (the layout's skip link targets the one <main>)
  • Every link through A, Go, More or href(); every card a real link
  • Breadcrumb at depth 2 or more (n/a: depth 1)
  • Link parity: 0 removed, 0 unexpected

Done here: Every link is kit A. parity.py /node: 4/4 links; "About the Network" goes to /network with data-morph.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • PageHero (n/a for the component: not merged; the hero is a line-masked h1 (page-local Title, cut after first paint), caption, lede, one ask and the live machine); nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; no 3 same-height sections in a row
  • Ends in proof strip, Band, footer (LaunchClose: Sigil, "Get Node", the one ask, licence and repo)
  • Card-to-page links use Morph; title lands within 12px

Done here: The first screen is one machine on the left seven columns (flat #f5f5f5 surface, the command bar, one white readout: the level being served at 40px, the five-bar ladder, hardware and Lux as one quiet line each) and the 52px title, "Decentralized AI Compute" as its caption, the lede and the ask on the right. No settle pop: scale 1 in server HTML, JS off and reduced motion. The h1 starts 44% into its mask, so it reads from the first frame.

4. Conversion system

  • <Cta> only; no raw .x-btn (the kit's 48px lx-cta; swapped when the deck Cta lands)
  • Sticky ask in header and bar after the hero, same label (the site's Ask.jsx reads data-thumb)
  • Copy button copies exactly the displayed text; failure never says Copied (Frame's Paste uses the kit Copy)
  • data-cta and data-thumb on every primary

Done here: The hero ask has data-cta="node.hero" data-thumb="Run a Node", the close node.close with the same thumb; data-ask-name="Hanzo Node" is on the hero section. "Quickstart" is a ghost, the rest text links.

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 duplicates (n/a: no marquee)
  • Privacy link and owner line beside every submit (n/a: no form)

Done here: Only Hanzo's words and figures: "A tenth" of the block reward is the one big statement (64px) and opens the levels sheet; no derived figures, no drawn hashes (Lux roots are unlabeled squares).

6. Content presentation (copy untouched)

  • No text under 13px (14px phone) except mono capitals
  • Measures held; no orphan word in a heading
  • Tables, FAQ, tabs and code use the kit parts (n/a for tables, FAQ and tabs: none; code is Frame's Paste and the drawn terminal)
  • python3 scripts/parity.py /node: 0 missing

Done here: Parity 37/37 text, 4/4 links. Sizes: h1 52, caption 21, "A tenth" 64 (the next screen's one big thing), section heading 26, chapter titles 32, the machine's readout 40 (declared/attested 64 as their chapter's moment), lede 20, body 17, mono 13-17.

7. Visual design system

  • python3 scripts/taste.py passes; no literal hex outside tokens (deck values only)
  • 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 OK; values #0a0a0a, #525252, #737373, #a3a3a3, #d4d4d4, #e4e4e7/#e5e5e5, #ededed, #f2f2f2, #f5f5f5, #171717. The machine is one flat #f5f5f5 surface (radius 24) holding the #171717 command bar and a white readout (radius 16); the lit level is its one ink block.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading (n/a for disabled and loading: nothing is ever unavailable or fetched)
  • Focus ring visible on every stop of a Tab crawl (kit: 2px ink, white halo)
  • Dialogs are native, trap focus and return it (the kit Sheet for "See the levels": focus to Close, Esc, focus back to the button)
  • Inputs 16px or larger; no bare :hover (n/a for inputs: none; every hover is in @media (hover:hover))
  • Forks this page deleted: listed at the top

Done here: The five ladder bars (96px desktop, 72px phone; hover fills #ededed and greys the bar, press .97), the drive bar (up / join / stop, aria-pressed), the six rail dashes (44px, hover well), the pause, and "A tenth" (its plus turns 90° and fills ink) all answer on hover and press; the hero ask's arrow nudges 4px beside its fill change.

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 (n/a: the shared sound kit has not landed)

Done here: Signature: one machine from hero to chapter six. Idle: it keeps serving from the frame you see (jobs light levels, roots settle), rests, play replays from hanzo fabric up. Pointer: tilt (2.5°), a level you point at takes a job. Scroll (under half): the machine pins on the left and becomes the chapter stage, growing 4% while it is the stage; the chapter not on stage is at 32% so one thing reads at a time. Time: each chapter's 2.8 s beat inside the machine (hardware at 44px, bars fill, the asked question lit, declared struck then attested ringed, the verb's effect, the root committed). State: drive control, levels sheet, odometer count.

10. Media

  • Film and Pic only; sizes and posters set (n/a: Hanzo has no Node photo or film)
  • At most 2 videos playing; pause button on loops over 5 s (the machine's 44px pause is first in its toolbar)
  • Budgets met; nothing missing; alt on every image (n/a: no images)
  • No dimmed or filtered photo; 4+ real visuals together where the page has them (n/a: no media)

Done here: Objects are drawn product UI (the machine, the figures, the terminal, the agent prompt) and the close's Sigil from figures [5, 3, 10].

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: Phone order: title, caption, lede, ask, then the hero machine (five 72px bars), "A tenth", then each chapter with its own small machine playing its beat as it arrives (no pin, MASTER part 11). 375 and 320: scrollWidth equals the viewport, no text cut by its box.

12. Accessibility (WCAG 2.2 AA)

  • Contrast measured, text at 4.5:1 or better
  • Pause control on every moving item
  • Forms labelled; first error focused (n/a: no form)
  • One h1; no heading skips; names start with visible text
  • Keyboard reaches every control

Done here: #525252 on #f5f5f5 7.4:1 (the cells), #737373 on white 4.74:1, #a3a3a3 on #171717 7.1:1 and on #262626 6.0:1 (terminal), #d4d4d4 on #171717 12.6:1. Headings: h1, h2 (why), h3 ×6, h2 (quiet room), h2 (close). Status is aria-live; levels are named buttons.

13. Performance and engineering

  • h1 and LCP element in server HTML
  • JS and CSS inside budget; every image and video sized (n/a for media: none)
  • No poller; no third-party request before consent
  • Nothing heavy run on James's laptop

Done here: The machine runs on a setTimeout chain only while 30% in view and unpaused; the tilt writes one transform with no React state. Filming ran in the cloud.

14. SEO and machine files

  • Title and description match live (or are listed for James)
  • Canonical equals og:url equals the live URL (owned by the shared layout)
  • <JsonLd route> parses; no broken URL
  • Every card is a real link (n/a for cards: none on this page)

Done here: app/node/page.jsx takes metadata from content/pages.json unedited and renders <JsonLd route="/node" />; the hero carries data-morph-target for /network's "Provide Compute".

15. Catalogue and product pages

  • Model card matches SPEC.md (n/a: not a catalogue or model page)
  • Every card opens by Morph (n/a: no cards; "About the Network" carries data-morph)
  • Every maker and model page linked in the DOM (n/a)
  • One price figure everywhere (n/a: no prices)

Done here: A cloud product on the shared anatomy: identity (title and caption), the live machine, a 4-fact strip from Hanzo's words, six openable reasons, the close.

16. Developer experience

  • One CodeBlock; copy equals display (the agent prompt copies exactly what it shows)
  • Config blocks parse on their own (n/a: no config block)
  • Terminal pauses and ends on a static frame (the hero machine pauses; each chapter's beat plays once in 2.8 s and ends on its final frame; reduced motion and JS off show that frame)
  • No hand-typed version number

Done here: hanzo fabric up / join / stop and the agent prompt are the code on the page; Copy writes the displayed string. No version numbers.

17. States and resilience

  • Loading, empty, error and offline states designed (n/a: nothing is fetched; the page is whole at first paint)
  • Blocked live data leaves a complete page, no console errors
  • A failed submit keeps its values and shows no success (n/a: no form)
  • A thrown island does not blank the page (Sigil, Phone and Cursor boundaries are the shared layer's)

Done here: The machine's own states are designed: stopped (hollow LED, blinking caret), starting, joined (grey), serving (ink), "waiting for work" in the first of three dashed root slots (reserved from the start, so a new root never moves anything), a stop that leaves the same-named process running. Reduced motion shows it serving with roots settled.

18. Measurement and handover

  • data-cta on every primary; events only through lib/track.js (n/a for the file: not built yet; ids are in place)
  • Nothing identifier-bearing before consent; no field value in a payload
  • V2: <score>/10 <one line> in the page file's top comment
  • Review read: docs/build-notes/review/node.md verdict 8 or more (pending: no verdict had landed at push time)

Done here: node.hero and node.close are set. Gallery: docs/gallery/node/desktop.jpg, phone-1.jpg, phone-2.jpg (8 Nov, round 5 CSS); earlier stills kept.