mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
384 lines
24 KiB
HTML
384 lines
24 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-website</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-website.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-website">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-website.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-website</h1><p class="lede">The Hanzo AI corporate website at hanzo.ai.</p><h1>Hanzo Website - Corporate Marketing Site (hanzo.ai)</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-cloud.md</code>, <code>hanzo/hanzo-platform.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>The Hanzo AI corporate website at <strong>hanzo.ai</strong>. A Next.js 16 App Router site with static export (<code>output: 'export'</code>), React 19, Tailwind CSS 4, Framer Motion animations, and shadcn/ui components. Dark theme by default with monochrome brand palette. Over 60 marketing pages covering every Hanzo product (AI, Cloud, Chat, MCP, Commerce, Platform, Zen models, etc.). Uses <code>@hanzo/ui</code> and <code>@hanzo/logo</code> packages. Deployed as a static site.</p>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Framework</strong>: Next.js 16.1.6 (App Router, static export)</li><li><strong>React</strong>: 19.0.0</li><li><strong>Styling</strong>: Tailwind CSS 4.2.1 + CSS variables + golden ratio design system</li><li><strong>Animations</strong>: Framer Motion 12.4.2</li><li><strong>UI Library</strong>: shadcn/ui (v4) + Radix UI primitives</li><li><strong>Charts</strong>: Recharts 2.12.7</li><li><strong>3D</strong>: Three.js 0.134</li><li><strong>Forms</strong>: React Hook Form + Zod validation</li><li><strong>Flow diagrams</strong>: @xyflow/react 12.4.4</li><li><strong>Testing</strong>: Playwright (e2e)</li><li><strong>Font</strong>: Zen + Zen Mono (via @hanzo/font)</li><li><strong>Analytics</strong>: Hanzo Insights (<code>insights.hanzo.ai</code>)</li><li><strong>Package manager</strong>: npm (has both package-lock.json and pnpm-lock.yaml)</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>github.com/hanzoai/hanzo.ai</code> (branch: <code>main</code>).</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Making changes to the hanzo.ai marketing site</li><li>Adding new product landing pages</li><li>Updating branding, copy, or design system</li><li>Working with the Hanzo component library patterns</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>Node.js 20+</strong> (<code>.nvmrc</code>)</li><li><strong>npm</strong> or <strong>pnpm</strong> for package management</li><li>Static export -- no server-side features (no API routes, no SSR, no ISR)</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | URL | <code>https://hanzo.ai</code> | | Framework | Next.js 16 (App Router, static export) | | React | 19.0.0 | | Tailwind | 4.2.1 | | Package name | <code>@hanzo/site</code> (private) | | Node | v20+ | | Dev server | <code>npm run dev</code> | | Build | <code>npm run build</code> (static export to <code>out/</code>) | | Tests | <code>npm test</code> (Playwright) | | Default theme | Dark | | Brand palette | Monochrome (<code>--brand: #e4e4e7</code>) | | Repo | <code>github.com/hanzoai/hanzo.ai</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Local development</h3>
|
|
<pre><code class="lang-bash">git clone https://github.com/hanzoai/hanzo.ai.git
|
|
cd hanzo.ai
|
|
npm install
|
|
npm run dev
|
|
# Open http://localhost:3000</code></pre>
|
|
<h3>Add a new product page</h3>
|
|
<pre><code class="lang-bash"># 1. Create the route directory
|
|
mkdir -p app/\(marketing\)/my-product
|
|
|
|
# 2. Create the page
|
|
cat > app/\(marketing\)/my-product/page.tsx << 'EOF'
|
|
import { MyProductHero } from '@/components/my-product/Hero'
|
|
import { MyProductFeatures } from '@/components/my-product/Features'
|
|
|
|
export default function MyProductPage() {
|
|
return (
|
|
<>
|
|
<MyProductHero />
|
|
<MyProductFeatures />
|
|
</>
|
|
)
|
|
}
|
|
EOF
|
|
|
|
# 3. Create the component directory
|
|
mkdir -p components/my-product
|
|
# Add Hero.tsx, Features.tsx following existing patterns</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code>┌─────────────────────────────────────────────────────────┐
|
|
│ Next.js 16 App Router (Static Export) │
|
|
│ │
|
|
│ app/ │
|
|
│ layout.tsx Root layout (Zen font, theme) │
|
|
│ (marketing)/ │
|
|
│ layout.tsx Marketing layout (Navbar+Footer) │
|
|
│ page.tsx Homepage │
|
|
│ ai/page.tsx /ai │
|
|
│ cloud/page.tsx /cloud │
|
|
│ chat/page.tsx /chat │
|
|
│ zen/page.tsx /zen │
|
|
│ pricing/page.tsx /pricing │
|
|
│ ... 60+ pages │
|
|
│ │
|
|
│ components/ │
|
|
│ Hero.tsx, Navbar.tsx, Footer.tsx, Features.tsx (shared) │
|
|
│ ui/ shadcn/ui components │
|
|
│ ai/ AI product components │
|
|
│ cloud/ Cloud product components │
|
|
│ zen/ Zen models components │
|
|
│ ... 40+ component directories │
|
|
│ │
|
|
│ data/ Static data (JSON, TS) │
|
|
│ contexts/ React contexts │
|
|
│ hooks/ Custom hooks │
|
|
│ lib/ Utility functions │
|
|
└─────────────────────────────────────────────────────────┘</code></pre>
|
|
<h3>Design System</h3>
|
|
<p>The site uses a golden-ratio-based design system:</p>
|
|
<ul><li><strong>Font scale</strong>: Golden ratio (1.618x) progression: xs (0.75rem) through 6xl (11.089rem)</li><li><strong>Spacing</strong>: <code>golden-1</code> (0.25rem) through <code>golden-9</code> (11.749rem)</li><li><strong>Grid</strong>: <code>golden</code> template: 38.2% / 61.8% split</li><li><strong>Brand colors</strong>: Monochrome -- primary white, secondary neutral-300, hover neutral-400</li><li><strong>CSS variables</strong>: <code>--brand: #e4e4e7</code>, <code>--brand-muted: #a3a3a3</code></li><li><strong>Dark mode</strong>: Default, enforced via <code>darkMode: "class"</code> + ThemeProvider</li></ul>
|
|
<h3>Typography</h3>
|
|
<p>| Level | Classes | |-------|---------| | h1 | <code>text-5xl md:text-6xl lg:text-7xl font-bold tracking-tight</code> | | h2 | <code>text-3xl md:text-5xl font-bold</code> | | h3 | <code>text-2xl font-bold</code> | | Body large | <code>text-xl text-neutral-300</code> | | Body default | <code>text-lg text-neutral-400</code> | | Caption | <code>text-sm text-neutral-500</code> |</p>
|
|
<h3>Key Hanzo Packages</h3>
|
|
<p>| Package | Purpose | |---------|---------| | <code>@hanzo/ui</code> ^5.3.34 | Shared UI component library | | <code>@hanzo/logo</code> ^1.0.5 | Hanzo logo SVG components | | <code>@zenlm/models</code> ^1.0.2 | Zen model metadata and specs |</p>
|
|
<h3>Route Groups</h3>
|
|
<p>All marketing pages live under <code>app/(marketing)/</code> which applies the shared marketing layout (Navbar + Footer). Major product routes:</p>
|
|
<ul><li><code>/ai</code> - AI platform</li><li><code>/cloud</code> - Cloud infrastructure</li><li><code>/chat</code> - Hanzo Chat</li><li><code>/zen</code> - Zen LLM models</li><li><code>/mcp</code> - Model Context Protocol</li><li><code>/platform</code> - PaaS platform</li><li><code>/commerce</code> - Commerce/payments</li><li><code>/bot</code> - Hanzo Bot</li><li><code>/extension</code> - Browser/IDE extension</li><li><code>/pricing</code> - Pricing page</li><li><code>/about</code>, <code>/team</code>, <code>/careers</code>, <code>/contact</code> - Company pages</li><li><code>/sql</code>, <code>/kv</code>, <code>/vector</code>, <code>/datastore</code>, <code>/storage</code> - Database products</li><li><code>/auth</code>, <code>/identity</code>, <code>/kms</code> - Security products</li><li><code>/flow</code>, <code>/functions</code>, <code>/edge</code>, <code>/realtime</code>, <code>/pubsub</code> - Infrastructure</li></ul>
|
|
<h3>Environment Variables</h3>
|
|
<pre><code class="lang-bash"># IAM OAuth2 (from .env.example)
|
|
VITE_IAM_ENDPOINT=https://id.hanzo.ai
|
|
VITE_IAM_CLIENT_ID=your-client-id
|
|
VITE_IAM_REDIRECT_URI=http://localhost:8084/auth/callback
|
|
|
|
# Commerce API
|
|
VITE_HANZO_API_URL=https://api.hanzo.ai
|
|
|
|
# Payments
|
|
VITE_SQUARE_APPLICATION_ID=sandbox-sq0idb-xxx
|
|
VITE_SQUARE_LOCATION_ID=your-location-id
|
|
|
|
# Crypto
|
|
VITE_CRYPTO_DEPOSIT_ADDRESS=0x...
|
|
VITE_WALLETCONNECT_PROJECT_ID=your-project-id</code></pre>
|
|
<p><strong>Note</strong>: The <code>.env.example</code> uses <code>VITE_</code> prefixes (from the earlier Vite-based version). The current Next.js build uses <code>NEXT_PUBLIC_</code> prefix convention, but the env file has not been updated.</p>
|
|
<h3>Analytics</h3>
|
|
<p>Hanzo Insights is embedded in the root layout via a script tag:</p>
|
|
<ul><li>Endpoint: <code>insights.hanzo.ai</code></li><li>Project key: <code>hi_e16a2d5a8033442d87f090b24c606825</code></li><li>Registers: <code>app: 'hanzo-ai'</code>, <code>org: 'hanzo'</code></li></ul>
|
|
<h2>Directory structure</h2>
|
|
<pre><code>hanzo.ai/
|
|
package.json # @hanzo/site v0.0.1 (private)
|
|
next.config.ts # Static export, unoptimized images
|
|
tailwind.config.ts # Golden ratio design system
|
|
tsconfig.json # TypeScript config
|
|
postcss.config.js # PostCSS with Tailwind
|
|
components.json # shadcn/ui config
|
|
eslint.config.js # ESLint config
|
|
playwright.config.ts # E2E test config
|
|
.nvmrc # Node v20
|
|
.env.example # Environment variables template
|
|
LLM.md # Agent documentation
|
|
CLAUDE.md # Agent instructions
|
|
app/
|
|
layout.tsx # Root layout (fonts, theme, analytics)
|
|
globals.css # Global styles + CSS variables
|
|
icon.svg # Favicon
|
|
not-found.tsx # 404 page
|
|
(marketing)/
|
|
layout.tsx # Marketing layout (Navbar + Footer)
|
|
page.tsx # Homepage
|
|
about/ # About page
|
|
ai/ # AI product
|
|
cloud/ # Cloud product
|
|
chat/ # Chat product
|
|
zen/ # Zen models
|
|
mcp/ # MCP tools
|
|
pricing/ # Pricing
|
|
... (60+ routes)
|
|
components/
|
|
Hero.tsx # Homepage hero
|
|
Navbar.tsx # Site navigation
|
|
Footer.tsx # Site footer
|
|
Features.tsx # Feature grid
|
|
Products.tsx # Product cards
|
|
CommandPalette.tsx # Command palette (Cmd+K)
|
|
GlobalChatWidget.tsx # Embedded chat widget
|
|
ui/ # shadcn/ui components
|
|
shadcn-v4/ # shadcn v4 components
|
|
shared/ # Shared components
|
|
navigation/ # Nav components
|
|
animations/ # Animation components
|
|
ai/ # AI section components
|
|
cloud/ # Cloud section components
|
|
zen/ # Zen section components
|
|
... (40+ directories)
|
|
data/ # Static data files
|
|
contexts/ # React context providers
|
|
hooks/ # Custom React hooks
|
|
lib/ # Utility functions
|
|
public/ # Static assets
|
|
scripts/ # Build/utility scripts
|
|
e2e/ # Playwright e2e tests
|
|
test-results/ # Test output
|
|
.github/
|
|
workflows/ # GitHub Actions CI</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Build warnings (ESLint/TS) | <code>ignoreDuringBuilds: true</code> in next.config | Warnings suppressed intentionally for static export | | Images not loading | <code>unoptimized: true</code> in config | Expected for static export -- use standard <code><img></code> or next/image with unoptimized | | VITE_ env vars | Legacy from Vite era | Use <code>NEXT_PUBLIC_</code> prefix for Next.js client-side vars | | Merge conflict in README | Unresolved <code><<<<<<<</code> markers present | README has an active merge conflict on main branch | | pnpm vs npm | Both lock files present | Use npm (package-lock.json is more recent) | | Dark mode flash | ThemeProvider not wrapping content | Ensure ThemeProvider is in root layout with <code>suppressHydrationWarning</code> on html |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-cloud.md</code> - Cloud dashboard (cloud.hanzo.ai)</li><li><code>hanzo/hanzo-platform.md</code> - PaaS platform (platform.hanzo.ai)</li><li><code>hanzo/hanzo-chat.md</code> - Chat product (chat.hanzo.ai)</li><li><code>hanzo/hanzo-commerce.md</code> - Commerce frontend</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: website, marketing, next.js, tailwind, react, landing-pages <strong>Prerequisites</strong>: Node.js 20+, npm</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-website.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |