create-supabase-saas 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# create-supabase-saas
+
+> Scaffold a production-ready Next.js + Supabase SaaS app in seconds.
+
+```bash
+npx create-supabase-saas my-app
+# or
+npm create supabase-saas my-app
+# or
+yarn create supabase-saas my-app
+# or
+pnpm create supabase-saas my-app
+```
+
+## What you get
+
+- **Auth** — Email/password + Google OAuth + forgot/reset password (`@supabase/ssr`)
+- **Multi-tenant orgs** — owner / admin / member / viewer roles with full RLS
+- **Stripe** — Checkout, Billing Portal, 4 webhook events
+- **Emails** — Welcome, invite, invoice (React Email + Resend)
+- **Notifications bell** — In-app notifications with unread badge
+- **API key management** — SHA-256 hashed, revocable
+- **Audit log** — Append-only with SECURITY DEFINER
+- **TypeScript strict** — `useUser`, `useSubscription`, `useOrg` hooks
+
+**65 files. Zero configuration to start.**
+
+## Quick start
+
+```bash
+npx create-supabase-saas my-saas
+
+cd my-saas
+
+# 1. Fill in your keys
+cp .env.example .env.local   # already done by the CLI
+# edit .env.local → NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, STRIPE_SECRET_KEY, RESEND_API_KEY
+
+# 2. Push DB migrations
+supabase db push
+
+# 3. Run
+npm run dev
+```
+
+## Template source
+
+[github.com/Edraid/nextjs-supabase-saas-starter](https://github.com/Edraid/nextjs-supabase-saas-starter)
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+
+import pc from 'picocolors';
+import prompts from 'prompts';
+import degit from 'degit';
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+
+const TEMPLATE_REPO = 'Edraid/nextjs-supabase-saas-starter';
+const REPO_URL = 'https://github.com/Edraid/nextjs-supabase-saas-starter';
+
+// ─── Banner ───────────────────────────────────────────────────────────────────
+
+console.log(`
+${pc.bold(pc.cyan('create-supabase-saas'))} ${pc.dim('v1.0.0')}
+
+  ${pc.green('▸')} Next.js 15 App Router
+  ${pc.green('▸')} Supabase Auth + Multi-tenant orgs
+  ${pc.green('▸')} Stripe Checkout + Billing Portal
+  ${pc.green('▸')} React Email + Resend
+  ${pc.green('▸')} TypeScript strict + full RLS
+`);
+
+// ─── Get project name from args or prompt ─────────────────────────────────────
+
+let projectName = process.argv[2];
+
+if (!projectName) {
+  const response = await prompts(
+    {
+      type: 'text',
+      name: 'projectName',
+      message: 'What is your project named?',
+      initial: 'my-saas-app',
+      validate: (v) =>
+        /^[a-z0-9-_]+$/.test(v) || 'Only lowercase letters, numbers, hyphens and underscores',
+    },
+    { onCancel: () => process.exit(0) }
+  );
+  projectName = response.projectName;
+}
+
+if (!projectName) process.exit(0);
+
+const targetDir = path.resolve(process.cwd(), projectName);
+
+// ─── Check target dir ─────────────────────────────────────────────────────────
+
+if (fs.existsSync(targetDir)) {
+  const { overwrite } = await prompts(
+    {
+      type: 'confirm',
+      name: 'overwrite',
+      message: `Directory ${pc.yellow(projectName)} already exists. Overwrite?`,
+      initial: false,
+    },
+    { onCancel: () => process.exit(0) }
+  );
+  if (!overwrite) {
+    console.log(pc.red('\nAborted.'));
+    process.exit(0);
+  }
+  fs.rmSync(targetDir, { recursive: true, force: true });
+}
+
+// ─── Package manager ──────────────────────────────────────────────────────────
+
+const { pkgManager } = await prompts(
+  {
+    type: 'select',
+    name: 'pkgManager',
+    message: 'Which package manager do you use?',
+    choices: [
+      { title: 'npm', value: 'npm' },
+      { title: 'pnpm', value: 'pnpm' },
+      { title: 'yarn', value: 'yarn' },
+      { title: 'bun', value: 'bun' },
+    ],
+    initial: 0,
+  },
+  { onCancel: () => process.exit(0) }
+);
+
+// ─── Clone template ───────────────────────────────────────────────────────────
+
+console.log(`\n${pc.cyan('◆')} Cloning template into ${pc.bold(projectName)}...`);
+
+try {
+  const emitter = degit(TEMPLATE_REPO, {
+    cache: false,
+    force: true,
+    verbose: false,
+  });
+
+  await emitter.clone(targetDir);
+} catch (err) {
+  console.error(pc.red(`\n✖ Failed to clone template: ${err.message}`));
+  console.error(pc.dim(`  You can manually clone: git clone ${REPO_URL} ${projectName}`));
+  process.exit(1);
+}
+
+// ─── Update package.json with project name ────────────────────────────────────
+
+const pkgPath = path.join(targetDir, 'package.json');
+if (fs.existsSync(pkgPath)) {
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+  pkg.name = projectName;
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+}
+
+// ─── Rename .env.example to .env.local ────────────────────────────────────────
+
+const envExample = path.join(targetDir, '.env.example');
+const envLocal   = path.join(targetDir, '.env.local');
+if (fs.existsSync(envExample) && !fs.existsSync(envLocal)) {
+  fs.copyFileSync(envExample, envLocal);
+}
+
+// ─── Install deps? ────────────────────────────────────────────────────────────
+
+const { install } = await prompts(
+  {
+    type: 'confirm',
+    name: 'install',
+    message: `Install dependencies with ${pc.bold(pkgManager)}?`,
+    initial: true,
+  },
+  { onCancel: () => process.exit(0) }
+);
+
+if (install) {
+  console.log(`\n${pc.cyan('◆')} Installing dependencies...\n`);
+  try {
+    const installCmd = pkgManager === 'yarn' ? 'yarn' : `${pkgManager} install`;
+    execSync(installCmd, { cwd: targetDir, stdio: 'inherit' });
+  } catch {
+    console.log(pc.yellow('\n⚠ Install failed — run it manually inside the project folder.\n'));
+  }
+}
+
+// ─── Success ──────────────────────────────────────────────────────────────────
+
+const cdCmd   = projectName === '.' ? '' : `  cd ${projectName}\n`;
+const runCmd  = pkgManager === 'npm' ? 'npm run dev' :
+                pkgManager === 'yarn' ? 'yarn dev' :
+                `${pkgManager} dev`;
+
+console.log(`
+${pc.green('✔')} ${pc.bold('Project created!')}
+
+${pc.bold('Next steps:')}
+
+${cdCmd}  1. Fill in ${pc.cyan('.env.local')} with your Supabase + Stripe + Resend keys
+  2. Run Supabase migrations:
+     ${pc.dim('supabase db push')}
+  3. Start the dev server:
+     ${pc.cyan(runCmd)}
+
+${pc.bold('Docs & config:')}
+  ${pc.dim('→')} ${pc.underline(REPO_URL)}
+  ${pc.dim('→')} CUSTOMIZATION.md  (theming, auth providers, Stripe plans)
+  ${pc.dim('→')} CHANGELOG.md      (what's new in v1.0.0)
+
+${pc.bold('Need the RLS-only pack?')}
+  ${pc.dim('→')} ${pc.underline('https://edraid-dev.lemonsqueezy.com')}
+
+${pc.dim('Happy building! ⚡')}
+`);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-supabase-saas",
+  "version": "1.0.0",
+  "description": "Create a Next.js + Supabase SaaS app with auth, multi-tenant orgs, Stripe, and emails in seconds",
+  "keywords": [
+    "nextjs",
+    "supabase",
+    "saas",
+    "starter",
+    "boilerplate",
+    "stripe",
+    "multi-tenant",
+    "create-app"
+  ],
+  "homepage": "https://github.com/Edraid/nextjs-supabase-saas-starter",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Edraid/create-supabase-saas.git"
+  },
+  "license": "MIT",
+  "author": "Edraid",
+  "type": "module",
+  "bin": {
+    "create-supabase-saas": "bin/index.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "dependencies": {
+    "degit": "^2.8.4",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}