Files
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

16 KiB
Raw Permalink Blame History

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

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

Open copy questions for James: none decided. Two to confirm: (1) "Storage" is the live eyebrow over the h1; MASTER part 7 moves it, so it names the stage's toolbar here, words unchanged; (2) the black room's figures show Hanzo's counted words as numerals ("ten data shards" → 10, "four parity" → 4, "four can be lost" → 4, "One binary" → 1); the words stay in the chapters. Shared changes requested (docs/build-notes/requests/s3.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 stage above the h1 (the title now comes first), the data-cursor="Lose" / "Restore" labels that followed the pointer, the shard springs ({170, 24}) and the ✕ spring, the shard that lifted and scaled on hover, the stage's hairline-plus-fill, the object's ring-plus-shadow, the volumes' and roles' shadows, the roles' opacity .45 (it failed contrast), the legend floating over the stage's corner, the figures' 64–112px override, every Apple-grey literal (#6e6e73, #8e8e93, #aeaeb2, #c7c7cc, #ececf0, #f5f5f7, rgba(29, 29, 31)).

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 storing objects · Goal: call the S3 API · CTA: "API reference" → docs.hanzo.ai/docs/openapi/s3 · Metric: api_key_created, plus Signature, Beyond and V2:, head S3.jsx and app/s3/page.jsx. fs-audit.cjs counts one solid ("API reference") 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 /s3: 3/3 links (API reference, hanzoai/s3, Deploy to Cloud).

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 the kit's LineMask h1, the lede, one ask and the live stage); 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 Object Storage", the one ask, licence, repo and "4 stars")
  • Card-to-page links use Morph; title lands within 12px (n/a: no card links out; the hero is a data-morph-target)

Done here: The 52px title sits first on the 8/5 split with the lede and ask bottom-aligned beside it; the stage follows on the same screen, its pause, "Storage", legend and readout in its own top row. The object breaks up 450 ms after load; fs-audit.cjs measures motion in 0.9 s on both sizes and nothing above the h1. Rooms: hero, the peel (facts beside the 3D stack), black room, close.

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="s3.hero" data-thumb="API reference", the close s3.close with the same thumb; data-ask-name="Hanzo Object Storage" is on the hero section; the bar carries "API reference" in the look2 shots after the hero.

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: 10, 4, 4 and 1 are Hanzo's own counts, each with its words beside it ("data shards", "parity shards", "can be lost, and it still reads", "binary, four roles"); they cut in once and are never counted. "4 stars" is Hanzo's.

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)
  • python3 scripts/parity.py /s3: 0 missing

Done here: Parity 28/28 text, 3/3 links. Sizes: h1 52, "An object, kept" 44, fact titles in the peel list, role names 21, the black room's one figure at 64 ("4 can be lost, and it still reads", in a wider column; the other three at 26), lede 20, body 16, captions 13; 12px only for Zen Mono capitals. The "01 / 04" counts sit under each fact title.

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, #d4d4d4, #e4e4e7, #ededed, #f5f5f5, #171717, #262626, #000. The stage is a flat #f5f5f5 tile (24) with flat white volumes and object (16); the diagram is a hairline on paper; nothing has a shadow. No other Cloud 3 page opens on a title-first stage of shards and volume servers.

