mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
366 lines
22 KiB
HTML
366 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-static-sites-cd</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-static-sites-cd.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-static-sites-cd">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-static-sites-cd.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-static-sites-cd</h1><p class="lede">This skill provides the unified, authoritative standard for building, configuring, deploying, and managing all static sites and web applications across the Hanzo ecosystem.</p><h1>Hanzo Static Sites, CI/CD & Commerce Deployment Guide</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-deploy.md</code>, <code>hanzo/hanzo-website.md</code>, <code>hanzo/hanzo-static.md</code>, <code>hanzo/hanzo-commerce.md</code>, <code>hanzo/hanzo-iam.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>This skill provides the unified, authoritative standard for building, configuring, deploying, and managing all static sites and web applications across the Hanzo ecosystem. It covers:</p>
|
|
<ol><li><strong>Deterministic Project Configuration</strong> via <code>hanzo.yml</code> (or <code>hanzo.config.toml</code>, <code>~/.hanzo/settings.json</code>, <code>hanzo.config.ts</code>).</li><li><strong>Dual-Workflow CI/CD Synchronization</strong> (<code>.github/workflows</code> and <code>.hanzo/workflows</code> on push to forge <code>git.hanzo.ai</code>).</li><li><strong>Sites Plane & Native Deployment</strong> via <code>bin/site <slug> <dir></code>, Docker container images (<code>ghcr.io/hanzoai/static:0.5.15</code>), and native <code>/v1/projects/sites/deploy</code>.</li><li><strong>Commerce & Checkout Integration</strong>: <strong>STRICT NO-STRIPE POLICY</strong>. All payments must route through Hanzo Commerce (<code>https://api.hanzo.ai/v1/commerce</code> and <code>https://pay.hanzo.ai</code>) backed by Square (Sandbox & Production), Crypto, and Wire.</li></ol>
|
|
<hr>
|
|
<h2>1. Hard Requirements & Principles</h2>
|
|
<ol><li><strong>NO STRIPE</strong>: Stripe is completely prohibited and deprecated across the Hanzo estate. All billing and card processing goes exclusively through Hanzo Commerce (<code>api.hanzo.ai/v1/commerce</code> / <code>pay.hanzo.ai</code>) using Square, Crypto, or Wire.</li><li><strong>Deterministic Configuration</strong>: Every repo defines its site metadata, framework, build target, domains, commerce, and IAM settings in <code>hanzo.yml</code> (or <code>hanzo.config.ts</code> / <code>hanzo.config.toml</code>).</li><li><strong>Dual Workflow Plane</strong>:</li></ol>
|
|
<ul><li><code>git.hanzo.ai</code> (the forge) reads <code>.hanzo/workflows</code> and <code>.github/workflows</code>.</li><li>Public mirrors (GitHub) read <code>.github/workflows</code>.</li><li>Always keep <code>.hanzo/workflows</code> synchronized with <code>.github/workflows</code> (e.g. symlinked via <code>ln -s ../.github/workflows .hanzo/workflows</code>) so pushes to both remotes trigger identical CI/CD.</li></ul>
|
|
<ol><li><strong>Single Identity System</strong>: Authentication and account/order management is powered by Hanzo ID (<code>https://hanzo.id</code>) via OIDC PKCE, and billing is managed at <code>https://billing.hanzo.ai</code>.</li><li><strong>Standard Checkout Contract</strong>: Pricing CTAs must link to:</li></ol>
|
|
<p> ``<code> https://pay.hanzo.ai/?plan=<planId>&return=<returnUrl> </code>``</p>
|
|
<hr>
|
|
<h2>2. Deterministic Configuration Schema (<code>hanzo.yml</code>)</h2>
|
|
<p>Place <code>hanzo.yml</code> in the root of any site or application repo:</p>
|
|
<pre><code class="lang-yaml">name: agency
|
|
slug: agency
|
|
version: 0.1.6
|
|
type: site # site | app | service
|
|
|
|
framework:
|
|
name: vite # vite | next | astro | static | react
|
|
preset: react
|
|
buildCommand: pnpm build
|
|
outputDir: dist # dist | out | build | public
|
|
singlePageApp: true # true for BrowserRouter / SPA routing fallback
|
|
|
|
routing:
|
|
domain: hanzo.agency
|
|
aliases:
|
|
- www.hanzo.agency
|
|
- agency.hanzo.ai
|
|
|
|
deploy:
|
|
plane: sites # sites (S3/SeaweedFS static plane) | k8s (container image)
|
|
publishScript: https://git.hanzo.ai/hanzoai/ci/.github/actions/site@v1
|
|
image: ghcr.io/hanzoai/agency # when built as container
|
|
kubernetes:
|
|
namespace: hanzo
|
|
service: agency
|
|
port: 3000
|
|
|
|
commerce:
|
|
org: hanzo
|
|
checkoutUrl: https://pay.hanzo.ai
|
|
commerceApi: https://api.hanzo.ai/v1/commerce
|
|
providers:
|
|
- square # Square Sandbox/Production Web Payments SDK
|
|
- crypto # BTC, ETH, USDC
|
|
- wire # Bank wire (ACH / SWIFT)
|
|
disallowed:
|
|
- stripe # STRICT RULE: No Stripe
|
|
|
|
iam:
|
|
issuer: https://hanzo.id
|
|
clientId: hanzo-agency
|
|
billingPortal: https://billing.hanzo.ai
|
|
|
|
calendar:
|
|
bookingUrl: https://calendar.app.google/z1YsZQrqR4s6jQqD8
|
|
|
|
analytics:
|
|
googleAnalyticsId: G-BCXWVKFL1K
|
|
insightsUrl: https://api.hanzo.ai/v1/event</code></pre>
|
|
<h3>TypeScript Alternative (<code>hanzo.config.ts</code>)</h3>
|
|
<p>For TypeScript packages using <code>@hanzo/ai</code> or <code>hanzo</code>:</p>
|
|
<pre><code class="lang-typescript">import { defineConfig } from '@hanzo/config';
|
|
|
|
export default defineConfig({
|
|
name: 'agency',
|
|
slug: 'agency',
|
|
type: 'site',
|
|
framework: 'vite',
|
|
build: {
|
|
command: 'pnpm build',
|
|
output: 'dist',
|
|
spa: true,
|
|
},
|
|
commerce: {
|
|
org: 'hanzo',
|
|
checkoutUrl: 'https://pay.hanzo.ai',
|
|
providers: ['square', 'crypto', 'wire'],
|
|
},
|
|
iam: {
|
|
issuer: 'https://hanzo.id',
|
|
clientId: 'hanzo-agency',
|
|
},
|
|
});</code></pre>
|
|
<hr>
|
|
<h2>3. Deployment Modes</h2>
|
|
<h3>Mode A: The Sites Plane (<code>bin/site</code> via CI Action)</h3>
|
|
<p>The static export plane sends zero runtime compute to Kubernetes; files are served directly from S3/SeaweedFS edge cache:</p>
|
|
<ol><li><strong>Self-provision</strong>: <code>POST https://api.hanzo.ai/v1/projects</code> (creates or confirms project slug).</li><li><strong>Enqueue</strong>: <code>POST https://api.hanzo.ai/v1/projects/<slug>/deployments</code> -> returns <code>{id, bucket, prefix, upload: {url, fields}}</code>.</li><li><strong>Upload</strong>: Direct multipart POST to S3 presigned URL in parallel (assets first, then HTML documents as the activation switch).</li><li><strong>Complete</strong>: <code>POST https://api.hanzo.ai/v1/projects/<slug>/deployments/<id>/complete</code> with the key manifest.</li></ol>
|
|
<h3>Mode B: Containerized Static Server (<code>ghcr.io/hanzoai/static:0.5.15</code>)</h3>
|
|
<p>For deployments requiring a Kubernetes Service and Ingress:</p>
|
|
<pre><code class="lang-dockerfile"># Dockerfile
|
|
FROM node:22 AS build
|
|
WORKDIR /src
|
|
RUN npm i -g pnpm@9
|
|
COPY package.json pnpm-lock.yaml ./
|
|
RUN pnpm install --frozen-lockfile
|
|
COPY . .
|
|
RUN pnpm build
|
|
|
|
FROM ghcr.io/hanzoai/static:0.5.15
|
|
COPY --from=build /src/dist /public
|
|
ENTRYPOINT ["/static", "-spa"]</code></pre>
|
|
<h3>Mode C: Native Agent Deployment (<code>/v1/projects/sites/deploy</code>)</h3>
|
|
<p>Agents and tools can programmatically publish a static site in one API call:</p>
|
|
<pre><code class="lang-bash">curl -X POST "https://api.hanzo.ai/v1/projects/sites/deploy" \
|
|
-H "Authorization: Bearer $HANZO_TOKEN" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"slug": "my-site",
|
|
"name": "My Site",
|
|
"files": [
|
|
{"path": "index.html", "content": "<!DOCTYPE html><html>...</html>"},
|
|
{"path": "style.css", "content": "body { background: #000; color: #fff; }"}
|
|
]
|
|
}'</code></pre>
|
|
<hr>
|
|
<h2>4. Checkout & Payment Flow (No Stripe)</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code>User clicks "Get Started" / Plan CTA
|
|
│
|
|
├──> https://pay.hanzo.ai/?plan=agency&return=https://hanzo.agency/payment-success
|
|
│ │
|
|
│ ├── Square Web Payments SDK (Sandbox or Production)
|
|
│ ├── Crypto Rails (BTC, ETH, USDC)
|
|
│ └── Bank Wire Instructions
|
|
│
|
|
└──> POST https://api.hanzo.ai/v1/billing/topup/token
|
|
│
|
|
└── Hanzo Commerce Engine (authorizes & captures via Square)</code></pre>
|
|
<h3>In Code (<code>src/lib/commerce.ts</code>)</h3>
|
|
<pre><code class="lang-typescript">const PAY = 'https://pay.hanzo.ai';
|
|
const COMMERCE = 'https://api.hanzo.ai/v1/commerce';
|
|
const ORG = 'hanzo';
|
|
|
|
export function checkoutUrl(planId?: string, returnPath = '/payment-success'): string {
|
|
if (!planId) return PAY;
|
|
const back = new URL(returnPath, window.location.origin).toString();
|
|
return `${PAY}/?plan=${encodeURIComponent(planId)}&return=${encodeURIComponent(back)}`;
|
|
}</code></pre>
|
|
<h3>Account & Order Management</h3>
|
|
<ul><li>Users view orders, subscriptions, and payment history at <code>https://billing.hanzo.ai</code> or <code>https://hanzo.id</code>.</li><li>Single Sign-On and session management route through <code>https://hanzo.id</code> (<code>/v1/iam/oauth/authorize</code>).</li></ul>
|
|
<hr>
|
|
<h2>5. Verification Checklist for Any Site</h2>
|
|
<ul><li>[ ] <code>hanzo.yml</code> exists and defines <code>slug</code>, <code>framework</code>, <code>routing</code>, <code>commerce</code>, and <code>iam</code>.</li><li>[ ] <code>.github/workflows</code> and <code>.hanzo/workflows</code> are synchronized.</li><li>[ ] No Stripe packages (<code>@stripe/*</code>), scripts (<code>js.stripe.com</code>), or keys exist in codebase.</li><li>[ ] All pricing buttons point to <code>checkoutUrl(planId)</code> resolving to <code>pay.hanzo.ai</code>.</li><li>[ ] Square sandbox credentials and environment match <code>GET /v1/commerce/org?org=hanzo</code>.</li><li>[ ] Google Analytics (<code>G-BCXWVKFL1K</code> or repo tag) tracks both initial load and SPA route changes.</li><li>[ ] Auth / Login buttons link to <code>https://hanzo.id</code> or use Hanzo IAM OIDC.</li><li>[ ] Calendar booking link points to official Google Calendar (<code>https://calendar.app.google/z1YsZQrqR4s6jQqD8</code>).</li></ul>
|
|
<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-static-sites-cd.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |