# Deploy: Fly.io + Neon + Vercel

A best-of-breed split: the **API on Fly.io** (global containers), **PostgreSQL on Neon** (serverless), and the **app + landing on Vercel** (static, edge CDN). Pick this when you want each piece on the platform that does it best.

**Outcome:** API at `api.yourdomain.com`, app at `app.yourdomain.com`, landing at `yourdomain.com`.

## 1. Database — Neon

1. Create a project at [Neon](https://neon.tech) and copy the **connection string** (use the pooled one for serverless).
1. You'll set it as `FS_DB_URL` on the API in the next step.

## 2. API — Fly.io

1. Install [flyctl](https://fly.io/docs/flyctl/install/), then run `fly launch` in `backend/` (it detects the Dockerfile — don't deploy yet).

1. Set secrets ([Configuration](https://docs.fastsvelte.dev/reference/configuration/index.md)):

   ```bash
   fly secrets set \
     FS_DB_URL="<neon-connection-string>" \
     FS_ENVIRONMENT=prod \
     FS_BASE_API_URL=https://api.yourdomain.com \
     FS_BASE_WEB_URL=https://app.yourdomain.com \
     FS_JWT_SECRET_KEY=... FS_CRON_SECRET=...
   ```

1. `fly deploy`, then run migrations against Neon: `./sqitch.sh prod deploy` (prod target = `FS_DB_URL`).

1. Add the domain: `fly certs add api.yourdomain.com`, then point DNS at Fly.

## 3. App + landing — Vercel

Create two Vercel projects from the same repo:

- **frontend** — root directory `frontend/`, build `npm run build`, env `PUBLIC_API_BASE_URL=https://api.yourdomain.com`; domain `app.yourdomain.com`.
- **landing** — root directory `landing/`, build `npm run build`; domain `yourdomain.com`.

Vercel auto-deploys on push and provisions SSL.

## 4. Wire it together

- DNS: `api` → Fly.io; `app` and the apex → Vercel.
- Confirm `FS_BASE_API_URL` / `FS_BASE_WEB_URL` match the live URLs so CORS and cookies work ([Configuration](https://docs.fastsvelte.dev/reference/configuration/index.md)).
- Stripe webhook → `https://api.yourdomain.com/webhooks/stripe` ([Billing & Subscriptions](https://docs.fastsvelte.dev/features/billing/index.md)).
- Review the [Security](https://docs.fastsvelte.dev/features/security/index.md) checklist before launch.