# Quickback Documentation

Quickback is a **backend compiler**. Define your database schema and security rules in TypeScript — Quickback compiles them into a Hono API running on Cloudflare Workers, plus the Account UI and CMS that ride alongside it. The Quickback Stack is the Supabase alternative on Cloudflare.

## Quick start

```bash
mkdir my-app && cd my-app
npx @quickback-dev/cli start
```

`start` is interactive — it asks for a template, scaffolds the project on disk, and only prompts for an account just before compiling. If you cancel at the login prompt the scaffold stays put; you can finish later with `quickback compile`.

Prefer scripting?

```bash
npm install -g @quickback-dev/cli
quickback create cloudflare my-app
cd my-app
quickback compile
```

## How it works

Write ~50 lines of definitions. Get a production codebase.

```
defineTable()  ─┐
                ├─► Compiler ─► Hono API    (Cloudflare D1 / Neon)
defineAction() ─┘            └► RLS policies (Neon Postgres)
```

Every API request passes through four security layers:

```
Request → Firewall → Access → Guards → Masking → Response
            │          │        │         │
            │          │        │         └── Hide sensitive fields
            │          │        └── Block field modifications
            │          └── Check roles & conditions
            └── Isolate data by owner/org
```

**Secure by default.** Nothing is accessible until you explicitly open it up. See [Definitions](/define) for the full security model.

---

## The two products

### Quickback Compiler

[**Quickback Compiler**](/start) — the build tool. Define your schema and security rules in TypeScript and compile to a complete Hono application on Cloudflare:

- **[Quickback for Hono API](/api)** — A complete Hono application on Cloudflare D1 or Neon, with CRUD, batch endpoints, OpenAPI, and an MCP server.

**Start here:**
- **[Getting Started](/start/quickstart)** — Create your first project
- **[Deploy](/start/deploy)** — Ship it: one command provisions D1/KV/R2, applies migrations, and deploys the worker
- **[Definitions](/define)** — Schema, Firewall, Access, Guards, Masking, Views, Actions
- **[Cloud Compiler](/tooling/cloud-compiler)** — CLI, MCP server, authentication
- **[Claude Code Skill](/tooling/claude-skill)** — AI-powered authoring assistance

---

### Quickback Stack

The runtime services around your compiled code. Everything you need for a complete Supabase alternative on Cloudflare:

- **[Auth](/platform/auth)** — Better Auth with email OTP, passkeys, organizations, admin
- **[Storage](/platform/storage)** — KV (sessions, cache) and R2 (files)
- **[Realtime](/platform/realtime)** — Durable Objects + WebSocket
- **[Queues](/platform/queues)** — Background jobs and webhook delivery
- **[Vector & AI](/platform/vector)** — Embeddings, semantic search
- **[Webhooks](/platform/webhooks)** — Inbound (signed) and outbound (retried)
- **[Admin UI](/ui/admin)** — Schema-driven admin UI
- **[Account UI](/ui/account)** — Pre-built auth and profile pages

Everything runs on **your own Cloudflare account** — no Quickback infrastructure between you and your data.

---

### Changelog

[**Changelog**](/changelog) — what's new in Quickback. Release notes, new features, and improvements.
