Introduction

Hanzo Base is an open-source backend-as-a-service extended with enterprise features for the Hanzo ecosystem. It ships as a single Go binary with zero dependencies.

What is Base?

Base provides everything you need to build full-stack applications:

• Database — SQLite for local dev, PostgreSQL for production. Full REST API auto-generated from your schema.
• Authentication — Email/password, OAuth2, and Hanzo IAM integration with fine-grained access control.
• Realtime — Subscribe to database changes over SSE with optimistic update support.
• File Storage — Upload files directly to collections. Local filesystem or S3-compatible storage.
• Cloud Functions — Server-side JavaScript hooks, custom routes, and scheduled tasks.
• Admin UI — Built-in dashboard at /_/ for managing everything.

Why Base?

For Local Development

One binary, zero dependencies. Download and run:

base serve --dev

That's it. Auth, database, REST API, realtime, file storage, cloud functions, and admin UI — all running at localhost:8090.

For Production

Deploy the same binary to Kubernetes with multi-tenant PostgreSQL. Scale horizontally with replicas. Native ZAP protocol for zero-copy inter-service communication.

For the Hanzo Ecosystem

Base integrates natively with:

• Hanzo IAM (hanzo.id) — Enterprise SSO and identity management
• Hanzo ORM — Shared Go ORM with SQLite, PostgreSQL, and ZAP drivers
• ZAP Protocol — Zero-copy binary protocol for high-performance inter-service communication
• Hanzo Datastore — ClickHouse analytics backend