Deployment

This starter kit is vendor-free and can be deployed to any platform that supports Node.js and PostgreSQL.

Deployment Platforms

The starter kit works with any Node.js hosting platform:

Vercel

1. Connect your repository to Vercel
2. Set up environment variables in the Vercel dashboard
3. Vercel will automatically detect it's a Nuxt app and deploy

Netlify

1. Connect your repository to Netlify
2. Set build command: pnpm build
3. Set publish directory: apps/web/.output/public
4. Configure environment variables in Netlify

Railway

1. Create a new project in Railway
2. Connect your GitHub repository
3. Add a PostgreSQL database
4. Set environment variables
5. Railway will auto-deploy on git push

Any VPS (DigitalOcean, Linode, etc.)

1. Set up a server with Node.js installed
2. Clone your repository
3. Install dependencies with pnpm install
4. Build the application with pnpm build
5. Run migrations with pnpm db:migrate
6. Start the server with the generated output

Environment Variables

Ensure all required environment variables are set in your deployment platform:

• NUXT_PRIVATE_DATABASE_URL - PostgreSQL connection string
• BETTER_AUTH_SECRET - Secret for session encryption
• BETTER_AUTH_URL - Your production URL
• NUXT_PRIVATE_POLAR_ACCESS_TOKEN - For payments (if using Polar)
• NUXT_PRIVATE_POLAR_ORGANIZATION_ID - Your Polar org ID
• OAuth credentials (if using social login)

Database

Make sure your PostgreSQL database is accessible from your deployment platform. Most platforms offer:

• Managed PostgreSQL add-ons (recommended)
• Or connect to external PostgreSQL services like:
  • Neon
  • Supabase
  • Railway
  • Render

Build Command

The build command for the monorepo is:

pnpm build

This uses Turborepo to build all packages in the correct order.

Post-Deploy

After deployment, run the database migrations:

pnpm db:migrate

Most platforms support running commands after deployment or you can run this manually.