Installation Guide

Get Started
in Minutes

Complete step-by-step installation guides for all FastSaaS packages. Follow along to get your project up and running.

SaaSForge

Complete SaaS starter kit with authentication, payments, and dashboard

Next.js 15 + TypeScript
NextAuth v5 Authentication
Prisma + PostgreSQL
Stripe/PayPal Integration
Admin Dashboard
Email System (Resend)
Dark Mode
Tailwind CSS

Prerequisites

  • Node.js 18+ installed
  • PostgreSQL database
  • Git installed
  • GitHub account (for repo access)
  • Stripe or PayPal account

1. Clone the Repository

After purchase, you'll receive access to the private GitHub repository.

# Clone the repository
git clone https://github.com/yourusername/saasforge.git
cd saasforge

2. Install Dependencies

Install all required npm packages.

# Using npm
npm install

# Or using pnpm (recommended)
pnpm install

# Or using yarn
yarn install

3. Set Up Environment Variables

Copy the example env file and configure your environment variables.

# Copy the example environment file
cp .env.example .env

# Open in your editor
code .env

4. Configure Database

Set up PostgreSQL and run migrations to create the database schema.

# Push schema to database
npx prisma db push

# Generate Prisma client
npx prisma generate

# (Optional) Seed with sample data
npx prisma db seed

5. Start Development Server

Run the development server and open in your browser.

# Start the dev server
npm run dev

# Open http://localhost:3000 in your browser

6. Create Admin User

Sign up through the UI or create an admin user via the seed script.

# Via Prisma Studio
npx prisma studio

# Then manually update the user role to ADMIN
# Or use the API to create an admin user

The first user to sign up can be promoted to admin via the database.

# PostgreSQL connection string
DATABASE_URL=postgresql://user:password@localhost:5432/saasforge
# Your application URL
NEXTAUTH_URL=http://localhost:3000
# Random secret for NextAuth (generate with openssl)
NEXTAUTH_SECRET=openssl rand -base64 32
# Stripe API secret key
STRIPE_SECRET_KEY=sk_test_...
# Stripe publishable key
STRIPE_PUBLISHABLE_KEY=pk_test_...
# Resend email API key
RESEND_API_KEY=re_...
# GitHub OAuth client ID (optional)
GITHUB_CLIENT_ID=Iv1...
# GitHub OAuth secret (optional)
GITHUB_CLIENT_SECRET=...

Post-Installation Steps

  • Configure your Stripe webhook endpoint at /api/webhooks/stripe
  • Set up your email domain in Resend dashboard
  • Customize branding in tailwind.config.ts
  • Update the landing page content in app/page.tsx
  • Configure pricing plans in lib/stripe.ts

Need help with installation?