ci: add GitHub Actions workflow for automatic Cloudflare deployment

- Add deploy.yml workflow that triggers on push to main
- Builds shared package, web app, and deploys to Cloudflare Workers
- Requires CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID secrets
- Update README with setup instructions for automatic deployment

Author: lauragift21

.github/workflows/deploy.yml

@@ -0,0 +1,38 @@
+name: Deploy to Cloudflare
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build shared package
+        run: npm run build -w packages/shared
+
+      - name: Build web app
+        run: npm run build -w apps/web
+
+      - name: Deploy to Cloudflare Workers
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          workingDirectory: apps/api
+          command: deploy

README.md

@@ -164,6 +164,24 @@ npm run dev
 
 ### 7. Deploy to Production
 
+#### Option A: Automatic Deployment (Recommended)
+
+The project includes a GitHub Actions workflow that automatically deploys to Cloudflare when you push to `main`.
+
+**Setup GitHub Secrets:**
+
+1. Go to your repository on GitHub → Settings → Secrets and variables → Actions
+2. Add these secrets:
+   - `CLOUDFLARE_API_TOKEN`: Create at [Cloudflare API Tokens](https://dash.cloudflare.com/profile/api-tokens) with "Edit Cloudflare Workers" permissions
+   - `CLOUDFLARE_ACCOUNT_ID`: Find in the Cloudflare dashboard URL or Workers overview page
+
+Once configured, every push to `main` will automatically:
+1. Build the shared package
+2. Build the web frontend
+3. Deploy to Cloudflare Workers
+
+#### Option B: Manual Deployment
+
 Kivo deploys as a single Cloudflare Worker with static assets:
 
 ```bash