Supabase Full-Stack SaaS Template

September 30, 2025 ยท View on GitHub

A production-ready SaaS template built with Next.js 15, Supabase, and Tailwind CSS. This template provides everything you need to quickly launch your SaaS product, including authentication, user management, file storage, and more.

๐ŸŽ‰ NEW: Mobile App Now Available! Check out README_MOBILE.md for the complete React Native + Expo mobile app that shares the same Supabase backend! https://youtube.com/shorts/qcASa0Ywsy4?feature=share

๐Ÿ‡จ๐Ÿ‡ณ Chinese Documentation Available

ไธญๆ–‡ๆ–‡ๆกฃ | ็งปๅŠจ็ซฏไธญๆ–‡ๆ–‡ๆกฃ

This repository includes full documentation in Simplified Chinese:

  • README_ZH.md - Complete Chinese translation of the main documentation
  • README_MOBILE_ZH.md - Complete Chinese translation of the mobile app documentation

ๆœฌไป“ๅบ“ๅŒ…ๅซๅฎŒๆ•ด็š„็ฎ€ไฝ“ไธญๆ–‡ๆ–‡ๆกฃ๏ผš

  • README_ZH.md - ไธปๆ–‡ๆกฃ็š„ๅฎŒๆ•ดไธญๆ–‡็ฟป่ฏ‘
  • README_MOBILE_ZH.md - ็งปๅŠจๅบ”็”จๆ–‡ๆกฃ็š„ๅฎŒๆ•ดไธญๆ–‡็ฟป่ฏ‘

LIVE DEMO

Demo is here - https://basicsass.razikus.com

Self promo

Hey, don't be a code printer in AI era. Check my book

http://razikus.gumroad.com/l/dirtycode - live now!
https://www.amazon.com/dp/B0FNR716CF - live from 01.09
https://books.apple.com/us/book/dirty-code-but-works/id6751538660 - live from 01.09
https://play.google.com/store/books/details?id=5UWBEQAAQBAJ - live from 01.09

Deployment video

Video is here - https://www.youtube.com/watch?v=kzbXavLndmE

Migration from auth schema

According to this - https://github.com/Razikus/supabase-nextjs-template/issues/4

We are no longer able to modify auth schema. I modified original migrations to rename it to custom schema. If you need to migrate from older version - check supabase/migrations_for_old/20250525183944_auth_removal.sql

๐Ÿš€ Features

  • Authentication

    • Email/Password authentication
    • Multi-factor authentication (MFA) support
    • OAuth/SSO integration ready
    • Password reset and email verification

  • User Management

    • User profiles and settings
    • Secure password management
    • Session handling

  • File Management Demo (2FA ready)

    • Secure file upload and storage
    • File sharing capabilities
    • Drag-and-drop interface
    • Progress tracking

  • Task Management Demo (2FA ready)

    • CRUD operations example
    • Real-time updates
    • Filtering and sorting
    • Row-level security

  • Security

    • Row Level Security (RLS) policies
    • Secure file storage policies
    • Protected API routes
    • MFA implementation

  • UI/UX

    • Modern, responsive design
    • Dark mode support
    • Loading states
    • Error handling
    • Toast notifications
    • Confetti animations

  • Legal & Compliance

    • Privacy Policy template
    • Terms of Service template
    • Refund Policy template
    • GDPR-ready cookie consent

๐Ÿ› ๏ธ Tech Stack

  • Frontend

    • Next.js 15 (App Router)
    • React 19
    • Tailwind CSS
    • shadcn/ui components
    • Lucide icons

  • Backend

    • Supabase
    • PostgreSQL
    • Row Level Security
    • Storage Buckets

  • Authentication

    • Supabase Auth
    • MFA support
    • OAuth providers

๐Ÿ“ฆ Getting Started - local dev

  1. Fork or clone repository
  2. Prepare Supabase Project URL (Project URL from Project Settings -> API -> Project URL)
  3. Prepare Supabase Anon and Service Key (Anon Key, Service Key from Project Settings -> API -> anon public and service_role)
  4. Prepare Supabase Database Password (You can reset it inside Project Settings -> Database -> Database Password)
  5. If you already know your app url -> adjust supabase/config.toml site_url and additional_redirect_urls, you can do it later
  6. Run following commands (inside root of forked / downloaded repository):
# Login to supabase
npx supabase login
# Link project to supabase (require database password) - you will get selector prompt
npx supabase link

# Send config to the server - may require confirmation (y)
npx supabase config push

# Up migrations
npx supabase migrations up --linked
  1. Go to next/js folder and run yarn
  2. Copy .env.template to .env.local
  3. Adjust .env.local
NEXT_PUBLIC_SUPABASE_URL=https://APIURL
NEXT_PUBLIC_SUPABASE_ANON_KEY=ANONKEY
PRIVATE_SUPABASE_SERVICE_KEY=SERVICEROLEKEY
  1. Run yarn dev
  2. Go to http://localhost:3000 ๐ŸŽ‰

๐Ÿš€ Getting Started - deploy to vercel

  1. Fork or clone repository
  2. Create project in Vercel - choose your repo
  3. Paste content of .env.local into environment variables
  4. Click deploy
  5. Adjust in supabase/config.toml site_url and additional_redirect_urls (important in additional_redirect_urls is to have https://YOURURL/** - these 2 **)
  6. Done!

The template includes customizable legal documents - these are in markdown, so you can adjust them as you see fit:

  • Privacy Policy (/public/terms/privacy-notice.md)
  • Terms of Service (/public/terms/terms-of-service.md)
  • Refund Policy (/public/terms/refund-policy.md)

๐ŸŽจ Theming

The template includes several pre-built themes:

  • theme-sass (Default)
  • theme-blue
  • theme-purple
  • theme-green

Change the theme by updating the NEXT_PUBLIC_THEME environment variable.

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Need Multitenancy, Billing (Paddle) and Role Based Access Control?

I have paid template as well available here:

https://sasstemplate.razikus.com

Basically it's the same template but with Paddle + organisations API keys + multiple organisations + Role Based Access Control

For code GITHUB you can get -50% off

https://razikus.gumroad.com/l/supatemplate/GITHUB

๐Ÿ“ License

This project is licensed under the Apache License - see the LICENSE file for details.

๐Ÿ’ช Support

If you find this template helpful, please consider giving it a star โญ๏ธ

Or buy me a coffee!

My socials:

๐Ÿ™ Acknowledgments