Skip to main content

Get Running in 5 Minutes

This is the fastest path to seeing KwikSaaS in action. You only need Supabase to start — Stripe and Resend can be added later.
TL;DR: Clone → Set 3 env vars → Run. That’s it.

Prerequisites

Node.js 18+

Check: node -v. Download if needed.

Supabase Account

Free tier works perfectly. Create account →

Step 1: Clone & Install

Takes about 1-2 minutes depending on your connection.

Step 2: Create Supabase Project

1

Create project

  1. Go to supabase.com/dashboard
  2. Click New Project
  3. Pick a name, set a password, choose a region
  4. Wait ~2 minutes for it to spin up
2

Copy your keys

Go to Settings → API and grab these 3 values:
3

Configure auth redirects

Go to Authentication → URL Configuration:
  • Site URL: http://localhost:3000
  • Redirect URLs: Add http://localhost:3000/auth/callback
4

Run database migration

Option A (Recommended):
Option B (Manual): Copy contents of supabase/migrations/*.sql and run in Supabase SQL Editor.

Step 3: Set Environment Variables

Open .env.local and fill in the 3 Supabase values you copied:
Stripe and Resend are optional. The app works without them — you just won’t have payments or custom emails yet.

Step 4: Run It!

Open http://localhost:3000 🎉

Verify It’s Working

You’re done! The app is running with full auth. Time to make it yours.

What’s Next?

What to Customize

See exactly which files to change (and which to leave alone)

Add Payments

Connect Stripe when you’re ready for billing

Full Quickstart

Complete setup with Stripe, Resend, and PostHog

Deploy

Push to production on Vercel