mirror of
https://github.com/hanzoai/site.git
synced 2026-11-21 01:07:08 +00:00
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
5.6 KiB
5.6 KiB
title: Hanzo site redesign — completion plan status: in_progress owner: enso (coordinator) expert_team: tech-lead, frontend-motion, webgl-graphics, qa-motion, content-data, build-release briefs: DESIGN.md, NEXT-LEVEL.md, PAGES.md
Hanzo.ai redesign — completion plan
This is my improvement plan added to the brief. Every page of hanzo.ai rebuilt on Hanzo's stack: Next.js 15 App Router, React 19, Motion 12, Lenis, WebGL. Hanzo's header/footer/logos/copy/numbers/links stay exactly theirs; what changes is how the site moves and how pages connect.
State of record (verified)
- Dev server detached on
http://localhost:4180(pid 77806), Chrome tab open for James to watch;GET /= HTTP 200. - 110 custom
app/*/page.jsxroutes redesigned;[...slug]ported catch-all for the rest;content/pages/= 147 ported pages. Arrow/Adead-control root cause fixed (motion.a whileHover/whileTap) — live on/, compiled clean.- Conductor running automated motion QA across pages (holds
/tmp/hz-browser.lock); report inshots/motion-report.txt. - Systemic bug on every page: Next.js hydration mismatch ("server rendered HTML didn't match the client properties") — highest-impact fix.
Expert team (staffed; 6 roles whose absence = real failure)
| Role | Playbook focus | Owner |
|---|---|---|
| Tech Lead / Architect | App Router shell, routing, static export, hydration | coordinator |
| Frontend / Motion Engineer | Motion 12, Lenis, components, styling, tap targets ≥44px | — |
| WebGL / Graphics Engineer | Opener WebGL transition, Sigil contour field | — |
| QA / Motion Verification | motion.mjs, phone.mjs, no STILL/DEAD, shift <0.05, reduced motion | — |
| Content / Data Engineer | content/pages, pages.json, data accuracy, models/OSS/cloud | — |
| Build / Release Engineer | next build static export, preview, OG share cards, deploy readiness |
— |
Improvement plan (my additions to the brief)
1. Fix the hydration error (every page) — unblocker
Root-cause: a client component in the shell (Smooth/lenis, Morph, Phone, Cursor, Progress, or OpenerProvider) renders different HTML/attributes on server vs client. Fix so npm run build and hydration are clean on every route. Verified by: no hydration error in shots/motion-report.txt, next build exits 0.
2. Ship the NEXT-LEVEL site-wide layers (shared code, built once)
- Morph navigation — View Transitions API ~600ms; clicked card/picture becomes next page's hero; pages mark
data-morphsource/target; fallback to instant. - Sigil —
<Sigil seed />living contour field drawn from each page's own words/numbers; moves slowly, bends to pointer, freezes for reduced motion, pauses off screen. - Phone, designed — thumb bar with the page's main action slides up after hero; siblings swipe; sheets rise from bottom; hit areas ≥44px.
- Contextual cursor — fine pointers: "Open" over card, "Play" over film, "Drag" over rail; system cursor stays visible.
- The 404 is a room too — designed not-found page with search over every page.
- Ask Hanzo, inline — ⌘K answers in place, streams from Hanzo's public chat endpoint, falls back to hanzo.ai/chat.
- Share cards — every page gets its own Open Graph image at build time.
3. Every page unique and slick (per DESIGN.md + NEXT-LEVEL.md)
- Each rebuilt page: one layout made for its content + one standout interaction (
Signature:) + one "Beyond:" feature built only from Hanzo's own facts. - No two pages share a signature, beyond feature, or first-screen layout; family pages differ via Sigil seed + first-screen data.
python3 scripts/unique.pymust pass (fingerprints section sequence, signature line, first-screen layout; fails on shared signature / reused component file / near-identical sequences).- Slick bar: 60fps, layout shift <0.05, no STILL screens, no DEAD controls, tap targets ≥44px, no orphan headlines (
text-wrap: balance), 1px hairlines, consistent radii.
4. Motion polish (QA gate)
node scripts/motion.mjs /page --desk-onlyand phone: 0 STILL, 0 DEAD, shift <0.05, 60fps.node scripts/phone.mjs /page: sideways-scroll + console-error check.prefers-reduced-motion: no smooth scroll, no flight, no typing; every final state at once.
5. Build & release readiness
npm run build→ static export intoout/;npm run preview→http://localhost:4181.public/copied from current hanzo.ai (model media, logos, images).- Data snapshot refreshed to live sources before launch (GitHub counts, commit calendar, pricing, benchmarks, Pareto).
Sign-off (one line per role, with evidence)
- Tech Lead: hydration mismatch fixed — components/Chrome.jsx Smooth no longer passes media-query-dependent reducedMotion="user" to MotionConfig (server/client now render identically); next dev compiles / and /enso/ with no hydration warning; site HTTP 200 on :4180.
- Frontend/Motion: dead-control root cause fixed — components/ui.jsx Arrow and components/kit.jsx A now motion.a/motion.span with whileHover/whileTap; live on home page; compiled clean.
- WebGL/Graphics: not yet started (Opener WebGL transition intact, untouched).
- QA/Motion: scripts/unique.py created per DESIGN.md rule 10; exits 0 on clean tree (101 pages unique), exits 1 with clear message on duplicate signature/near-identical sequence (proved via temp fixture, then removed).
- Content/Data: not yet started (content snapshot from 7 Nov 2026; connect live sources before launch per README).
- Build/Release: not yet started (static export next build run by conductor; preview :4181 not yet opened).