Echo

Deploy to Vercel

Deploy your Echo application to Vercel with zero configuration

Prerequisites

Before you start

  • •A Vercel account (sign up at vercel.com)
  • •Your code pushed to GitHub, GitLab, or Bitbucket
  • •All environment variables configured (see Environment Setup)
1

Connect Repository

Import your project to Vercel

  1. Go to vercel.com/new
  2. Click Import Project
  3. Select your Git provider (GitHub, GitLab, or Bitbucket)
  4. Authorize Vercel to access your repositories
  5. Select the repository containing your Echo project
  6. Click Import
2

Configure Project

Set up build settings

Framework Preset

Vercel should auto-detect Next.js. Verify these settings:

  • •Framework Preset: Next.js
  • •Root Directory: ./
  • •Build Command: npm run build
  • •Output Directory: .next
3

Environment Variables

Configure your environment

Add all required environment variables. See Environment Setup for a complete list.

# Key environment variables:
NEXT_PUBLIC_APP_URL=https://yourdomain.com
SITE_URL=https://yourdomain.com
BETTER_AUTH_SECRET=your-secret-key
POSTGRES_URL=postgresql://...
# ... and more

Important:

Set environment variables for Production, Preview, and Development environments separately. Use different values for each environment (e.g., different database URLs, API keys).

4

Database Setup

Run migrations

After your first deployment, run database migrations:

# Option 1: Use Vercel CLI
vercel env pull .env.local
npm run db:push
# Option 2: Use Supabase Dashboard
# Run migrations via SQL editor
5

Deploy

Launch your application

Click Deploy and wait for the build to complete. Your application will be live at:

https://your-project.vercel.app

Branch Strategy

Multiple environments

Vercel automatically creates preview deployments for each branch. Configure branch deployments:

  • •Production: Deploy from master branch
  • •Preview: Automatic deployments from all other branches
  • •Development: Use local development with npm run dev
# Configure in Vercel Dashboard:
Settings → Git → Production Branch
Set to: master

Custom Domain

Use your own domain

Add a custom domain to your Vercel deployment:

  1. Go to your project settings in Vercel
  2. Navigate to Domains
  3. Add your domain (e.g., yourdomain.com)
  4. Follow DNS configuration instructions
  5. Update NEXT_PUBLIC_APP_URL and SITE_URL in environment variables

Next Steps

→ Environment Configuration→ Environment Variables