Deployment Guide

Deploy your app to production with popular hosting platforms.

Pre-Deployment Checklist

Environment variables configured (.env)

Stripe webhooks configured for production (optional)

Auth0 application configured with production URLs (optional)

Neon database setup (optional)

Custom domain ready (optional)

Build command tested locally

Deploy to Vercel (Recommended)

Fast, global CDN with automatic deployments from Git

Option 1: Vercel CLI

# Install Vercel CLI

pnpm i -g vercel

# Deploy your app

vercel

# Follow the prompts to configure your deployment

Option 2: GitHub Integration

Push your code to GitHub
Go to vercel.com and sign up
Click "New Project" and import your GitHub repository
Configure environment variables in the Vercel dashboard
Deploy automatically on every Git push

Environment Variables

Add all your environment variables (STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY, POSTGRES_URL, AUTH0_DOMAIN, AUTH0_CLIENT_ID, AUTH0_CLIENT_SECRET, etc.) in the Vercel project settings before deploying.

Deploy to Netlify

Popular JAMstack platform with great developer experience

Automatic Git Deployments

Push your code to GitHub, GitLab, or Bitbucket
Go to netlify.com and sign up
Click "New site from Git" and connect your repository
Set build command: pnpm run build
Set publish directory: dist
Add environment variables in Site settings → Environment variables

Manual Deploy

# Build your app locally

pnpm run build

# Install Netlify CLI

pnpm install -g netlify-cli

# Deploy

netlify deploy --prod --dir=dist

Other Deployment Options

GitHub Pages

Free hosting for public repositories

Add gh-pages package and configure deployment workflow

Firebase Hosting

Google's hosting platform with global CDN

Use Firebase CLI: firebase deploy

DigitalOcean App Platform

Simple cloud hosting with automatic scaling

Connect GitHub repo and deploy with one click

Post-Deployment Configuration

Update Service URLs

Add your production URL to Auth0 allowed callback URLs
Update Stripe webhook endpoints with your production domain

Set Up Custom Domain (Optional)

Purchase domain from registrar (Vercel, Namecheap, GoDaddy, etc.)
Add custom domain in your hosting platform settings
Update DNS records to point to your hosting platform
Enable SSL certificate (usually automatic)

Monitor Your Application

Set up error tracking with Sentry or LogRocket
Monitor performance with your hosting platform's analytics
Set up uptime monitoring with UptimeRobot or Pingdom

Congratulations!

Your buildfast application is now live! Don't forget to test all functionality in production, including payments, authentication, and database operations.

Next Steps

Your buildfast app is deployed! Now focus on growing your business:

• Set up Google Analytics

• Add email marketing integration

• Set up customer support chat

• Set up customer feedback tools

• Monitor and optimize performance

Documentation