diff --git a/SETUP.md b/SETUP.md
new file mode 100644
index 0000000..dbf23e0
--- /dev/null
+++ b/SETUP.md
@@ -0,0 +1,56 @@
+# Setup — Vercel + Cloudflare
+
+Connect this repository to Vercel and expose it on `ai-architectures.moretes.com` via
+Cloudflare DNS.
+
+## 1. Create the Vercel project
+
+1. Sign in at https://vercel.com with the GitHub account that owns this repo.
+2. Click **Add New… → Project** and import `fernandofatech/aws-ai-reference-architectures`.
+3. **Framework preset:** auto-detected.
+4. **Root directory:** `frontend`.
+5. **Build command:** auto-detected from the project's `package.json`.
+6. Click **Deploy** to confirm the first build works.
+
+## 2. Capture the Vercel IDs
+
+In **Settings → General**, copy:
+
+- `Project ID` → maps to `VERCEL_PROJECT_ID`
+- `Team ID` (or personal account ID) → `VERCEL_ORG_ID`
+
+Create a token at https://vercel.com/account/tokens → `VERCEL_TOKEN`.
+
+## 3. Configure GitHub Actions secrets
+
+```bash
+gh secret set VERCEL_TOKEN      --body "<token>" -R fernandofatech/aws-ai-reference-architectures
+gh secret set VERCEL_ORG_ID     --body "<org-id>" -R fernandofatech/aws-ai-reference-architectures
+gh secret set VERCEL_PROJECT_ID --body "<project-id>" -R fernandofatech/aws-ai-reference-architectures
+```
+
+## 4. Attach the custom subdomain
+
+In Vercel: **Settings → Domains → Add** → `ai-architectures.moretes.com`.
+
+## 5. Cloudflare DNS
+
+In the Cloudflare dashboard for `moretes.com`:
+
+- **Type:** CNAME
+- **Name:** `ai-architectures`
+- **Target:** `cname.vercel-dns.com`
+- **Proxy status:** **DNS only** (gray cloud) — required so Vercel can issue
+  the TLS certificate.
+
+## 6. Verify
+
+```bash
+curl -I https://ai-architectures.moretes.com
+```
+
+Expect `HTTP/2 200` and `server: Vercel`.
+
+## Optional — preview deployments
+
+PR previews work automatically once the secrets are set.