create-swift-simplify-nextjs-supabase-starter

# 🚀 create-swift-simplify-nextjs-supabase-starter A powerful CLI tool to **instantly scaffold a modern, production-ready Next.js 15 + Supabase project** with a single command! 🎉 --- ## 🤔 Why Use This Starter Instead of Starting from Scratch? 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?** --- ## 📌 Features ✅ **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 --- ## 📥 Installation & Usage ### **1️⃣ Quick Start (Recommended)** You **don't need to install anything!** Simply run: ```sh npx create-swift-simplify-nextjs-supabase-starter@latest my-project ``` Or using pnpm: ```sh pnpm dlx create-swift-simplify-nextjs-supabase-starter@latest my-project ``` --- ### **2️⃣ Running Without a Project Name** If you don't provide a name, the CLI will prompt you: ```sh 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. --- ## 📦 What's Inside This Starter? This starter is not just a simple Next.js setup—it comes **fully loaded** with essential features to kickstart any serious project. ### **🚀 Technology Stack** | 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 | --- ## 🛠️ How It Works 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** --- ## 🛠️ Options & Features | 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 | --- ## 🔥 Why Use This Starter? ✅ **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!** --- ## 🛠️ Example Output ``` 🚀 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 ---------------------------------------- ``` --- ## 🙌 Support & Feedback 📢 Have feedback or found an issue? Open an issue on GitHub! 💻 **GitHub:** [@zidong0822](https://github.com/zidong0822)