FrenoCorp/plans/FRE-4678-vercel-setup.md

Vercel Project Setup for AudiobookPipeline

Issue: FRE-4678

Overview

Create Vercel project for AudiobookPipeline web app and configure all required environment variables.

Environment Variables

Database (Turso)

• TURSO_DATABASE_URL - Turso database connection URL
• TURSO_AUTH_TOKEN - Turso authentication token

Authentication (Clerk)

• CLERK_SECRET_KEY - Clerk secret key for server-side operations
• VITE_CLERK_PUBLISHABLE_KEY - Clerk publishable key for client-side operations

Payments (Stripe)

• STRIPE_SECRET_KEY - Stripe secret key for server-side operations
• VITE_STRIPE_PUBLISHABLE_KEY - Stripe publishable key for client-side operations
• STRIPE_PRICE_ID_STANDARD - Stripe price ID for Standard tier
• STRIPE_PRICE_ID_UNLIMITED - Stripe price ID for Unlimited tier

Storage (S3)

• S3_ENDPOINT - S3 endpoint URL
• S3_ACCESS_KEY - S3 access key ID
• S3_SECRET_KEY - S3 secret access key
• S3_BUCKET - S3 bucket name

Application

• APP_URL - Application URL (Vercel deployment URL)

Build Configuration

vercel.json

{
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "devCommand": "npm run dev",
  "installCommand": "npm install",
  "framework": "vite",
  "regions": ["iad"]
}

Setup Steps

1. ✅ Create vercel.json with build configuration
2. ✅ Create .env.local with environment variable placeholders
3. ✅ Create scripts/setup.sh automation script
4. ⏳ Run setup script to create Vercel project
5. ⏳ Replace placeholder values with actual credentials
6. ⏳ Deploy and verify build completes successfully

Next Actions

• Run ./scripts/setup.sh to create the Vercel project
• Update .env.local with actual credential values
• Deploy to verify the configuration works

Notes

• The setup script handles Vercel CLI installation if not present
• Environment variables are set across all environments (production, development, preview)
• The Vite framework is configured for optimal build performance