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]>
322 lines
22 KiB
HTML
322 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-analytics</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-analytics.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-analytics">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-analytics.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-analytics</h1><p class="lede">Hanzo Analytics is a privacy-focused web analytics platform -- an alternative to Google Analytics.</p><p><!-- Updated: 2026-03-26T15:03:36Z --></p>
|
|
<h1>Hanzo Analytics - Privacy-Focused Web Analytics</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-platform.md</code>, <code>hanzo/hanzo-cloud.md</code>, <code>hanzo/hanzo-database.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Analytics is a <strong>privacy-focused web analytics platform</strong> -- an alternative to Google Analytics. Next.js 15 dashboard (port 3000) with Prisma ORM, PostgreSQL/ClickHouse storage, and a Go-based high-performance event collector. Includes anti-ad-blocker technology (encrypted tracker + WASM decryption). Live at <code>analytics.hanzo.ai</code>.</p>
|
|
<h3>Why Hanzo Analytics?</h3>
|
|
<ul><li><strong>Privacy-first</strong>: No cookies required, GDPR/HIPAA compliant by design</li><li><strong>Anti-ad-blocker</strong>: Encrypted tracker script + WASM decryptor defeats blockers</li><li><strong>Dual database</strong>: PostgreSQL for metadata, optional ClickHouse for event scale</li><li><strong>Real-time</strong>: Live visitor tracking, real-time dashboards</li><li><strong>Multi-tenant</strong>: Teams, users, roles, shared dashboards</li><li><strong>Revenue tracking</strong>: Built-in e-commerce revenue attribution</li><li><strong>Link shortener + tracking pixels</strong>: URL shortening and pixel tracking built in</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Dashboard</strong>: Next.js 15 + React 19 + Chart.js + react-intl (i18n)</li><li><strong>ORM</strong>: Prisma 6 with PostgreSQL adapter</li><li><strong>State</strong>: Zustand + TanStack React Query</li><li><strong>Collector</strong>: Go (Gin) + ClickHouse for high-throughput event ingestion</li><li><strong>Tracker</strong>: Rollup-bundled JS, encrypted delivery via WASM</li><li><strong>Validation</strong>: Zod</li><li><strong>Auth</strong>: JWT (jsonwebtoken) + bcryptjs password hashing</li><li><strong>Linting</strong>: Biome</li><li><strong>Testing</strong>: Jest + Cypress (e2e)</li><li><strong>Images</strong>: <code>ghcr.io/hanzoai/analytics:latest</code></li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/analytics</code> (Umami fork, v3.0.3).</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Tracking page views, events, and sessions across websites</li><li>Privacy-compliant analytics (GDPR, HIPAA) without third-party cookies</li><li>Real-time visitor dashboards and traffic reports</li><li>E-commerce revenue attribution and funnel analysis</li><li>URL shortening with click tracking</li><li>Tracking pixel deployment</li><li>Shared/public analytics dashboards (share links)</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>PostgreSQL</strong> (minimum v12.14) for metadata and event storage</li><li><strong>Node.js 18.18+</strong> for the dashboard application</li><li><strong>Go 1.26+</strong> for the collector service (optional, for ClickHouse pipeline)</li><li><strong>ClickHouse</strong> (optional) for high-volume event analytics</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | UI | <code>https://analytics.hanzo.ai</code> | | Demo | <code>https://analytics.hanzo.ai/share/LGazGOecbDtaIwDr/hanzo.ai</code> | | Dev port | <code>3001</code> (Next.js dev) / <code>3000</code> (production) | | Image | <code>ghcr.io/hanzoai/analytics:latest</code> | | Package | <code>@hanzo/analytics</code> (v3.0.3) | | Database | PostgreSQL (required), ClickHouse (optional) | | ORM | Prisma 6 | | Collector | Go + Gin + ClickHouse (<code>collector/</code>) | | Health check | <code>/api/heartbeat</code> | | Repo | <code>github.com/hanzoai/analytics</code> | | License | MIT |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Docker Compose</h3>
|
|
<pre><code class="lang-yaml"># compose.yml
|
|
services:
|
|
analytics:
|
|
image: ghcr.io/hanzoai/analytics:latest
|
|
ports:
|
|
- "3000:3000"
|
|
environment:
|
|
DATABASE_URL: postgresql://analytics:analytics@db:5432/analytics
|
|
APP_SECRET: replace-me-with-a-random-string
|
|
depends_on:
|
|
db:
|
|
condition: service_healthy
|
|
restart: always
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
db:
|
|
image: postgres:15-alpine
|
|
environment:
|
|
POSTGRES_DB: analytics
|
|
POSTGRES_USER: analytics
|
|
POSTGRES_PASSWORD: analytics
|
|
volumes:
|
|
- analytics-db-data:/var/lib/postgresql/data
|
|
restart: always
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
volumes:
|
|
analytics-db-data:</code></pre>
|
|
<h3>From source</h3>
|
|
<pre><code class="lang-bash">git clone https://github.com/hanzoai/analytics.git
|
|
cd analytics
|
|
cp .env.example .env # Set DATABASE_URL
|
|
pnpm install
|
|
pnpm build # Creates tables on first run, default: admin/analytics
|
|
pnpm start # http://localhost:3000</code></pre>
|
|
<h3>Add tracking to a website</h3>
|
|
<pre><code class="lang-html"><script defer src="https://analytics.hanzo.ai/script.js"
|
|
data-website-id="YOUR-WEBSITE-ID"></script></code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code> ┌──────────────────────┐
|
|
│ analytics.hanzo.ai │
|
|
│ (Next.js 15) │
|
|
│ │
|
|
│ ┌────────────────┐ │
|
|
Browser ─────────▶│ │ /api/send │ │──── PostgreSQL
|
|
(tracker.js) │ │ /api/batch │ │ (sessions, events,
|
|
│ │ /api/realtime │ │ users, teams, etc.)
|
|
│ │ /api/websites │ │
|
|
│ │ /api/reports │ │
|
|
│ │ /api/auth │ │
|
|
│ └────────────────┘ │
|
|
└──────────────────────┘
|
|
|
|
┌──────────────────────┐
|
|
│ collector (Go) │
|
|
High-volume ─────▶│ Gin HTTP server │──── ClickHouse
|
|
events │ event.go │ (event_data,
|
|
│ forward/ │ session_data)
|
|
│ writer/ │
|
|
└──────────────────────┘</code></pre>
|
|
<h3>Data Models (Prisma)</h3>
|
|
<ul><li><strong>User</strong>: Admin users with bcrypt-hashed passwords, roles</li><li><strong>Website</strong>: Tracked sites with optional share links</li><li><strong>Session</strong>: Browser/OS/device/geo per visitor</li><li><strong>WebsiteEvent</strong>: Page views, custom events with UTM params, click IDs</li><li><strong>EventData / SessionData</strong>: Key-value custom properties</li><li><strong>Team / TeamUser</strong>: Multi-tenant team management</li><li><strong>Report / Segment</strong>: Saved analytics queries</li><li><strong>Revenue</strong>: E-commerce revenue tracking per event</li><li><strong>Link</strong>: URL shortener with slug-based routing</li><li><strong>Pixel</strong>: Tracking pixel management</li></ul>
|
|
<h3>Anti-Ad-Blocker Pipeline</h3>
|
|
<ol><li>Tracker JS encrypted into <code>tracker.bin</code> (binary blob)</li><li><code>decrypt.wasm</code> (WebAssembly) decrypts in-browser memory</li><li>Lightweight loader fetches both, decrypts, executes</li><li>API calls use obfuscated function names (not <code>track()</code>)</li><li>Payloads encrypted before transmission</li></ol>
|
|
<h3>API Routes</h3>
|
|
<p>| Route | Purpose | |-------|---------| | <code>/api/send</code> | Receive tracking events | | <code>/api/batch</code> | Batch event ingestion | | <code>/api/realtime</code> | Real-time visitor data | | <code>/api/websites</code> | Website CRUD | | <code>/api/reports</code> | Report CRUD | | <code>/api/teams</code> | Team management | | <code>/api/users</code> | User management | | <code>/api/auth</code> | Authentication | | <code>/api/links</code> | URL shortener | | <code>/api/pixels</code> | Tracking pixels | | <code>/api/share</code> | Public dashboard sharing | | <code>/api/heartbeat</code> | Health check |</p>
|
|
<h3>Environment Variables</h3>
|
|
<pre><code class="lang-bash">DATABASE_URL=postgresql://user:pass@localhost:5432/analytics # Required
|
|
APP_SECRET=random-secret-string # Required
|
|
CLICKHOUSE_URL=http://localhost:8123 # Optional</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Build fails on first run | Missing DATABASE_URL | Set <code>DATABASE_URL</code> in <code>.env</code> before <code>pnpm build</code> | | Default login not working | Changed by script | Default is <code>admin</code> / <code>analytics</code>, use <code>npm run change-password</code> | | Ad blocker blocks events | Tracker detected | Use encrypted tracker pipeline (enabled by default) | | High event volume slow | PostgreSQL bottleneck | Deploy Go collector with ClickHouse backend | | Geo data missing | No GeoIP database | Run <code>pnpm build-geo</code> to download MaxMind DB | | Docker health check fails | Port not ready | Increase <code>retries</code> or wait for DB initialization |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-platform.md</code> - PaaS for deploying analytics</li><li><code>hanzo/hanzo-cloud.md</code> - Cloud dashboard</li><li><code>hanzo/hanzo-database.md</code> - PostgreSQL infrastructure</li><li><code>hanzo/hanzo-kms.md</code> - Secret management for APP_SECRET</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: analytics, tracking, privacy, web-analytics, events <strong>Prerequisites</strong>: PostgreSQL, Node.js 18.18+, Docker (optional)</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-analytics.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |