- 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
8.9 KiB
/solutions coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/solutions/SolutionsIndex.jsx + SolutionsIndex.css + openTile.js. The family keeps solutions.css and Solution.jsx, untouched. · Route: app/solutions/page.jsx · Gallery: docs/gallery/solutions/ · Metric id: signup_start
Open copy questions for James:
- (1) The catalogue type asks for the exact count as the hero figure. Hanzo's copy prints no total for /solutions, so none is shown. Should "17" (from
content/pages.json) be allowed? - (2) The tiles carry a numbered caption ("01 / 17", the MASTER §4 supporting technique). These are new marks, so this is listed here.
Shared changes requested (docs/build-notes/requests/solutions.md):
- None filed. The solution pages (
Solution.jsx, another chat's) do not calluseArrival, so this index's open lifts its own cover (openTile.js). Once Morph is fixed site-wide, the tiles can go back to it.
Forks this page deleted:
- The "All" chip.
- The per-tile group labels.
- Raw
<img>and<video>(now kitImgandFilm). - The springs.
data-morphon tile names.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport. "Try Hanzo" is Hanzo's own label (
lib/cta.jsdoes not exist yet); "Contact sales" is a quiet outline. - One h1; the page is clear in 5 seconds
- No dead or self-looping button. Prices: n/a, none on this page.
- Open copy questions for James listed, none decided
Done here: at 1470×801 the h1, lede and both asks sit above the fold (ask bottom at y=716). At 375×812 the ask bottom is at y≈482.
2. Information architecture and navigation
- One
<main id="main">(layout); skip link (layout) - Every link through
A; every card a real link - n/a: breadcrumb. This is a depth-1 index.
- Link parity: 0 removed, 0 unexpected
Done here: links 20/20 (17 solutions, reserved, /signup, /contact-sales). Every tile is an <a href> to its page.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input. Once the curtain lifts, the h1 cuts in and the reel starts.
PageHeroequivalent: MaskLines h1, lede, one ask, the reel. Nothing sits 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 the reserved tier's black room, Hanzo's own closing line and ask, then the footer.
- Card-to-page opens.
openTile.js: the tile's rectangle fills the screen and lifts on the destination. Morph is broken site-wide.
Done here:
- Playwright: while the curtain is up, the reel bar is not running. After it lifts (about 4.4 s) the bar runs.
- Clicking tile 1 landed on
/solutions/financewith no cover left on screen.
4. Conversion system
- No raw
.x-btn. A page-local pill until kitCtamerges. - Sticky ask in header and bar after the hero, same label ("Try Hanzo")
- n/a: copy button. None on this page.
data-ctaanddata-thumbon every primary
Done here: data-cta values are solutions.hero, solutions.sales and solutions.reserved; data-thumb="Try Hanzo".
5. Trust and proof
- No logo, no seal, no invented number
- Every figure traces. The only numbers are counts of the page's own items (07, 07, 03, 01 / 17).
- n/a: marquees. There are none.
- n/a: Privacy link. There is no form.
Done here: each tile's jobs are Hanzo's sentences from that solution's page (solData.js).
6. Content presentation (copy untouched)
- No text under 13px, except 12px mono capitals
- Measures held; no orphan word in a heading
- Tabs: the group words are
aria-pressedtoggles. n/a: tables, FAQ, code. python3 scripts/parity.py /solutions: 0 missing
Done here: parity text 47/47, links 20/20.
7. Visual design system
taste.pypasses; only deck greys (#0a0a0a, #525252, #737373, #ededed, #a3a3a3, #000)- No label, tag, badge or pill above a headline. The reel's mono captions are inside the object.
- Never box plus shadow. The reel's shadow is gone: tiles and reel are flat fills.
- One icon set (one arrow); no icon in a rounded box
- Differs from neighbours: a film reel hero (/customers has a case plate, /support a search pill)
Done here: deck.css (h1 clamp(52px, 7vw, 84px) at 1.02; headings 497), container 1152, sections clamp(72px, 11vw, 188px), buttons 48px. One black room.
8. UI component library
- Every control has hover, press (.97), focus-visible, disabled (n/a) and loading (n/a)
- Focus ring: 2px ink with a white halo; white with a black halo in the black room
- n/a: dialogs. There are none.
- n/a: inputs. There are none. Every hover sits in
@media (hover: hover). - Forks deleted: listed above
Done here: the reel's pause control is a 44px button named "Pause" or "Play". The group pill measures 437×99 when Industries is chosen.
9. Motion and interaction
- One signature, 3 supporting, 0 fade-ups
- At least 3 kinds: arrival, idle (reel), pointer (film and jobs), state (pill, re-flow, tile open). Nothing is scroll-linked.
- Something moves without input; every control answers
- Reduced motion shows the final state (the reel doesn't walk, no film plays); no
setInterval - n/a: sound. The kit hasn't merged.
Done here:
- 7 Nov 22:30: the first nine tiles use all nine films and the order repeats nine tiles later (never in a row or the next); a tile's open grows under the header and lands straight on the destination's film band (about 0.6 s, no black hold), the name rides above the cover and never clips, and the page opens on the film you clicked; the reserved room takes the film seen longest ago; the hero-to-filters gap is one section step (124px).
- Signature: the film wall. The pill and the re-flow both run at 300 ms ease-emphasis, with no springs.
- Supporting: line-mask h1; the reel walks once (3.8 s per solution) and rests; tile film and jobs.
10. Media
ImgandFilm(kit) only; sizes set, posters from the.webp- At most 2 videos playing (hero plus hovered tile, checked); pause button on the reel
- Alt: films are decorative (
aria-hidden); every tile carries its name in text - No dimmed photo; gradient under text only. 4+ real Hanzo films together on the wall.
Done here: the model films are local in /public/models, so they show in the gallery.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320 (scrollWidth 320)
- Every target 44px or more; tap opens the tile, the arrow always shows on touch
- Primary ask above the fold at 375×667. Its bottom is at y≈482.
Done here: on phones the tiles stack at 320px each, and the reel shows each solution's jobs (no pointer needed).
12. Accessibility (WCAG 2.2 AA)
- Contrast: #525252 on white is 7.8:1; white 78% on film over a gradient
- Pause control on the reel
- n/a: forms
- One h1; the group words are h2 buttons
- Keyboard reaches every control; focus shows a tile's jobs
Done here: reel panes that aren't showing are aria-hidden and out of the tab order.
13. Performance and engineering
- h1 and LCP poster in server HTML (reel poster
priority) - Images and videos sized; a tile's film mounts only under the pointer
- No poller (the open waits on one rAF loop of at most 3 s); no third party
- Filmed in the cloud
Done here: transform, opacity and clip only. The reel timer runs only after arrival and only while the reel is in view.
14. SEO and machine files
- Title and description from
content/pages.json - Canonical from the layout (shared owner)
<JsonLd route="/solutions">- Every card is a real link
Done here: every tile and every reel pane is in the server HTML.
15. Catalogue and product pages
- n/a: model card. This is not a model page.
- Every card opens into its page (
openTile.jsinstead of Morph, noted above) - n/a: maker and model pages
- n/a: prices
Done here: all 17 tiles plus the reserved tier link to their pages.
16. Developer experience
- n/a: no code on the page
Done here: n/a. There is no code, terminal or config.
17. States and resilience
- Loading: posters render first, films load near the screen. Empty: n/a, every group has items. Error: a missing film leaves the poster or the dark tile.
- Blocked live data leaves a complete page (no live data)
- n/a: no submit
- A thrown island does not blank the page
Done here: Playwright run with no console errors.
18. Measurement and handover
data-ctaon every primary.lib/track.jsis pending.- Nothing identifier-bearing
V2: 8/10 …in the page file header- Review read: no
docs/build-notes/review/solutions.mdyet. This page is ready for its critic.
Done here: filter 17 → 7 → 17, the pill shows, numbers "01 / 07", the open lands on /solutions/finance, no console errors.