zooqueen 0ea9ae0ee3 publish gui.hanzo.ai to the Sites plane, not to Pages
The build already produced a static export at apps/gui-docs/out; only the last
step differed from every other site we serve. It uploaded that directory to a
Cloudflare Pages project, which made gui.hanzo.ai the one host in the hanzo.ai
zone still resolving off our own ingress — 1 record of 150, measured. A page
published there cannot be rebuilt or rolled back from here.

The site action is the one publish path: it reads the deploy credential from
KMS at run time and syncs to s3://hanzo-sites/hanzo/gui, which universe's
gui-static route serves. That removes the Cloudflare token read and the wrangler
project-create step with it — two things to hold and rotate, for a step that is
now one action.

Trigger narrowed to main. --production-branch=main made a push to any other
branch a Pages preview; the Sites plane keeps one prefix per slug, so leaving
`dev` in the list would have let a side branch overwrite what is live. No dev
branch exists on either remote today, which is what makes this safe to state
rather than guess.
2026-08-21 08:40:12 -07:00
2024-04-26 21:51:12 +08:00
2026-04-17 22:50:22 +08:00
2023-07-30 22:03:19 +08:00
2025-12-30 16:49:34 +08:00
2023-07-30 15:46:09 +08:00

Hanzo Docs

The documentation framework for Hanzo AI, Lux Network, Zoo Labs Foundation, and Zen LM.

A powerful React.js documentation framework built for the Hanzo ecosystem.

Features

  • Multi-Brand Support: Unified framework supporting Hanzo, Lux, Zoo, and Zen documentation
  • Next.js 15+: Built on the latest Next.js with App Router
  • MDX: Write documentation in MDX with full component support
  • Search: Built-in search with Orama and Algolia support
  • TypeScript: Full TypeScript support with auto-generated API docs
  • OpenAPI: Generate interactive API documentation from OpenAPI specs
  • i18n: Internationalization support for multiple languages
  • Themes: Customizable themes with dark mode support

Quick Start

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Project Structure

.
├── apps/
│   ├── docs/              # Main documentation site
│   ├── dev-docs/          # Hanzo Dev CLI docs
│   ├── zen-docs/          # Zen LM model docs (zenlm.org)
│   ├── zap-docs/          # ZAP protocol docs
│   └── bot-docs/          # Bot documentation
├── packages/
│   ├── brand/             # Brand configuration (Hanzo, Lux, Zoo)
│   ├── core/              # Core functionality
│   ├── ui/                # UI components
│   ├── mdx/               # MDX processing
│   ├── openapi/           # OpenAPI integration
│   └── ...                # Other packages
└── examples/              # Example implementations

Brand Configuration

Set the brand via environment variable:

# .env.local
NEXT_PUBLIC_BRAND=hanzo  # or 'lux', 'zoo', or 'zen'

Available Brands

Brand Organization Documentation
hanzo Hanzo AI Inc hanzoai.github.io/docs
lux Lux Network docs.lux.network
zoo Zoo Labs Foundation docs.zoo.ngo
zen Zen LM zenlm.org

Development

Prerequisites

  • Node.js 18.17+
  • pnpm 10+

Commands

# Development
pnpm dev              # Start all apps in dev mode
pnpm dev:all          # Start docs app only
pnpm dev:examples     # Start example apps

# Build
pnpm build            # Build all packages
pnpm clean            # Clean build artifacts

# Quality
pnpm lint             # Run ESLint
pnpm lint:prettier    # Check formatting
pnpm prettier         # Fix formatting
pnpm test             # Run tests
pnpm types:check      # Type check

Documentation Sites

Hanzo Docs (hanzoai.github.io/docs)

Documentation for Hanzo AI infrastructure including:

  • AI API
  • Agent SDK
  • MCP Tools
  • Chat Platform
  • Python/JS SDKs

Lux Docs (docs.lux.network)

Documentation for Lux Network including:

  • Architecture & Consensus
  • Node Operation
  • SDK & CLI
  • Smart Contracts
  • Post-Quantum Security

Zoo Docs (docs.zoo.ngo)

Documentation for Zoo Labs Foundation including:

  • DSO Protocol
  • Proof of AI (PoAI)
  • Zen Model Family
  • Gym SDK
  • Training Infrastructure

Forking for New Brands

  1. Clone this repository
  2. Create brand config in packages/brand/src/brands/
  3. Add CSS in packages/brand/css/
  4. Update the brands registry
  5. Set NEXT_PUBLIC_BRAND environment variable

Contributing

Please read the Contributing Guide before submitting a pull request.

License

MIT © Hanzo AI Inc


Built with Hanzo Docs

S
Description
No description provided
Readme MIT
470 MiB
Languages
TypeScript 41.7%
MDX 34.6%
JavaScript 20.5%
CSS 1.3%
XSLT 0.7%
Other 1%