8. UI component library

  • Every control has hover, press, focus-visible, disabled, loading (n/a for loading: nothing is fetched; once four are dark a fifth tap is refused with a 3px sideways nudge and the readout "4 / 4 dark · still reads", and the ten survivors stay bright white with ink shards: no disabled-grey, so they read at full contrast)
  • Focus ring visible on every stop of a Tab crawl (kit: 2px ink with a white halo, inverted in the black room)
  • Dialogs are native, trap focus and return it (n/a: no dialog)
  • 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 fourteen volumes are buttons with aria-pressed and a name ("Volume server d3"); hover fills #e4e4e7 and turns the name and its line ink, press .97 in 90 ms. Replay and the pause answer the same way; text links press 1px. No cursor label anywhere.

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 peel (MOTION-MAP, 7 Nov), second screen (s3/Peel.jsx): "An object, kept" sets the four facts as a list (each title a button, "01 / 04" under it) beside a stage where the binary is one slab in 3D (one rotated plane, orthographic; each layer one translateZ). While seen it lifts apart into four floating layers, top to bottom HTTP gateway, filer, master, volume servers, their names riding beside them in 2D (900 ms ease-in-out scene move, layers staggered 50 ms). Open, it walks the other facts on the same layers: Hanzo KMS's lock lands on the volume servers ("Hanzo KMS → server-side encryption, config file struck"); the ten data and four parity shards on that layer lose four and "✓ still reads" lands; dashed posts of one binary protocol stand between every layer (gRPC struck). Then it closes back into "one binary" and loops. Picking a fact goes to it and holds (the pause turns to play, which hands the loop back); pointing at a role name outlines its layer. Kept as approved: the hero's erasure-coding stage (Kept: shards on 500 ms tweens via layoutId, four dark, tap your own four, Replay). Removed: the pinned Roles chapters (PinnedChapters) and the black room's timed wipe (ClipWipe); the line mask (h1, black-room figures) is the one reveal. Reduced motion (read after hydration): the stack rests open, no transitions. JS off: the stack renders open with every role named and all four facts in order. Checked at 1470×801, 375×812 and 320: 0 console or page errors (reduced motion too), CLS ≤ 0.011, no sideways scroll. variety.py OK; no setInterval. Entrances (MOTION-MAP, s3/S3Enter.jsx, one per section, once): text-mask-film (a strip of shards runs through the letters of "An object, kept", then the ink returns), iris (the peel's stage opens on a circle from its centre), shutter (two graphite bars meet over the black room's figures, then part to the top and bottom), cursor-lens (a round lens sweeps once across the agent prompt magnifying an inert copy, then follows a mouse; a tap places it on touch), grid-wave (tiles over the close's drawing ripple away by distance from the cursor, or from its centre). Final state in the server HTML; armed only after mount and only below the fold; reduced motion skips all; a walk to the footer leaves nothing armed at 1470 or 375 (probe, 7 Nov); CLS 0.0000 at 375, 0.0005 at 1470.

10. Media

  • Film and Pic only; sizes and posters set (n/a: Hanzo has no Object Storage photo or film)
  • At most 2 videos playing; pause button on loops over 5 s (the stage'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 stage, the roles diagram, the figures, the agent prompt with its /v1/s3/buckets tag) and the close's Sigil from figures [10, 4, 4].

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: The object's readout wraps inside its card on desktop (it overflowed 35px when set to one line) and stays one line only on phones; the fan's lines stop at the volume grid's edge, so no stub shows between tiles. Phone order: title, lede, ask (y≈248 at 375×667, measured by the critic), then the stage with the object in a row on top and the volumes in a 5×3 grid; the legend wraps in the stage's top row. The diagram sits in a 38svh window and pinchk.cjs passes 5/5. Pointing previews are pointer-only; tapping a volume is the tap path.

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 (legend, quiet roles), #737373 on white 4.74:1 (volume names), white 78% and #a3a3a3 on #000 in the black room. Quiet roles no longer fade with opacity. Headings: h1, h2 (intro), h3 ×4, h2 (close); the readout and "✓ still reads" are aria-live.

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 loop is a setTimeout chain that runs only while 30% in view, unpaused and not pointed at; motion is transform, opacity and stroke. 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/s3/page.jsx takes metadata from content/pages.json unedited and renders <JsonLd route="/s3" />.

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)
  • 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, "Storage"), the live stage, a 4-fact strip of Hanzo's figures, four openable facts, the close with licence, repo and stars.

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 (n/a: no terminal)
  • No hand-typed version number

Done here: The agent prompt with its api /v1/s3/buckets tag is 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 stage's own states are designed: whole, sharded, four dark, still reads, a hand-picked four (a fifth tap refused with a nudge, the ten left bright), Replay, paused. The peel's shard step plays its loss: four shards on the volume-server layer go dark one after another, then "✓ still reads" lands. Reduced motion shows it reading with four dark.

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/s3.md (7/10 on the walk before this build). In this build: the readout stays in its card, the fan lines no longer run under tiles, and the black room's four figures rest with one big and three at 26px. Slice D (7 Nov): the big one is now "4 can be lost, and it still reads" (the promise, not a count the hero already showed), the room's padding is trimmed, and on phones the object row keeps its shards top-right with the readout on its own row, so the phase readouts no longer move them (CLS 0.0195 → 0.0000 at 375 over 10 s; 0.0005 at 1470). Not changed, as a decision: the ten/four figures stay in the hero legend and chapter 3 because they are Hanzo's copy, and the shared close (LaunchClose, owned by Cloud 3) keeps its order.

Done here: s3.hero and s3.close are set. Gallery: docs/gallery/s3/d.mp4, d.jpg, p.jpg, d-room.jpg (refreshed 7 Nov). Marked Ready in docs/build-notes/review/s3.md (slice D): readout held in its card at 1470/1100/375/320 over two runs, fan ends at the grid edge, 0 console errors, no sideways scroll.