# 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)
defineActions()─┘            └► RLS policies (Supabase)
```

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](/compiler/definitions) for the full security model.

---

## The two products

### Quickback Compiler

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

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

**Start here:**
- **[Getting Started](/compiler/getting-started)** — Create your first project
- **[Definitions](/compiler/definitions)** — Schema, Firewall, Access, Guards, Masking, Views, Actions
- **[Cloud Compiler](/compiler/cloud-compiler)** — CLI, MCP server, authentication
- **[Claude Code Skill](/compiler/claude-code-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](/stack/auth)** — Better Auth with email OTP, passkeys, organizations, admin
- **[Storage](/stack/storage)** — KV (sessions, cache) and R2 (files)
- **[Realtime](/stack/realtime)** — Durable Objects + WebSocket
- **[Queues](/stack/queues)** — Background jobs and webhook delivery
- **[Vector & AI](/stack/vector)** — Embeddings, semantic search
- **[Webhooks](/stack/webhooks)** — Inbound (signed) and outbound (retried)
- **[Quickback CMS](/stack/cms)** — Schema-driven admin UI
- **[Account UI](/stack/account-ui)** — 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.
