# Quickback Stack

**Quickback Stack** is the runtime services that surround your compiled API. While the [Quickback Compiler](/compiler) generates your routes and security policies, the Stack is everything else you need to ship a real application — auth, storage, realtime, queues, an admin UI, an account UI — all on your own Cloudflare account.

## What you get

| Component | Service | Purpose |
|-----------|---------|---------|
| [Auth](/stack/auth) | Better Auth | Email/OTP, passkeys, organizations, admin |
| [Storage](/stack/storage) | KV, R2 | Sessions, cache, files |
| [Realtime](/stack/realtime) | Durable Objects | WebSocket for live updates |
| [Queues](/stack/queues) | Cloudflare Queues | Background jobs, webhook delivery |
| [Vector & AI](/stack/vector) | Workers AI | Embeddings, semantic search |
| [Webhooks](/stack/webhooks) | Hono + Queues | Signed inbound, retried outbound |
| [Quickback CMS](/stack/cms) | Embedded SPA | Schema-driven admin UI |
| [Account UI](/stack/account-ui) | Embedded SPA | Login, profile, orgs, admin |

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                     Cloudflare Edge                          │
├─────────────────────────────────────────────────────────────┤
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    │
│   │   Workers   │    │   Durable   │    │     KV      │    │
│   │  (API/CMS)  │    │   Objects   │    │   (Cache)   │    │
│   └──────┬──────┘    └──────┬──────┘    └──────┬──────┘    │
│          │                   │                   │           │
│   ┌──────┴──────┐    ┌──────┴──────┐    ┌──────┴──────┐    │
│   │     D1      │    │  Realtime   │    │     R2      │    │
│   │  (or Neon)  │    │  (WebSocket)│    │  (Storage)  │    │
│   └─────────────┘    └─────────────┘    └─────────────┘    │
│                                                              │
│   ┌─────────────┐    ┌─────────────────────────────────┐    │
│   │   Queues    │    │         Better Auth              │    │
│   │ (Background)│    │  (Email OTP, Passkeys, etc.)    │    │
│   └─────────────┘    └─────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘
```

## Your account, your data

Everything in Quickback Stack runs on your own Cloudflare account:

- **Workers** — your deployments, your logs
- **Storage** — your KV namespaces, your R2 buckets
- **Secrets** — your API keys, in your Wrangler secrets

Quickback provides the architecture and the code generation. You own the infrastructure.

## Quick start

```bash
# Scaffold + compile interactively
mkdir my-app && cd my-app
npx @quickback-dev/cli start

# Deploy to your Cloudflare account
npm i -g wrangler
wrangler deploy
```

`start` handles scaffold, login (only when needed), and the first compile in one shot. The deploy step uses your own wrangler auth and ships everything to your Cloudflare account.

## See also

- [Quickback Compiler](/compiler) — the build tool that generates your API
- [Quickback for Hono API](/compiler/targets/hono-api) — what the compiler outputs
- [Definitions](/compiler/definitions) — the security model the Stack runs
