Deployment Workflow

Local Testing

cd apps/backend
./deploy-local-docker.sh

Wait for deployment, then verify:

# Health check
curl http://localhost:8090/health | jq
 
# API docs  
open http://localhost:8090/docs
 
# Test endpoint
curl http://localhost:8090/v1/leagues | jq

Stop local Docker:

docker compose down

Deploy to Cloud Run

cd /path/to/project/root
./deploy-all.sh

Select: Option 2 (Backend only)

Monitor: Terminal shows progress:

Building image...
Pushing to GCR...
Deploying to Cloud Run...
✅ Deployment successful!

Save the URL:

cat .backend-url
# https://altsportsleagues-backend-xxx-uc.a.run.app

Map Custom Domain

Google Cloud Console:

1. Navigate to Cloud Run (opens in a new tab)
2. Click altsportsleagues-backend
3. Tab: "Manage Custom Domains"
4. Click "Add Mapping"
5. Domain: api.altsportsleagues.ai
6. Region: us-central1
7. Continue
8. Note CNAME: ghs.googlehosted.com

Cloudflare DNS:

1. Cloudflare Dashboard (opens in a new tab)
2. Domain: altsportsleagues.ai
3. DNS → Add Record
4. Configure:
   • Type: CNAME
   • Name: api
   • Target: ghs.googlehosted.com
   • Proxy: ☁️ ON
5. Save

Wait: 5-30 minutes for SSL verification

Verify Backend

# Test custom domain
curl https://api.altsportsleagues.ai/health | jq
 
# Test API
curl https://api.altsportsleagues.ai/v1/leagues | jq
 
# Open docs
open https://api.altsportsleagues.ai/docs

Update Configuration

Edit clients/frontend/vercel.json:

{
  "rewrites": [
    {
      "source": "/api/v1/:path*",
      "destination": "https://api.altsportsleagues.ai/v1/:path*"
    }
  ]
}

Key change: Use custom domain, remove /api/ from backend path

Set Environment Variables

Vercel Dashboard:

1. Go to project → Settings → Environment Variables
2. Add for Production:

   NEXT_PUBLIC_API_URL=https://api.altsportsleagues.ai
   BACKEND_API_URL=https://api.altsportsleagues.ai

Deploy to Vercel

cd clients/frontend
vercel --prod

Wait: 2-5 minutes

Map Custom Domain

Vercel Dashboard:

1. Project → Settings → Domains
2. Add: altsportsleagues.ai
3. Note CNAME from Vercel

Cloudflare:

1. DNS → Add Record
2. Configure:
   • Type: CNAME
   • Name: @
   • Target: cname.vercel-dns.com
   • Proxy: ☁️ ON

Verify Frontend

# Open site
open https://altsportsleagues.ai
 
# Test API proxy
curl https://altsportsleagues.ai/api/v1/leagues | jq

Browser DevTools Check:

• No CORS errors ✅
• API calls return 200 ✅
• No mixed content warnings ✅

Deploy Docs

cd apps/docs-site
vercel --prod

Map Domain

Vercel: Add docs.altsportsleagues.ai
Cloudflare: Add CNAME docs → Vercel target

Verify

open https://docs.altsportsleagues.ai