hanzo-inc/app wrote both in scripts/skill.mjs after its export; the site has no equivalent since hanzo.ai moved here, so both answer 404. Port it: the public/skill.md frame plus a Families section read from api.hanzo.ai's OpenAPI document, the same file as an Agent Skill, and its v0.2.0 index. Part of hanzo-inc/app#85.
12 KiB
hanzoai/site — hanzo.ai, the signed-out site
Every signed-out page of hanzo.ai: research, models, open source, products, pricing, company. Open source (Apache-2.0); anyone may send a pull request. The app — chat, sign-in, sign-up, checkout and every room — is hanzo-inc/app on hanzo.app, and this site links there for all of it.
- Stack: Next.js 16 static export (
output: 'export'; URLs have no trailing slash, as on hanzo.ai:/pricingisout/pricing.html, canonical, og:url and the sitemap sayhttps://hanzo.ai/pricing), React 19, Motion 12, JSX. Light/dark from@hanzo/appearance+@hanzo/designtokens (docs/DARK-MODE.md). - Node 22.18+, pnpm via corepack (
packageManager).pnpm dev(:4180),pnpm build(out/),pnpm preview(:4181),pnpm test(node --test). pnpm buildrunsscripts/live.mjsfirst: figures and plan prices from api.hanzo.ai intocontent/live/_*.json; any failed source stops the build.HZ_LIVE_OFFLINE=1builds from the snapshots.- The open-source figures (home band,
/open-source) arelib/oss.mjs, a port of hanzo-inc/appscripts/sync-oss.ts: the estate fromGET /v1/git/activityevery build, and GitHub's half (stars, forks, languages, contributors, cards) intocontent/live/_github.jsonwhenGITHUB_TOKENis set (CI passes the runner'sGIT_TOKEN), else kept; a push reuses the cards' contributors and the orgs' descriptions.GITHUB_TOKEN=$(gh auth token) node scripts/live.mjsrefreshes it by hand. A repository public on GitHub but not on the forge (hanzoai/ai, hanzoai/cloud) keeps the year it last had, as the app does.live.mjswritescomponents/pages/openSource/snapshot.jsthroughshape.mjs. The home band draws that snapshot (components/Open.jsx). A day's shade islib/heat.mjs, the quartiles of the days that had commits, one function for the home and /open-source (an outlier or a quiet quarter cannot crush the rest); the tiles' and cards' bars arecomponents/home/spark.js, @hanzo/ui's Sparkline; the year's bars are weeks counted back from the last day. Every cell and bar is--x-heat(ink; white in dark) over--x-cell(the empty cell) inapp/globals.css.
Where things are
| What | Where |
|---|---|
| A route | app/<path>/page.jsx; families under [slug] |
| A page's code | components/pages/<Page>.jsx (+ .css), home sections in components/home/ |
| Shared parts | components/kit.jsx, components/ui.jsx, components/Chrome.jsx (header, footer) |
| Every route | lib/routes.json; lib/route.js href() keeps a path this site has, sends any other to hanzo.app |
| The app's origin | lib/app.js (APP = https://hanzo.app) |
| Plan prices, checkout links | lib/plans.js, from content/live/_pricing.json (GET /v1/billing/plans); nothing typed |
| Pages still drawn from captured HTML | components/Ported over content/pages/*.html |
Go modules (go get hanzo.ai/<module>) |
lib/modules.js: OWNED modules have a page of their own (app/[...mod], components/pages/Module.jsx), SHARED ones are product pages whose metadata carries other: goImport(name). scripts/modules.json is hanzo-inc/app's list (name to repository); scripts/modules.test.mjs checks every tag in out/ and runs after pnpm build (postbuild) |
| Pages hanzo.ai serves without listing | lib/unlisted.json: in routes.json (links stay in the site), left out of the sitemap |
| The home hero's demo | components/Hero.jsx (the loop), components/home/Devices.jsx + demo.css (the devices), hero-scenes.json (the day it plays) |
| Telemetry | components/Telemetry.jsx (the one client, pageviews, observe, tags); lib/track.js: track (stream + browser tags) and capture (stream only) |
| The app's page events | named as hanzo-inc/app names them, same param keys: lib/funnel.js (the plan funnel), lib/press.js (links), data-hz-view bands for $view; asserted in a browser by scripts/events.mjs (pnpm build, then pnpm events) |
Rules
- No price is typed: plans come from
/v1/billing/plans, model rates from/v1/pricing/models. Personal plans are monthly only; a year is offered only where the catalog sells one (Team, Team Premium, Enterprise). - A short address of a page (
/privacy,/terms,/aup,/cookies,/data-deletion,/bot/details) renders the same page as its target and its canonical points there: one document, never a second copy (components/pages/LegalRoute.jsx). - Every form sends what hanzo-inc/app sends, to api.hanzo.ai: the same URL, body and refusal sentence, and a thanks only
once Hanzo took the answers. A form that keeps its answers in the browser alone is a fake. The bodies are built in
*.send.js/*.apply.jsbeside the page, each with a node test, and checked end to end in a browser with the API intercepted (route + fulfill), never against production. - No sign-in, sign-up, card or code is collected here. Those are hanzo.app's.
- Copy is Hanzo's: change wording only on purpose.
- The hero demo draws each device as its product draws itself, in the product's own words: the desktop is @hanzo/app's
window (rail: Chat, Dev, Design, Studio, Tabs, Library, Scheduled tasks, Customize, More; the lit place's sidebar),
the terminal is
hanzo dev(▶,• Explored,• Added,• Edited,• Ran,└; tabs install, up and dev only), the phone is hanzo.app on a phone, @hanzo/app's mobile layout, which is what people use: the bar's two round glass buttons (menu, New chat), the conversation with the five marks under an answer, the composer pinned above the home indicator ("Type / for skills", +, mic, voice mode, Auto), and "What's up?" when the chat is empty. It has no tab bar. hanzo/mobile is the native app: use it only where it agrees with hanzo.app. Add nothing a product does not have: no roster, no notifications, no pause button. - The logo strips (
Marquee,components/Chrome.jsx) are CSS: a transform loop on.x-mq-track, paused under the pointer, on focus and off screen, none under reduced motion, no pause button. AC.backeditem carriesw,handhang(px): the wordmark's size and how far it falls below its text (a smile, a descender, a mark), so.x-logo[data-base]sits every one on a single baseline. Measure a new logo, never eyeball it; crop a padded asset's viewBox to its ink in a file of its own (techstars-mark.svg): the CDN keeps a changed file under its old name for a day. - An agent icon in
C.agentshas noidin its markup: the same string is drawn in the dock, the setup row and every menu row, and the first copy lives in a closed menu where nothing renders, so a<mask>or gradient by id goes blank (Grok Build did). Flat marks are inline paths; a gradient mark is a file (public/<name>-mark.svg). Colour is the brand's own (Claude orange, DeepSeek blue, Amp red, Codex, Antigravity, Gemini, Muse, OpenHands); the rest are in ink. A tile's tooltip (data-name) and its accessible name are the same words. - The Pareto plot's points wear their lab's mark (
lab()incomponents/lab.js) at hanzo-inc/app's sizes in CSS px (DISCincomponents/Pareto.jsx, read off the drawing as it is shown, so a disc is the same at every width). A lab with a dock tile wears that tile's drawing, so a brand has one mark on the page; Enso's tiers wear Hanzo's H on ink; Z.ai, with no tile, wears hanzoai/icons' mark; any other lab wears none. A new lab is a dock tile and a pattern inOF;components/lab.test.mjsholds it. - The home's "Hanzo MCP" picker (
components/McpPicker.jsx, in#compatible) drawslib/mcp.js, which holds what each client takes as that client's own docs say: the file or command for the hosted endpoint with a key (Authorization: Bearer sk-..., serverhanzo-cloud) and for the local server (npx -y hanzo mcp, serverhanzo, which useshanzo login). Every way names, infromand a comment above it, the doc page it was checked against; a client whose docs give no file or command for a way has none and says why innone; a client with no way available is not listed (ChatGPT, whose connector takes OAuth only). "Sign in with Hanzo" is written (signin) and OFF:SIGN_INinlib/mcp.jsis the one flag, andscripts/mcp.test.mjsholds the file to its shape with the flag either way. Flip it only when OAuth is live, then write the sign-in tab on docs.hanzo.ai (hanzo-docs/docsguides/coding, whose LLM.md "MCP clients" says the same words and where each anchor is). Re-check a snippet against itsfrompage before editing it: these clients change their config keys (Gemini CLI'shttpUrlis deprecated forurl+type, Windsurf's file moved to~/.config/devin/). The picker's chips use the dock's icons by name (icon), so a client has one mark everywhere; the marks for VS Code, OpenClaw and NanoClaw are files (public/*-mark.*, new names for the CDN's day-long cache), Claude's, Windsurf's and Warp's are inline paths. The "+N" on the setup prompt isSETUP.lengthless the six icons shown. - A card has a clean surface (no stripes, scan lines or dot grids) and one effect, the app's own: it leans toward a mouse
and a glossy light follows it, and on a phone the device's tilt does the same; at rest nothing moves and no animation
runs, and reduced motion has neither. Mark it
data-tilt=""and write nothing else:lib/tilt.js(started once, inSmooth) is the one listener, writing--rx --ry --lx --ly --liton the card; the lean is hanzo.css's[data-tilt]and the light is[data-tilt]::afterinapp/globals.css, a fixed layer moved by transform. The lean is atransform, so the card must be a plain element (Motion rewrites a motion element's transform): the plan cards and the platform window's frame are Motion's, and take the light (the window's face leans). Hover and press on such a card usetranslateandscale. The four headline figures of the speed and price cards share--figure(.x-races). - Scroll-linked effects are CSS (
animation-timeline: view()orscroll()), never a scroll listener oruseScroll; animatetransformandopacity, notbackground-positionorclip-path, which repaint every frame. The home sections carry no rule above their headings and no hairline between rooms. - Controls are at least 44 x 44 on a touch screen (
@media (pointer: coarse)inapp/globals.css): a pill, tab or link that must stay small borrows the space with an invisible::after. - A press on a link to a page of this site is taken over by
components/Morph.jsxat the top of the capture phase and stopped: anonClickon the link never runs. A moment that belongs to such a link is read withpress()(lib/press.js); a button or an outside link can useonClick. A link markeddata-gasends its own moment, so the funnel's link moment (checkout_started,sales_contacted) leaves it alone. - An event hanzo-inc/app fires on a page that stays in the app (sign-in, onboarding, pay, the member dashboards) is
not fired here. Not fired for want of an element:
hero_democontrols the redesign dropped (sidebar places, send, preview, composer, replay chips, agent toggles),chat_started(no composer),page_copied_markdown(no Help corner),newsletter_confirmed(no/newsletter/confirm),video_shown/video_rated(no video on/beta),beta_closed,beta_feedback_sent.
Ship
.github/workflows/cicd.yml calls hanzoai/ci build.yml with hanzo.yml: every push and pull request runs the test
(install, pnpm test, pnpm build); a push to main publishes out/ to the Sites plane slug hanzoai-site
(prefix hanzo/hanzoai-site, KMS org hanzo) with the agent files (agent: hanzo.ai: Markdown twins, llms.txt,
robots.txt, sitemap.xml, the API catalog). universe infra/sites/sites.yaml serves hanzo.ai from that prefix.
pnpm build ends with scripts/skill.mjs, which writes /skill.md (the public/skill.md frame plus a ## Families
section read from api.hanzo.ai/v1/openapi.json, categories kept in content/live/_families.json) and the same file as
/.well-known/agent-skills/hanzo-cloud-api/SKILL.md with the Agent Skills index beside it. It stops the build when the
document does not answer; HZ_LIVE_OFFLINE=1 builds from the snapshot.