Files
skills/public/hanzo-computer.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
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]>
2026-09-11 00:27:59 -07:00

324 lines
19 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-computer</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-computer.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-computer">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-computer.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-computer</h1><p class="lede">Hanzo Computer (hanzoai/computer) is an ecommerce web application for purchasing AI compute hardware.</p><h1>Hanzo Computer - AI Hardware Marketplace</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-commerce.md</code>, <code>hanzo/hanzo-billing.md</code></p>
<h2>Overview</h2>
<p>Hanzo Computer (<code>hanzoai/computer</code>) is an <strong>ecommerce web application for purchasing AI compute hardware</strong>. It sells the DGX Spark instance ($4,000) as the only credit-card purchasable product, with GPU On-Demand and Enterprise tiers requiring sales consultation. The storefront includes a shopping cart, checkout flow (via Hanzo Billing), order management, and an account dashboard.</p>
<h3>What it actually is</h3>
<ul><li>A React 19 + TypeScript + Vite single-page application</li><li>Deployed to GitHub Pages (and optionally Vercel for serverless API routes)</li><li>No backend database in production -- cart and orders stored in LocalStorage (demo mode)</li><li>Supabase schema exists for future production use (orders, customers, products, analytics)</li><li>Vercel serverless API functions in <code>api/</code> for email, invoices, and rate limiting</li><li>Payments redirect to Hanzo Billing (billing.hanzo.ai) -- no PCI data handled in-app</li><li>Auth via Hanzo IAM (hanzo.id) with client ID <code>app-computer</code></li></ul>
<h3>What it is NOT</h3>
<ul><li>Not a &quot;computer use&quot; agent or desktop automation tool (that is <code>hanzoai/operative</code>)</li><li>Not a general-purpose ecommerce platform</li><li>No backend order processing in the current deployment</li></ul>
<h2>When to use</h2>
<ul><li>Building or modifying the hanzo.computer storefront</li><li>Adding new hardware products to the catalog</li><li>Integrating Hanzo Billing payment flows</li><li>Implementing the production backend (orders, auth, emails)</li></ul>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Repo | <code>github.com/hanzoai/computer</code> | | Package | <code>hanzo-computer</code> (private) | | Version | 0.0.0 | | Branch | <code>main</code> | | Language | TypeScript | | Framework | React 19 + Vite 6 | | Styling | Tailwind CSS v4 | | Routing | React Router v7 | | Payments | Hanzo Billing (billing.hanzo.ai) | | Auth | Hanzo IAM (hanzo.id), client <code>app-computer</code> | | Dev | <code>npm run dev</code> (port 5173) | | Build | <code>npm run build</code> | | Test | <code>npm run test</code> (Playwright) | | Deploy | GitHub Pages (auto on push to main) | | API | Vercel serverless functions in <code>api/</code> | | License | Proprietary (Hanzo AI Inc.) |</p>
<h2>Project structure</h2>
<pre><code>hanzoai/computer/
package.json # hanzo-computer, React 19, Vite 6
App.tsx # Main app with React Router
index.html # SPA entry point
index.tsx # React DOM render
vite.config.ts # Vite config
vercel.json # Vercel serverless function config
tailwind.config.js # Tailwind CSS v4
.env.example # IAM, Commerce API, Upstash Redis config
api/
_middleware.ts # Rate limiting middleware (Upstash Redis)
generate-invoice.ts # PDF invoice generation
send-email.ts # Generic email sending
send-order-confirmation.ts
send-quote-email.ts
send-rfq-confirmation.ts
send-subscription-confirmation.ts
send-cluster-notification.ts
admin/ # Admin API endpoints
components/
Header.tsx # Navigation with cart icon + search
Hero.tsx # Landing page hero section
Pricing.tsx # Product cards (DGX Spark, GPU, Enterprise)
CloudPricing.tsx # Cloud compute pricing
DGXSparkHighlight.tsx # Featured product section
Features.tsx # Feature highlights
HardwareSpec.tsx # Hardware specifications table
WhyBuyHardware.tsx # Marketing content
UseCases.tsx # Use case showcases
IndustrySolutions.tsx # Industry vertical solutions
FAQ.tsx # Frequently asked questions
SearchModal.tsx # Product search
Testimonials.tsx # Customer testimonials
TrustSecurity.tsx # Security badges and info
Partners.tsx # Partner logos
ImageGallery.tsx # Product images
CallToAction.tsx # CTA section
Footer.tsx # Site footer
src/
context/
CartContext.tsx # Shopping cart state (React Context)
pages/
Cart.tsx # Cart page with quantity controls
Checkout.tsx # Checkout → Hanzo Billing redirect
Account.tsx # Order history dashboard
components/ # Additional UI components
lib/ # Utility libraries
supabase/
schema.sql # Production DB schema (orders, customers, products)
schema_analytics.sql # Analytics tables
storage-buckets.sql # File storage config
migrations/ # DB migrations
e2e/ # Playwright end-to-end tests
tests/ # Test suite
docs/ # Documentation
public/ # Static assets</code></pre>
<h2>Dependencies</h2>
<p>From <code>package.json</code>:</p>
<ul><li><code>react</code> ^19.2.0, <code>react-dom</code> ^19.2.0</li><li><code>react-router-dom</code> ^7.9.5</li><li><code>lucide-react</code> ^0.552.0, <code>@heroicons/react</code> ^2.2.0 -- icons</li><li><code>recharts</code> ^3.3.0 -- dashboard charts</li><li><code>@react-pdf/renderer</code> ^4.3.1 -- invoice PDF generation</li><li><code>@upstash/ratelimit</code> ^2.0.6, <code>@upstash/redis</code> ^1.35.6 -- API rate limiting</li><li><code>date-fns</code> ^4.1.0 -- date formatting</li><li><code>express-rate-limit</code> ^8.2.1 -- fallback rate limiting</li></ul>
<p>Dev: Vite 6, TypeScript 5.8, Tailwind CSS v4, Playwright, Jest</p>
<h2>Quickstart</h2>
<pre><code class="lang-bash">git clone https://github.com/hanzoai/computer.git
cd computer
cp .env.example .env
# Edit .env with IAM and billing config
npm install
npm run dev
# Open http://localhost:5173</code></pre>
<h2>Environment variables</h2>
<pre><code class="lang-bash"># Hanzo IAM
VITE_IAM_URL=https://hanzo.id
VITE_IAM_CLIENT_ID=app-computer
# Commerce API
VITE_COMMERCE_API_URL=https://billing.hanzo.ai
# Site
VITE_SITE_URL=https://hanzo.computer
# Upstash Redis (API rate limiting)
UPSTASH_REDIS_REST_URL=https://your-redis.upstash.io
UPSTASH_REDIS_REST_TOKEN=your-token
# Admin
ADMIN_API_KEY=your-admin-key</code></pre>
<h2>Shopping flow</h2>
<ol><li>Browse products on homepage (DGX Spark, GPU On-Demand, Enterprise)</li><li>Add DGX Spark to cart (only credit-card purchasable item)</li><li>Cart page with quantity controls and total</li><li>Checkout collects billing details, redirects to Hanzo Billing portal</li><li>Order confirmation on Account page</li><li>Instance provisioned in 24-48 hours</li></ol>
<h2>Troubleshooting</h2>
<ul><li><strong>Cart not persisting</strong>: Data stored in LocalStorage, cleared on browser data wipe</li><li><strong>Checkout redirect fails</strong>: Verify <code>VITE_COMMERCE_API_URL</code> points to billing.hanzo.ai</li><li><strong>API rate limiting errors</strong>: Configure Upstash Redis env vars</li><li><strong>E2E tests fail</strong>: Ensure Playwright browsers installed (<code>npx playwright install</code>)</li></ul>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-billing.md</code> -- Payment processing backend</li><li><code>hanzo/hanzo-commerce.md</code> -- Commerce API</li><li><code>hanzo/hanzo-iam.md</code> -- Authentication (hanzo.id)</li><li><code>hanzo/hanzo-ui.md</code> -- Shared UI components</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: ecommerce, hardware, gpu, dgx, marketplace, billing <strong>Prerequisites</strong>: Node.js 18+, 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-computer.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>