Wan2.1/wan-pwa/DEPLOYMENT.md

Deployment Guide

Frontend (Vercel)

Prerequisites

• Vercel account
• GitHub repository

Steps

1. Push to GitHub

   git push origin main
   

2. Import to Vercel

   • Go to https://vercel.com
   • Click "New Project"
   • Import your repository
   • Select apps/web as the root directory

3. Configure Environment Variables

   Add these in Vercel dashboard:

   NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
   NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGci...
   SUPABASE_SERVICE_ROLE_KEY=eyJhbGci...
   NEXT_PUBLIC_API_URL=https://your-api-url.com
   NEXT_PUBLIC_APP_URL=https://your-app.vercel.app
   

4. Deploy

   • Click "Deploy"
   • Wait for build to complete
   • Visit your deployment URL

Custom Domain (Optional)

1. Go to Settings → Domains
2. Add your custom domain
3. Update DNS records as instructed
4. Update NEXT_PUBLIC_APP_URL to your domain

---

Backend (Modal)

Modal provides serverless Python deployment with GPU support.

Prerequisites

• Modal account
• Modal CLI installed: pip install modal

Steps

1. Install Modal CLI

   pip install modal
   modal setup
   

2. Create Modal App

   Create apps/api/modal_deploy.py:

   import modal
   
   stub = modal.Stub("wan-pwa-api")
   
   image = modal.Image.debian_slim().pip_install_from_requirements("requirements.txt")
   
   @stub.function(image=image)
   @modal.asgi_app()
   def fastapi_app():
       from main import app
       return app
   

3. Set Secrets

   modal secret create wan-secrets \
     SUPABASE_URL=https://xxxxx.supabase.co \
     SUPABASE_SERVICE_ROLE_KEY=eyJhbGci... \
     REPLICATE_API_TOKEN=r8_xxxxx
   

4. Deploy

   cd apps/api
   modal deploy modal_deploy.py
   

5. Get URL

   • Modal will provide a URL like https://your-app--modal.com
   • Update frontend NEXT_PUBLIC_API_URL to this URL

---

Backend (Railway - Alternative)

Railway is simpler but doesn't have GPU support (uses Replicate API instead).

Steps

1. Install Railway CLI

   npm install -g @railway/cli
   railway login
   

2. Create Project

   cd apps/api
   railway init
   

3. Add Environment Variables

   railway variables set SUPABASE_URL=https://xxxxx.supabase.co
   railway variables set SUPABASE_SERVICE_ROLE_KEY=eyJhbGci...
   railway variables set REPLICATE_API_TOKEN=r8_xxxxx
   

4. Deploy

   railway up
   

5. Get URL

   railway domain
   

---

Database (Supabase)

Database is already set up in Supabase - no deployment needed!

Production Checklist

• Run migrations in production project
• Enable RLS (Row Level Security)
• Configure Auth providers (email, Google, GitHub)
• Set up storage buckets with proper policies
• Enable database backups
• Set up monitoring and alerts

---

Redis (Upstash) - Optional

For background jobs and caching.

Steps

1. Create Upstash Account

   • Go to https://upstash.com
   • Create a Redis database

2. Get Connection String

   • Copy the connection URL

3. Update Environment

   REDIS_URL=redis://...
   CELERY_BROKER_URL=redis://...
   

---

CI/CD with GitHub Actions

Create .github/workflows/deploy.yml:

name: Deploy

on:
  push:
    branches: [main]

jobs:
  deploy-frontend:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Deploy to Vercel
        uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.ORG_ID }}
          vercel-project-id: ${{ secrets.PROJECT_ID }}
          working-directory: apps/web

  deploy-backend:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.10'
      - name: Deploy to Modal
        run: |
          pip install modal
          modal token set --token-id ${{ secrets.MODAL_TOKEN_ID }} --token-secret ${{ secrets.MODAL_TOKEN_SECRET }}
          cd apps/api && modal deploy modal_deploy.py          

---

Environment Variables Checklist

Frontend (Vercel)

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY
• NEXT_PUBLIC_API_URL
• NEXT_PUBLIC_APP_URL

Backend (Modal/Railway)

• SUPABASE_URL
• SUPABASE_SERVICE_ROLE_KEY
• REPLICATE_API_TOKEN
• ALLOWED_ORIGINS
• REDIS_URL (optional)

---

Post-Deployment

1. Test the Application

   • Sign up a test user
   • Generate a test video
   • Check credit deduction
   • Verify video download

2. Monitor

   • Set up Sentry for error tracking
   • Monitor Vercel analytics
   • Check Supabase usage

3. Scale

   • Adjust Vercel plan if needed
   • Scale Modal functions based on usage
   • Upgrade Supabase plan for production

---

Troubleshooting

Build Failures

• Check environment variables are set
• Verify all dependencies in package.json
• Check build logs for specific errors

API Errors

• Verify Supabase connection
• Check Replicate API token
• Review CORS settings

Database Issues

• Ensure migrations have run
• Check RLS policies
• Verify user permissions