- 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
14 KiB
/pricing coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/Pricing.jsx (+ Pricing.css) · gallery: docs/gallery/pricing/ · metric id: cta_click on pricing.free, pricing.go, pricing.pro
Open copy questions for James: the pricing source of truth (no lib/plans.js yet; prices are Hanzo's strings in the page); the dead pricing-button destinations (Dev, Max, Ultra and Team have no checkout link on Hanzo's page; they offer "Chat with buying specialist" until James names one).
Shared changes requested (docs/build-notes/requests/pricing.md): the phone header ask outlined while a page's solid ask shows; the Band's blur reveal and double keyboard stop. Waiting on shared owners for lib/cta.js, lib/plans.js, PageHero and tokens.css; the page uses page-local deck values until then.
Forks this page deleted: the dark "recommended" Pro and Team cards, three solid buttons in a row, the page-local tab bar (now kit Tabs), hand-written tables (now kit DataTable), the reading-row stripe, the duplicate "Pay as you go" price line, the invented helper sentences, the roll-up-from-$0 arrival.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; n/a for
lib/cta.js(not merged yet): labels are Hanzo's own ("Try Hanzo", "Get API Key") - One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a for
lib/plans.js(not merged yet) - Open copy questions for James listed, none decided
Done here: The plan rail is the picker: the lowest plan of each set (Free, Team, Pay as you go) is selected by default, and the one panel carries the one solid ask of the selected plan. On desktop the shared header ask drops to an outline while it shows; on phones the shared header keeps its solid "Try Hanzo" (shared header, not this file), so the phone's first screen shows two solid fills until the shared owner changes it. Only the visible tab's asks carry data-thumb; measured on the first screen: Personal 1 solid (Free) at 1470 and 375, Team 1 at 1470; the API tab at 1470 now also shows 1 (slice D, 7 Nov: the one panel has the only data-thumb, so the header reads outlined "Try Hanzo" beside "Get API Key"); on Team the panel ask sits below the first desktop screen, so the header carries the one solid ask until it arrives.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it (the shell's#mainmark sits before the page's<main>) - Every link through
A,Go,Moreorhref(); every card a real link - n/a: breadcrumb (depth 1)
- Link parity: 0 removed, 0 unexpected
Done here: Parity shows 5/5 links. Kit Tabs (Personal, Team, API) sync to #team and #api. Trust links ("How Hanzo is secured", "Trust center", "Read the Privacy Policy") are re-homed beside the asks.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
- n/a:
PageHero(not merged yet). Nothing sits above the h1: "Pricing" cuts in by CSS line mask (700 ms) at first paint - JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in
Band, then the footer - Card-to-page: the plan's "Compare plans" grows a sheet out of its column (the page's Morph moment)
Done here: Prices are visible at once with no roll from 0. Within 0.2 s at both sizes Hanzo's model art (Enso, Zen, Kai) deals in beside the lede ("every model on one bill"), then each card lifts once in turn and rests on Enso by 4.3 s; the Pro row of the rail takes its first ladder step at 1 s. JS off: the morph panel is hidden and the plan index shows every plan whole (each Pro rung with its own price, so no misprice).
4. Conversion system
<Cta>only; no raw.x-btn- Sticky ask in header and bar after the hero, same label (shared
Ask.jsxcarries the selected plan'sdata-thumb) - n/a: no copy button on this page
data-ctaanddata-thumbon every primary
Done here: The data-cta ids are pricing.free, .go, .pro, .help, .team, .enterprise, .api.key, .api.sales and .api.try. Plan asks share one y within 1px (subgrid rows).
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
- n/a: no marquee on this page
- n/a: no form on this page; Privacy link sits beside the asks anyway
Done here: Every price is Hanzo's string. The Team total is plain arithmetic on Hanzo's seat prices for the visitor's own seat mix. Rates with float dust show their real precision (0.026250000000000002 shows as 0.02625).
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
python3 scripts/parity.py /pricing: 0 missing
Done here: Parity is 100/100 text. Kit Faq shows the first three questions open-able; the other 22 sit behind one control with their true count ("+ 22"), and their answers stay in the HTML. Model rows keep the name in the row; the detail opens in place (<details>, findable).
7. Visual design system
python3 scripts/taste.pypasses. Deck values are scoped on.xpruntiltokens.csslands- No label, tag, badge or pill above a headline
- Radii, shadows and sizes from the deck; never box plus shadow (the plan sheet is one outlined surface)
- One icon set; no icon in a rounded box
- Differs from neighbours: one morphing plan panel with a rail and rolling figures; the hero's model art answers the plan picked
Done here:
- Scale with rhythm: h1 52px; section headings 26px Book 497; prices 64px Air 220 (the one big thing per screen); body 15–16px.
- Plans: one outlined panel: a quiet rail of the set's plans on the left (across the top on phones), the selected plan on white beside it.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading (kit
Cta) - Focus ring visible on every stop of a Tab crawl
- Dialogs trap focus and return it (
x-cannon/Drawer, Esc closes) - n/a: no inputs; no bare
:hover(all inside@media (hover:hover)) - Forks this page deleted: listed above
Done here: Every control has its states:
- Segmented radios: ease 300 ms, no spring.
- Steppers: disabled at 2 and at 100 members.
- Press: .97–.98 over 90 ms.
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 none
- Something moves without input; every control answers
- Reduced motion shows the final state; the ladder uses one timeout plus an interval that ends after one lap
- n/a: sound kit not merged (shared)
Done here: The signature is morph-panel (MOTION-MAP, 7 Nov): the Personal / Team / API tabs and the plan rail drive ONE plan panel (PlanPanel in Pricing.jsx) that never remounts. Picking a plan or a tab eases the panel's height to the new plan (500 ms in-out), the name lifts out as the next rises in (300 ms emphasis), the price odometer stays mounted and rolls between real prices (Go $8 to Pro $15 to the Team total), prices said in words cross over in a row that keeps the figure's height, Hanzo's included lines slide to their new places while the lines that differ leave and arrive in a 60 ms stagger, and the usage ladder, the billing switch and the seat mixer grow in only for the plan that has them. The three swapped tab panels of cards are gone. The other movement:
- Idle: the Pro row of the rail walks its ladder (Pro, Dev, Max, Ultra, back to Pro) once within 4.3 s and stops on pointer or focus on the panel.
- State: the tab pill, the rail's selected tile sliding between plans, the sheet growing out of the panel, the details opening.
- Arrival: the h1 cut-in (the page's one reveal); the API set's reading fades in under the panel when API is picked.
- Measured: 0 console errors at 1470×801 and 375×812 (normal and reduced motion); CLS while scrolling 0.0002 desktop, 0 phone; no horizontal scroll. Reduced motion: no slides and no height ease, words still cross over. JS off: the panel is hidden and the plan index shows every plan whole. Section entrances from MOTION-MAP (slice D, page-local in Pricing.jsx/.css under html.js and no-preference): text-mask-film (Hanzo's Enso art runs through the letters of "Pricing" from the first paint, then they settle to ink), grow-from-point (the plan panel grows out of the point under the tabs; fill backwards, so no clip stays on it), scroll-tilt (the trust row arrives leaning back, then leans with the scroll's speed through a spring), vertical-ticker (the three questions ride up through their rows), underline-sweep (a rule sweeps under the Band's words). Probe: the three observed ones end with data-in and nothing under 0.5 opacity at 1470 and 375; the first two play in CSS from first paint; JS off and reduced motion show the final state.
10. Media
- Kit
Imgonly, sized (320×240 and 192×240), Enso withpriority - n/a: no video
- Three webp files already in
public/models/; decorative (aria-hidden,alt="") - No dimmed or filtered photo: the art shows as Hanzo made it
Done here: The hero strip shows Hanzo's own Enso, Zen and Kai art (the families the plans name) as black 20px cards; it is the page's only colour. The plan sheet and its rolling figures stay the main object.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320 (tables pin-scroll inside their own box)
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here:
- Phone: the art strip is 60px tall at 375 so the Free card starts inside the first screen; trust links and the band's link are 44px tall on phones (probe: no target under 44px except desktop-only links). The API tab's model families fold to one open (
<details>), and "The rates" shows three with the other five behind "Read more"; "How we bill" shows its first line on phones with the other three behind "Read more + 3" (slice D); measured page height on the API tab: 7,208px at 1470 and 9,552px at 375 (every rate and model row is Hanzo's copy and stays). Plan names in the rail and the panel roll through a clipped slot (slice D), so the Pro row walking its ladder never shows two names over each other. Probe: no in-page target under 44px at 375;check.mjs /pricing0 errors, no overlay, scrollWidth 1470/375. The columns stack with hairlines. - Compare sheet: shows one plan at a time on phones, picked from a switch over it.
12. Accessibility (WCAG 2.2 AA)
- Contrast: text #0a0a0a, #525252 and #737373 on white; on #f5f5f5 only #525252 or darker
- Pause control on every moving item (the ladder ends within 5 s; the odometer moves only on change)
- n/a: no form
- One h1; no heading skips; names start with visible text
- Keyboard reaches every control (APG tabs, radio groups, steppers, sheet with focus trap)
Done here: Prices sit in aria-live="polite". The steppers are named groups. The disclosure summaries carry the register's "Read more" as their accessible name.
13. Performance and engineering
- h1 and LCP element in server HTML
- Only the three model-art webp files (sized, Enso with priority); no film; the odometer is CSS only
- No poller; no third-party request
- Nothing heavy run on James's laptop (filmed in the cloud)
Done here: Motion is transform and opacity only. The ladder's timers live only while the panel is on screen; the panel's height ease is the one layout animation, and it runs only after a hand has touched the panel (the first paint and a #team link land still). The page's only images are the three hero model-art webp files (Enso with priority), sized; they answer the plan picker (Free lights Enso and Zen, every other plan all three).
14. SEO and machine files
- Title and description match
content/pages.json - Canonical equals og:url equals the live URL (
https://hanzo.ai/pricing/) <JsonLd route="/pricing">parses- Every model "Start Using" link is a real link
Done here: The title is "Pricing — start free, every model on one bill — Hanzo AI". Every tab, variant and answer is in the server HTML.
15. Catalogue and product pages
- n/a: not a catalogue or model page (the API tab lists model prices but no model cards)
- n/a
- n/a
- One price figure everywhere: the compare sheet and the columns read the same strings
Done here: n/a for model cards. Each model price appears once, in its group's DataTable.
16. Developer experience
- n/a: no code block (the endpoint lines are inline
code) - n/a
- n/a
- No hand-typed version number
Done here: n/a. "Get API Key" (/dev) and the OpenAI-compatible endpoint line stay.
17. States and resilience
- n/a: no live data, so no loading, empty or offline state
- Blocked live data leaves a complete page: nothing is fetched
- n/a: no form
- A thrown island does not blank the page (shared
app/error.jsx)
Done here:
- Steppers: cannot go below 2 or above 100 members.
- JS off: the panel hides and the plan index shows every plan whole (Personal, Team, API), with the API reading open; all words legible.
18. Measurement and handover
data-ctaon every primary.lib/track.jsis not merged; kitCtadispatcheshz-eventcta_click- 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/pricing.md(7.5) — its five To-reach-8 fixes are in (art answers the picker, one thumb, phone API shorter, FAQ gap and one panel, card corrected); marked Ready in slice D, 7 Nov
Done here: The V2 line is updated after the critic's next walk. The critic's eight fixes are all in this build:
- picker, one solid ask
- ladder stops under the hand
- asks in the first screen
- compare sheet readable on both widths
- the API stair as one graphic, with model detail behind disclosures
- Team total by its steppers
- JS off shows only Pro
- FAQ 3 plus a collapsed rest