- 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
10 KiB
/playground coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/cloud/Playground.jsx (+ Playground.css, route app/playground/page.jsx) · gallery: docs/gallery/playground/ · metric id: api_key_created
Open copy questions for James: the Python sample ends in KeysApi(api).get_keys().keys (lists keys, does not call a model); kept word for word, question left to James. The window labels ("Tokens in", "Tokens out", "Time", "Cost", "Run ·") are not yet in the UI-string register.
Shared changes requested (docs/build-notes/requests/playground.md): UI-string register entries; a hover and press for "Deploy to Cloud" in LaunchClose; the 14px phone floor for LaunchClose's facts row; scroll-behavior: auto in the motion probe's phone walk.
Forks this page deleted: the page CSS that outlined the header's "Try Hanzo"; the SettleStage wrapper on the hero (replaced by a page-local CSS arrival that cannot snap); the springs on the kind pill and the decision tree.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; label and href from the page's own CTA ("Open the Playground")
- One h1; the page is clear in 5 seconds
- No dead or self-looping button
- Open copy questions for James listed, none decided
Done here: Persona Developer, Goal "open the Playground and run a first request", metric api_key_created in both file headers. Hero has one solid "Open the Playground" beside the quiet "Read the API"; once it leaves view the header's own ask is solid (walk 7 Nov 16:36: header rgb(10,10,10) from s1 on desktop), and the close repeats "Open the Playground".
2. Information architecture and navigation
- One
<main>(shared chrome suppliesid="main"and the skip link) - Every link through
A; every card a real link - n/a: breadcrumb (depth 1)
- Link parity: 0 removed, 0 unexpected
Done here: parity.py links 7/7; the nine wall tiles and three related cards are A links to /zen…/uta, /cli, /desktop, /cloud/api-keys.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- n/a:
PageHero(not in the kit yet); the hero is LineMask h1 + lede + one ask + the running window, nothing above the h1 - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh
- Ends in the room of model films, related,
LaunchClose, footer - Card-to-page links use Morph (
data-morphon the wall art,data-morph-targeton the hero)
Done here: the window arrives once by CSS from first paint (translateY 24px, scale 1.04 → rest, 900 ms ease-emphasis), so the server frame equals the first client frame and nothing snaps. The first-request scene is 240svh (was 380) and reads itself once on arrival (a key, a model name, a message, 1.2 s apart), then hands over to scroll.
4. Conversion system
- Kit asks (
lx-cta,lx-ghost); no raw.x-btn - Sticky ask: the header's solid ask after the hero; phone bar "Open the Playground" (shared
Ask.jsx) - Copy copies exactly the displayed curl or Python text (
Copy text={tab ? PY : CURL}); the caret is anaria-hiddenelement, not text data-cta(playground.hero, playground.close) anddata-thumbon both primaries
Done here: the page no longer outlines the header's "Try Hanzo"; the solid fill sits on the hero ask, then the header. "Deploy to Cloud" now leans 3px with a 2px underline on hover and presses 1px (page-local, request filed).
5. Trust and proof
- No logo, no seal, no invented number
- The meter shows proportions only, never numbers
- n/a: marquees (none)
- n/a: forms (none)
Done here: the run meter's bars are relative shapes (RUN array) with no figures printed; every figure-like word on the page is Hanzo's.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held
- Tabs use APG roles; code shown in
prewith Copy python3 scripts/parity.py /playground: 0 missing
Done here: parity text 48/48 links 7/7. The scene sentence rests at 44px Book 497 (was 56px/600) under a 26px h2; the only sub-13 run left is the shared "RELATED CAPABILITIES" mono capitals (12px). The LaunchClose facts row is lifted to 14px on phones.
7. Visual design system
taste.pypasses- No label, tag, badge or pill above a headline
- Radii 6/8/12/16/24/28/full only; never box plus shadow
- One icon set
- Differs from neighbours (the running Playground window and the self-reading request are its own)
Done here: taste: OK (2 checked). Off-deck greys mapped (#f5f5f7→#f5f5f5, #8e8e93/#aeaeb2/#a1a1a6→#a3a3a3, #d9d9de→#d4d4d4, #161618/#111→#171717, #ececf0→#ededed); radii 10/14/22/5/3 → 8/12/24/6/full. .pg-req is outlined only (the 0 40px 100px shadow is gone); .pg-input and the selected code tab lost their shadows. The window's hairline is drawn above its own fills (.pg-win::after), so its right and bottom edges show. The UI is greyscale and so is Hanzo's model media on this page.
8. UI component library
- Hover (inside
hover:hover), press (.97 / 1px, 90 ms), focus-visible on kinds, phrases, code tabs, Copy, asks - Focus ring on the kind tabs (2px ink)
- n/a: dialogs (none)
- n/a: inputs (none; the window's "Hello" field is a drawing)
Done here: the kinds are an APG tablist (roving tabindex, ← → Home End, aria-controls to a tabpanel); the off code pane is inert. New hovers: the hero ask's arrow leans 4px, Copy fills, the selected code tab fills, the repo link's mark turns, a resting phrase greys and starts its underline.
9. Motion and interaction
- One signature (the Playground running) + 3 supporting (line-mask title, the self-reading request, the clip wipe into the dark room)
- Kinds: idle (window, caret, wall films, drifting related art), pointer (kind preview, phrase marks), time (the request reads itself once), state (kind pill, code tabs, pause), arrival (title, window)
- Something moves without input on every screen above the footer (own walk 7 Nov 16:36: desktop s0–s6 move, phone s0–s8 move)
- Reduced motion: the arrival, caret, rolling code, drift and meters are off; no
setInterval - Sound only through the shared kit
Done here: no springs or overshoot (kind pill and tree nodes on ease-emphasis 300 ms, drop 1.25). The phrase no longer animates weight (no 480→700 reflow): it lights by colour and underline only. A picked kind holds two turns (with its timer showing) and then the window carries on.
10. Media
FilmandImgonly; sizes and posters set- One film at a time in the window and one on the wall; both have a pause
- Alt from labels; decorative art
alt="" - No dimmed photo; nine real model renders together in the dark room
Done here: Video paints koma.webp under the film (no blank panel while it loads); Audio now plays Oto's own film with the waveform along its foot; each kind names the model it shows (zen, iro, koma, oto, kai) in the bar and the run panel.
11. Mobile and responsive
- 375×812 and 1470×801: no overlap
- No horizontal scroll (
scrollWidth375 at 375) - Targets 44px on phones; hover previews have tap paths
- Primary ask above the fold at 375×667
Done here: the lit kind is scrolled into the centre of the phone tab strip on every change; the hero asks wrap so the ask keeps its arrow; the clipped Python client rolls slowly through its window on phones.
12. Accessibility (WCAG 2.2 AA)
- Contrast: body on white
#525252/#737373; the 44px scene sentence at#737373on#f5f5f5is large text (3:1) - Pause control on the window and the wall
- n/a: forms
- One h1; h2s below
- Keyboard reaches every control (kinds by arrows)
Done here: the kind labels fade with the pill (300 ms) so the new label is never white on white mid-glide; the off code pane is inert; 0 title=.
13. Performance and engineering
- h1 and lede in server HTML; Iro's image
priority - Every image and film sized (1200×1500)
- No poller; no third party
- Nothing heavy run on James's laptop (all walks in the cloud)
Done here: the hero arrival is pure CSS (no layout work on hydration); the scroll ease-back is one useTransform on transform only.
14. SEO and machine files
- Title and description from
content/pages.json - Canonical from the shared layout
<JsonLd route="/playground" />- Every card is a real link
Done here: app/playground/page.jsx reads INDEX['/playground'] for metadata and renders JsonLd.
15. Catalogue and product pages
- n/a: model card (
SPEC.md): not a catalogue or model page; the wall uses model renders, not the model card - Wall tiles carry
data-morphand open their model pages - n/a: maker lists
- n/a: prices (none on the page)
Done here: the nine wall tiles link to /zen, /enso, /kai, /iro, /koma, /koe, /mori, /oto, /uta.
16. Developer experience
- Copy equals display (the shared
Copycopies the sameCURL/PYstring theprerenders) - n/a: config blocks (no JSON config)
- The scene ends static under reduced motion
- No hand-typed version number
Done here: curl and Python are Hanzo's own, unchanged; the active token is marked inside the real request; the shared CodeBlock is not used here (the pre is page-local), listed as a known gap.
17. States and resilience
- Video and Audio show their poster until the film plays
- No live data on the page; complete with the API blocked; 0 console errors
- n/a: forms
- Islands are self-contained; a failed film leaves its poster
Done here: own walk 7 Nov 16:36 at 1470×801 and 375×812: status 200, 0 console errors from this page.
18. Measurement and handover
data-ctaon both primaries; events through the shared ask- Nothing identifier-bearing before consent
V2:line inPlayground.jsxandapp/playground/page.jsx- Review read:
docs/build-notes/review/playground.md(6/10 at 15:24 read and answered; the re-walk is pending)
Done here: every fix in the 15:24 review's "Fixes (in order)" list is answered above; proof in docs/gallery/playground/ (d.jpg, p.jpg, d-0..2.png, p-0..2.png, d.mp4).