# Deployment prerequisites (Proxmox production)

> **Azure removed (2026-06):** Static Web Apps, Bicep infra, Azure Functions (`api/`), and Azure CI workflows are no longer part of this repo. Production is **VMID 7810** via Proxmox — see [PROXMOX_DEPLOYMENT.md](./deployment/PROXMOX_DEPLOYMENT.md).

## 1. Operator / LAN access

| Requirement | Detail |
|-------------|--------|
| Proxmox SSH | `root@192.168.11.12` (r630-02) |
| Web CT | VMID **7810** @ `192.168.11.37` |
| API CT | VMID **7811** @ `192.168.11.36` (optional; `/api/` proxy) |
| Deploy script | `../proxmox/scripts/mim4u-deploy-to-7810.sh` |

## 2. Build toolchain

```bash
node -v    # 22.x recommended
npm -v     # 10+
convert -version   # ImageMagick (brand prebuild)
```

Install deps:

```bash
cd miracles_in_motion
npm ci    # uses legacy-peer-deps via .npmrc
```

## 3. Environment variables

Copy `.env.example` → `.env.local` for local dev. Production frontend is static; secrets belong on **7811** (API) or NPMplus, not in the Vite bundle.

| Variable | Purpose |
|----------|---------|
| `VITE_STRIPE_PUBLISHABLE_KEY` | Donate page (public key only) |
| `VITE_API_BASE_URL` | Override API base (default `/api` via nginx) |
| `VITE_GA_MEASUREMENT_ID` | Analytics (optional) |

See `env.production.example` for a non-Azure production template.

## 4. Pre-deploy checklist

- [ ] `npm run validate:ci` passes (type-check + tests + header WCAG audit)
- [ ] `npm run build` succeeds (brand export + Vite)
- [ ] NPMplus TLS valid for mim4u.org / www / secure / training
- [ ] `./scripts/mim4u-deploy-to-7810.sh` from proxmox repo (or `--dry-run` review)
- [ ] Post-deploy: `curl -H 'Host: mim4u.org' http://192.168.11.37/` → 200
- [ ] Optional: `npm run a11y:header-audit:live` on production URL

## 5. Stripe & DNS (unchanged)

- **Stripe:** live keys and webhooks configured on API (7811), not in this static repo.
- **Cloudflare / DNS:** A/AAAA or CNAME to public IP per NPMplus; use proxmox `scripts/update-all-dns-to-public-ip.sh --zone-only=mim4u.org --dry-run` before changes.

## 6. Legacy documentation

Azure deployment guides were **archived** to `docs/archive/azure-deprecated/` (2026-06). Do not follow them for new deploys.