Skip to content

README.md

Latest commit

 

History

History
135 lines (106 loc) · 4.72 KB

README.md

File metadata and controls

135 lines (106 loc) · 4.72 KB
blazestack

Blazing fast full-stack apps.
Ship web, API, and mobile from a single repo — end-to-end type safe, Cloudflare-ready.

npm version npm downloads License Bun

npx create-blaze my-app

Getting Started · Architecture · Packages · Deploying · Troubleshooting

What is blazestack?

blazestack is a production-ready Bun monorepo template. One command gives you a fully wired full-stack app with auth, a database, and type-safe API — ready to deploy on Cloudflare Workers.

my-app/
├── apps/
│   ├── api/       Hono — auth + tRPC on Cloudflare Workers
│   ├── web/       React Router v7 SSR on Cloudflare Workers
│   └── mobile/    Expo SDK 55 — iOS + Android
└── packages/
    ├── auth/      Better Auth (server + client)
    ├── db/        Drizzle ORM + PostgreSQL
    ├── env/       Zod-validated environment variables
    ├── trpc/      Shared tRPC v11 router — no codegen
    └── ui/        Shared components (web + native)

Stack

Runtime & package manager
API server on Cloudflare Workers
SSR web app on Cloudflare Workers
iOS + Android (SDK 55 / RN 0.84)
Authentication & sessions
PostgreSQL ORM + migrations
End-to-end type-safe API — no codegen
Deploy target for API + web
Linter + formatter (replaces ESLint + Prettier)
Monorepo task runner with caching

Quick Start

# Scaffold
npx create-blaze my-app
cd my-app

# Install
bun install

# Environment
cp apps/api/.dev.vars.example apps/api/.dev.vars
# Fill in DATABASE_URL, BETTER_AUTH_SECRET, BETTER_AUTH_URL

# Database
bun db:setup && bun db:generate && bun db:migrate

# Dev
bun dev:api   # → http://localhost:8787
bun dev:web   # → http://localhost:5173

→ Full guide in docs/getting-started.md

Documentation
Getting Started Setup, env vars, dev commands
Architecture Request flow, key patterns
Packages @blazestack/* API reference
Authentication Sessions, OAuth, trusted origins
Adding Features tRPC, DB tables, routes, screens
Deploying Cloudflare Workers, EAS, Hyperdrive
Troubleshooting Common errors and fixes

Contributing

PRs and issues are welcome. See CONTRIBUTING.md.

License

MIT — see LICENSE.