A powerful CLI tool to instantly scaffold a modern, production-ready Next.js 15 + Supabase project with a single command! 🎉
Setting up a Next.js 15 + Supabase project from scratch can be time-consuming and repetitive. Developers often spend hours configuring authentication, database setup, styling, and component libraries before even writing business logic.
This starter eliminates the setup hassle and provides a pre-configured, production-ready environment with stable versions, allowing you to focus on building features instead of boilerplate code.
🚀 Why waste hours configuring when you can start coding in minutes?
✅ Next.js 15 with App Router – Leverage the power of modern, server-driven architecture
✅ React 19 Ready – Optimized with the latest React features
✅ TypeScript by Default – Write safer, more maintainable code
✅ Supabase Integration – Pre-configured authentication, database, and storage
✅ Tailwind CSS – Fully styled with a scalable utility-based design system
✅ shadcn/ui – Beautiful pre-built UI components
✅ React Hook Form – Efficient and flexible form handling
✅ Git Initialization (Optional) – Quickly set up version control
✅ Automated Dependency Installation – No need to manually install packages
✅ Environment Variables Included – .env.example setup for easy configuration
✅ Scalable & Production-Ready – Best practices implemented out of the box
You don't need to install anything! Simply run:
npx create-swift-simplify-nextjs-supabase-starter@latest my-projectOr using pnpm:
pnpm dlx create-swift-simplify-nextjs-supabase-starter@latest my-projectIf you don't provide a name, the CLI will prompt you:
npx create-swift-simplify-nextjs-supabase-starter@latest👉 If you press Enter without a name, it will use "swift-simplify-nextjs-supabase-starter" by default.
This starter is not just a simple Next.js setup—it comes fully loaded with essential features to kickstart any serious project.
| Technology | Purpose |
|---|---|
| Next.js 15 (App Router) | Optimized for performance and scalability with modern server components and dynamic routing |
| React 19 | Utilizes the latest features for efficient rendering and state management |
| React Query | Utilizes the best practices for efficient fetching, mutating and client side state management |
| TypeScript | Provides strong typing for better maintainability and developer experience |
| Supabase | Includes authentication, database, and storage setup using supabase
|
| Tailwind CSS | A utility-first CSS framework for quick and scalable styling |
| shadcn/ui | Pre-built, accessible UI components styled with Tailwind |
| React Hook Form | Lightweight and powerful form handling with built-in validation |
| pnpm | Efficient package manager with workspaces support |
| ESLint & Prettier | Code formatting and linting pre-configured |
| Environment Variables | Pre-configured .env.example for easy API setup |
1️⃣ Clones the Next.js + Supabase starter template
2️⃣ Installs all dependencies automatically (pnpm install)
3️⃣ Asks if you want to initialize Git (git init)
4️⃣ Sets up a pre-configured project with:
- Supabase authentication
- Tailwind CSS & shadcn/ui
- React Hook Form for forms
- Next.js 15 (App Router)
- TypeScript for type safety
5️⃣ Displays a success message with your next steps
| Feature | Description |
|---|---|
| Project Name | If not provided, CLI will prompt for one. Default: "swift-simplify-nextjs-supabase-starter"
|
| Git Setup | Asks if you want to initialize a Git repository |
| Automatic Installs | Installs all dependencies using pnpm install
|
| Pre-configured Supabase | Ready to use with supabase-js for auth, database, and storage |
| React Query | Pre-configured React Query providers with custom hooks (fetch, mutate) |
| Auth Query Wrapper | Auth Context mixed between supabase functions with react query providers ensures fresh user session |
| Tailwind & shadcn/ui | Built-in styling and UI components, ready to use |
| React Hook Form | Form handling setup with built-in validation |
✅ No More Boilerplate Setup – Everything is pre-configured for you
✅ Focus on Building, Not Configuring – Get started instantly with Next.js 15, Supabase, and Tailwind
✅ Best Practices Included – The latest web development trends and best practices are built-in
✅ Save Time & Effort – Stop wasting hours setting up the same things repeatedly
✅ Built-Ins – Built-in auth system and that's always was a little hard for beginners with react query and supabase
💡 With this starter, you can start writing actual business logic from Day 1!
🚀 Create Next.js + Supabase Project
Enter your project name (or press enter to use default): my-app
📦 Setting up my-app...
✅ Starter project cloned successfully!
📦 Installing dependencies...
🚀 Setup complete! Run the following to start your project:
cd my-app
pnpm dev
----------------------------------------
🎉 Created by zidong0822 🚀
💻 GitHub: https://github.com/zidong0822
----------------------------------------
📢 Have feedback or found an issue? Open an issue on GitHub!
💻 GitHub: @zidong0822