Introduction to the Next.js Supabase SaaS Starter Kit

A production-ready Next.js 16 and Supabase SaaS starter kit with authentication, billing, teams, and admin dashboard built on React 19 and Tailwind CSS 4.

The Next.js Supabase SaaS Kit is a production-ready starter for building multi-tenant SaaS applications. It ships with authentication, team management, subscription billing, and an admin dashboard out of the box.

Built on Next.js 16, React 19, Supabase, and Tailwind CSS 4, this Turborepo monorepo gives you a solid foundation to launch faster without sacrificing code quality or flexibility.

What You Get

Authentication and Security

  • Email/password and OAuth sign-in (Google, GitHub, etc.)
  • Magic link authentication
  • Multi-factor authentication (TOTP)
  • Password reset and email verification
  • Session management with Supabase Auth

Multi-Tenant Account System

  • Personal accounts: Every user has a personal workspace
  • Team accounts: Create organizations with multiple members
  • Role-based access: Owner, Admin, Member roles with customizable permissions
  • Invitations: Invite users via email with role assignment
  • RLS enforcement: Row Level Security policies protect data at the database level

Subscription Billing

  • Stripe and Lemon Squeezy integrations
  • Subscription models: flat-rate, tiered, per-seat pricing
  • Customer portal for self-service management
  • Webhook handling for subscription lifecycle events
  • Support for both personal and team billing

Admin Dashboard

  • User management (view, impersonate, ban)
  • Subscription overview and management
  • Analytics and metrics dashboard
  • Super admin role with MFA requirement

Developer Experience

  • Turborepo monorepo with shared packages
  • TypeScript throughout with strict mode
  • Shadcn UI components (Radix-based)
  • React Query for client-side data fetching
  • Zod for runtime validation
  • i18n with multiple language support
  • Keystatic or WordPress CMS integration
  • Sentry and Baselime monitoring support
  • Pre-configured LLM rules for Cursor, Claude Code, and Windsurf

Monorepo Architecture

The kit separates concerns into reusable packages:

apps/
  web/              # Main Next.js application
  e2e/              # Playwright end-to-end tests
packages/
  features/         # Feature modules (auth, accounts, admin, etc.)
  ui/               # Shared UI components (@kit/ui)
  supabase/         # Supabase client and types (@kit/supabase)
  billing/          # Billing logic and gateway (@kit/billing)
  mailers/          # Email providers (@kit/mailers)
  i18n/             # Internationalization (@kit/i18n)
  monitoring/       # Error tracking (@kit/monitoring)
  analytics/        # User analytics (@kit/analytics)

This structure lets you modify features without touching core packages, and makes it straightforward to add new applications that share the same backend logic.

Prerequisites

Before diving in, you should be comfortable with:

  • Next.js App Router: Server Components, Server Actions, route handlers
  • Supabase: PostgreSQL, Row Level Security, Auth
  • React: Hooks, TypeScript, component patterns

The kit builds on these technologies rather than teaching them. If you're new to Supabase or the App Router, spend time with their official docs first.

Documentation Scope

This documentation covers kit-specific configuration, patterns, and customization. For underlying technology details:

Next Steps

  1. Check the technical details to understand the full stack
  2. Clone the repository and set up your environment
  3. Run the project locally to explore the features