Get your SaaS application up and running in minutes with this comprehensive setup guide. We'll walk you through everything from installation to your first user signup.
Before you begin, make sure you have the following installed on your system:
This project uses pnpm as the package manager and requires Node.js 18 or higher.
# Check your Node.js version
node --version
# Install pnpm if you don't have it
npm install -g pnpmYou'll need a PostgreSQL database. We recommend using Neon DB for its simplicity and performance.
For payment processing, you'll need a Stripe account:
💡 First time? Follow the detailed guides below for step-by-step instructions. This quick start assumes you have all prerequisites ready.
git clone <your-repository-url>
cd next-saas-boilerplate
pnpm install# Option 1: Use the interactive CLI tool (recommended)
pnpm init:env
# Option 2: Manual configuration
cp .env.example .env.local
# Edit .env.local with your actual valuespnpm db:push
pnpm db:seed⚠️ Database must be properly configured first! If you encounter UUID errors, see Database Setup Guide for required PostgreSQL extensions.
pnpm devYour app will be available at http://localhost:3000
Once setup is complete, your application will include:
The seed script creates demo data you can use immediately:
Super Admin: admin@example.com / password123
Regular User: user@example.com / password123
Demo Organization: "Acme Corp" with sample projects
pnpm dev # Start development server
pnpm db:studio # Open database GUI
pnpm db:reset-seed # Reset demo data🎉 Congratulations! Your SaaS application is now running. Here's what to explore next:
admin@example.com)🚀 Problems? Check logs in terminal or review the detailed installation guide for troubleshooting.