Deployments

Learn how CupaDev handles deployments, from automatic Git integration to preview environments and production rollbacks.

Automatic Deployments

Every push to your Git repository triggers an automatic deployment. No manual intervention required.

Push to Deploy

Every commit pushed to your repository is automatically built and deployed. You'll receive a unique URL for each deployment.

Branch Deployments

Production branch (usually main or master) goes to your production domain. All other branches create preview deployments with unique URLs.

Production vs Preview Deployments

Production

Production Deployments

  • Triggered by main/master branch
  • Deploys to your custom domain
  • Visible to end users
  • Uses production environment variables
  • Optimized build and caching
Preview

Preview Deployments

  • Created for all other branches
  • Unique preview URL for each commit
  • Perfect for testing and reviews
  • Uses preview environment variables
  • Shareable with team members

Deployment Lifecycle

Every deployment goes through these stages:

1

Queued

Deployment is waiting for available build resources

2

Building

Installing dependencies and running build command

3

Uploading

Uploading build output to edge network

4

Ready

Deployment is live and accessible via URL

Error

Build failed - check logs for details

Instant Rollbacks

If something goes wrong, you can instantly rollback to any previous deployment.

How to Rollback

  1. Go to your project dashboard
  2. Navigate to the Deployments tab
  3. Find the deployment you want to restore
  4. Click "Promote to Production"
  5. Your site is instantly restored (usually under 10 seconds)

Note: Rollbacks are instant because the old deployment files are still available on our edge network. No rebuild required.

Environment-Specific Settings

Configure different settings for production and preview deployments.

SettingProductionPreview
Environment VariablesProduction valuesPreview/Development values
DomainCustom domaincupadev.app subdomain
AnalyticsFull tracking enabledOptional tracking
CachingAggressive cachingMinimal caching

Build Configuration

Customize how your application is built and deployed.

Build Command

The command that builds your application

npm run build

Output Directory

Where your built files are located

.next (Next.js) or dist (Vite/React)

Install Command

How to install your dependencies

npm install (or yarn, pnpm)

Deployment Hooks

Trigger actions when deployments succeed or fail.

Webhook URLs

Configure webhooks to receive notifications about deployment events:

  • • Deployment started
  • • Deployment succeeded
  • • Deployment failed
  • • Deployment promoted to production