{"id":48961344,"url":"https://github.com/indie-kit/nextjs-saas-starter","last_synced_at":"2026-04-18T02:01:14.219Z","repository":{"id":337375106,"uuid":"1153327236","full_name":"Indie-Kit/nextjs-saas-starter","owner":"Indie-Kit","description":"Open Source version of Indie Kit Pro to launch your SaaS in minutes","archived":false,"fork":false,"pushed_at":"2026-02-09T08:42:40.000Z","size":7281,"stargazers_count":21,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-12T15:19:29.819Z","etag":null,"topics":["ai","neondb","nextjs-boilerplate","nextjs-starter","postgres","saas-boilerplate","saas-template","starter-kit","supabase"],"latest_commit_sha":null,"homepage":"https://indiekit.pro/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Indie-Kit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-09T07:02:49.000Z","updated_at":"2026-02-16T15:23:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Indie-Kit/nextjs-saas-starter","commit_stats":null,"previous_names":["indie-kit/nextjs-saas-starter"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/Indie-Kit/nextjs-saas-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Indie-Kit%2Fnextjs-saas-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Indie-Kit%2Fnextjs-saas-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Indie-Kit%2Fnextjs-saas-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Indie-Kit%2Fnextjs-saas-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Indie-Kit","download_url":"https://codeload.github.com/Indie-Kit/nextjs-saas-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Indie-Kit%2Fnextjs-saas-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31953515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","neondb","nextjs-boilerplate","nextjs-starter","postgres","saas-boilerplate","saas-template","starter-kit","supabase"],"created_at":"2026-04-18T02:00:57.247Z","updated_at":"2026-04-18T02:01:14.210Z","avatar_url":"https://github.com/Indie-Kit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Indie Kit - The AI-Native Next.js Starter Kit\n\n![Indie Kit](public/hero.png)\n\n\u003cdiv align=\"center\"\u003e\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/Indie-Kit/nextjs-saas-starter)\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template?template=https://github.com/Indie-Kit/nextjs-saas-starter)\n\n[![Star on GitHub](https://img.shields.io/github/stars/Indie-Kit/nextjs-saas-starter?style=social)](https://github.com/Indie-Kit/nextjs-saas-starter/stargazers)\n[![Get Pro Version](https://img.shields.io/badge/Get%20Pro%20Version-Indie%20Kit-blue?style=for-the-badge)](https://indiekit.pro/?utm_source=github-starter\u0026utm_medium=readme\u0026utm_campaign=lite)\n[![Join Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://indiekit.pro/app/discord)\n\n\u003c/div\u003e\n\n# The AI-Native Next.js Starter Kit 🤖\n\n**Engineered for modern development. Optimized for AI.**\n\nThis is the **Open Source / Lite Version** of [Indie Kit Pro](https://indiekit.pro/?utm_source=github-starter\u0026utm_medium=readme\u0026utm_campaign=lite). It combines a production-grade tech stack with **\"AI Context Rules\"** that empower LLMs (Cursor, Windsurf, Copilot) to understand your codebase, write bug-free code, and navigate your project autonomously.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Next.js](https://img.shields.io/badge/Next.js-16-black?style=for-the-badge)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?style=for-the-badge)](https://www.typescriptlang.org/)\n\n## 🚀 Features\n\n### Core Stack - The Right Architecture\n\n- 🏗️ **Next.js 16** (App Router) - Staying ahead of the curve.\n- 🎨 **Tailwind CSS v4** + **Shadcn UI** - Beautiful, accessible UI.\n- 🔐 **Better Auth** (Social + Magic Link) - Secure and simple.\n- 🗄️ **Drizzle ORM** + **Bring Your Own Database** - Connect to **Supabase**, **Neon**, or any Postgres provider.\n- 💳 **Stripe** Subscription Webhooks - Ready for monetization.\n- 📁 **UploadThing** for file storage - Easy file uploads.\n- 🌙 **Dark Mode** built-in - Because developers love it.\n\n### Pre-built Pages\n\n- 🏠 **Landing Page** (Hero, Features, Pricing, FAQ)\n- 🔐 **Auth Pages** (Sign In, Sign Up)\n- ⚙️ **App Layout** (Header, User Profile)\n- 📄 **Legal Pages** (Privacy, Terms)\n\n## 🤖 AI-Optimized Architecture\n\nWe've structured the codebase to be easily understood by LLMs (Cursor, Windsurf, Copilot, Antigravity). This means fewer hallucinations and better code generation, regardless of which tool you use.\n\n- **Self-Documenting Code**: Your AI knows _exactly_ where auth lives (`.claude/skills/auth-handler`), how to migrate the DB (`.cursor/rules`), and where to put new components.\n- **No Hallucinations**: We force the AI to use existing patterns (like `withAuthRequired`) instead of inventing broken ones.\n- **One-Shot Prompts**: Paste a single command like `/bootstrap` and watch it scaffold your entire MVP plan.\n\n💡 **Pro Tip**: To use this kit with Google's Antigravity or other AI agents that expect a `.agent` folder, simply rename `.claude` to `.agent`:\n\n```bash\nmv .claude .agent\n```\n\n## 🛠️ Getting Started\n\n### ⚡️ Quick Start (Recommended)\n\nRun the following command to scaffold a new project interactively:\n\n```bash\nnpx indiekit@latest \n# or\npnpm dlx indiekit@latest\n# or\nyarn dlx indiekit@latest\n```\n\nThis CLI will:\n- 🚀 Scaffold the project instantly (no git history to remove).\n- 🛠️ Guide you through setup options.\n- 📦 Install dependencies automatically.\n\n### 🐢 Manual Setup\n\nIf you prefer to clone the repo manually:\n\n### 1. Clone \u0026 Install\n\n```bash\ngit clone https://github.com/Indie-Kit/nextjs-saas-starter.git my-saas\ncd my-saas\npnpm install\n```\n\n### 2. Environment Setup\n\nCopy the example environment file and fill in your secrets:\n\n```bash\ncp .env.example .env\n```\n\nYou will need:\n\n- **Database URL**: Use **Supabase**, **NeonDB**, or any PostgreSQL provider.\n- **Better Auth Secret**: Run `npx auth secret` to generate.\n- **Stripe Keys**: For payment processing.\n- **Social Keys**: (Google/GitHub, optional).\n\nAlso, update `src/lib/config.ts` with your project name, description, and legal details (email, address) which are used in the footer and legal pages.\n\n### 3. Database Setup\n\n```bash\n# Sync database schema to the database after adding new tables or modifying existing tables\npnpm run db:push\n```\n\n### 4. Run Development Server\n\n```bash\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) to see your app.\n\n## 🧠 The AI \"Brain\" (Exclusive)\n\nThis kit is designed to be \"read\" by LLMs. It includes:\n\n- **`.cursor/rules`**: Context-aware rules for Cursor to understand project structure.\n- **Prompt Library**: Pre-written prompts to generate features, DB schemas, and tests.\n- **Self-Correction**: Setup to help AI fix its own linting errors.\n- **Skills**: Specialized instructions for the AI to handle Auth, DB, and Payments correctly.\n\n## 💎 Indie Kit Pro vs Starter\n\nThis starter is perfect for learning and building simple MVPs. For serious production apps, check out **[Indie Kit Pro](https://indiekit.pro/?utm_source=github-starter\u0026utm_medium=readme\u0026utm_campaign=table)**.\n\n| Feature                         | Starter (Free) | Indie Kit Pro |\n| :------------------------------ | :------------: | :-----------: |\n| **Next.js 16 App Router**       |       ✅       |      ✅       |\n| **Better Auth**                 |       ✅       |      ✅       |\n| **Postgres + Drizzle**          |       ✅       |      ✅       |\n| **Stripe Subscriptions**        |     Basic      |     Full      |\n| **AI Navigation Rules**         |     Basic      |   Advanced    |\n| **Dodo Payments**               |       ❌       |      ✅       |\n| **Stripe Payments**             |       ❌       |      ✅       |\n| **Lemon Squeezy Payments**      |       ❌       |      ✅       |\n| **PayPal Payments**             |       ❌       |      ✅       |\n| **Multi-Tenancy (Teams/Orgs)**  |       ❌       |      ✅       |\n| **Role-Based Access Control**   |       ❌       |      ✅       |\n| **User Impersonation**          |       ❌       |      ✅       |\n| **Super Admin Dashboard**       |       ❌       |      ✅       |\n| **Credit System (Usage Based)** |       ❌       |      ✅       |\n| **Waitlist System**             |       ❌       |      ✅       |\n| **Blog \u0026 Docs (MDX)**           |       ❌       |      ✅       |\n| **Email Sequences (Inngest)**   |       ❌       |      ✅       |\n| **Documentation Site**          |       ❌       |      ✅       |\n| **Priority Support**            |       ❌       |      ✅       |\n\n**_Get 1-1 mentorship with CJ for free when you upgrade to Pro._**\n\n[**👉 Upgrade to Pro**](https://indiekit.pro/?utm_source=github-starter\u0026utm_medium=readme\u0026utm_campaign=upgrade)\n\n### See Pro in Action\n\n\u003ca href=\"https://www.youtube.com/watch?v=Nps1LFxy8A8\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.youtube.com/vi/Nps1LFxy8A8/maxresdefault.jpg\" width=\"600\" alt=\"Building SaaS with AI in minutes using Indie Kit\" /\u003e\n\u003c/a\u003e\n\n## 🤝 Community \u0026 Support\n\n- **[Free Discord Community](https://indiekit.pro/app/discord)**: Join our community of indie hackers to ask questions and share your progress!\n- **Twitter**: Follow [@cjsingg](https://x.com/cjsingg) for updates.\n- **Issues**: Open a GitHub issue for bugs in the starter.\n\n---\n\nBuilt with ❤️ by [CJ](https://x.com/cjsingg).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findie-kit%2Fnextjs-saas-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Findie-kit%2Fnextjs-saas-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findie-kit%2Fnextjs-saas-starter/lists"}