Run Locally in 5 Minutes

After downloading your copy of nextjs-and-supabase-boilerplate, you can have it running on your machine in just minutes. This boilerplate ships with authentication, multi-organization support, Paddle billing, and member management all pre-configured so you can focus on building your unique product.

Prerequisites

Before starting, make sure you have:

Node.js: v22.16.0 or higher (Download)
npm or Yarn: npm is included with Node.js; install Yarn via npm install -g yarn
Supabase Account — Sign up
Paddle Account (optional for billing) — Sign up
Docker (optional, for local Supabase) — Install Docker
Code Editor: VS Code recommended — Download

New to Next.js or Supabase? This guide is beginner-friendly and will walk you through each step.

Installation

1. Download and Open the Project

Purchase & download the boilerplate from YourEpicSaaS Orders.
Unzip the file.
Open it in your editor (VS Code recommended).

2. Install Dependencies From inside the project folder:

npm install

Make sure you're in the project root before running this command.

3. Set Up Supabase

Option 1: Local (Docker Required)

npm run db:start

Make sure Docker is running first.

Option 2: Cloud Supabase Follow the Supabase Setup Guide.

4. Configure Environment Variables

Copy .env.example to .env:

cp .env.example .env

APP_URL="http://localhost:3000"

SUPABASE_URL="http://127.0.0.1:54321"
SUPABASE_ANON_KEY="..."
SUPABASE_SERVICE_KEY="..."

RESEND_API_KEY="your-resend-api-key"
JWT_SECRET_KEY="your-secure-jwt-secret"

NEXT_PUBLIC_PADDLE_ENV="sandbox"
NEXT_PUBLIC_PADDLE_CLIENT_TOKEN="your-paddle-client-token"
PADDLE_API_KEY="your-paddle-api-key"
PADDLE_NOTIFICATION_WEBHOOK_SECRET="your-paddle-webhook-secret"

Never commit .env to Git. Check .gitignore to keep it private.

5. Run the Application

npm run dev

Then visit: http://localhost:3000

If the app loads, try creating an account to confirm authentication works.

Troubleshooting

Supabase Connection Failed

Check SUPABASE_URL and keys in Supabase → Project Settings → API.
For local: ensure Docker is running and npm run db:start finished without errors.

Paddle Billing Not Working

NEXT_PUBLIC_PADDLE_ENV should be "sandbox" for test mode.
Verify PADDLE_API_KEY and PADDLE_NOTIFICATION_WEBHOOK_SECRET in Paddle’s Developer Tools.

Resend Emails Not Sending

Verify your sender domain in Resend Dashboard.
Ensure RESEND_API_KEY is correct.

npm install Fails

Run npm cache clean --force then retry.
Check Node.js version: node -v should be ≥ 22.16.0.

Run Locally in 5 Minutes

On this page