@superbuilds/create-supersaas-app 2.0.0 → 2.0.1

package/README.md

@@ -2,138 +2,113 @@
 
 > Scaffold production-ready SaaS apps in seconds
 
-The fastest way to get your indie SaaS off the ground. Built for serious builders who ship.
+The fastest way to get your indie SaaS off the ground. One command, full source code, ready to ship.
 
 ## Quick Start
 
 ```bash
-npx create-supersaas-app my-saas --key YOUR_LICENSE_KEY
+npx create-supersaas-app my-saas
 cd my-saas
-npm run dev
+pnpm dev
+# Open http://localhost:3000/setup to configure
 ```
 
 ## What You Get
 
-- **Next.js 15** + React 19 + TypeScript
-- **Authentication** (Better Auth) - email, OAuth, magic links
-- **Payments** (Stripe) - subscriptions, one-time, webhooks
-- **Database** (Drizzle ORM) - type-safe, migrations included
-- **Email** (Resend) - transactional + newsletter
-- **Teams** - multi-tenant with invites
-- **Admin Dashboard** - user management, analytics
-- **Beautiful UI** - Tailwind CSS v4, dark mode, responsive
-- **API Routes** - rate limiting, validation, error handling
+- **Next.js 15** App Router + React 19 + TypeScript (strict mode)
+- **Authentication** — Better Auth: email/password, magic links, 2FA, Google/GitHub/Twitter OAuth
+- **4 Payment Providers** — Stripe, Polar, LemonSqueezy, DodoPayments (switch with one env var)
+- **5 Email Providers** — Resend, Postmark, SendGrid, Mailgun, Nodemailer/SMTP
+- **Database** — Drizzle ORM on PostgreSQL (Neon, Supabase, or local Docker)
+- **Teams** — multi-tenant orgs with invites, owner/admin/member roles
+- **Admin Dashboard** — user management, analytics, subscriptions, leads, feature flags
+- **13 Themes** — complete UI vibes, switch with one line in globals.css
+- **Blog + Changelog** — MDX with syntax highlighting, RSS, reading time
+- **Rate Limiting** — Upstash Redis middleware
+- **i18n** — locale detection, server + client translations
+- **Setup Wizard** — browser-based `/setup` generates your .env in 2 minutes
+- **AI-Ready** — ships with CLAUDE.md + AGENTS.md for Claude Code, Cursor, Copilot, Windsurf
 
 ## Usage
 
-### Interactive Mode (Recommended)
+### Interactive Mode
 
 ```bash
 npx create-supersaas-app
 ```
 
 You'll be prompted for:
-- App name
-- Database provider (Neon, Supabase, PlanetScale, SQLite)
-- Optional features (blog, AI routes, admin, waitlist)
+1. License key (from your purchase email)
+2. App name
+3. Database provider (Neon, Supabase, or local Docker Postgres)
+4. Optional features (blog, admin dashboard)
+5. Install dependencies (yes/no)
 
 ### Non-Interactive Mode
 
-Perfect for CI/CD or automation:
+For CI/CD, automation, or AI agents:
 
 ```bash
 npx create-supersaas-app my-saas \
   --key YOUR_LICENSE_KEY \
   --db neon \
-  --features blog,ai,admin \
+  --features blog,admin \
+  --install \
   --yes
 ```
 
-## Options
+### Dev Mode
 
-| Flag | Description | Example |
-|------|-------------|---------|
-| `--key` | License key (required) | `--key lic_abc123` |
-| `--db` | Database provider | `--db neon` |
-| `--features` | Comma-separated features | `--features blog,ai` |
-| `--yes` | Skip prompts, use defaults | `--yes` |
+For local development without a license:
 
-## Features
-
-### Core (All Tiers)
-
-- Authentication (email + OAuth)
-- Database with migrations
-- Payment processing
-- Email delivery
-- Team management
-- API routes
-
-### Pro Tier
-
-- AI routes (OpenAI/Anthropic)
-- Admin dashboard
-- Advanced themes
-- Priority support
-
-### Bundle Tier
+```bash
+npx create-supersaas-app my-saas --key dev
+```
 
-- Everything in Pro
-- Lifetime updates
-- Team licenses
-- Early access to new features
+## CLI Options
 
-## Database Options
+| Flag | Description | Values |
+|------|-------------|--------|
+| `--key <key>` | License key | Your key from purchase email |
+| `--db <provider>` | Database provider | `neon`, `supabase`, `local` |
+| `--features <list>` | Optional features | `blog`, `admin` (comma-separated) |
+| `--install` | Install dependencies after scaffolding | — |
+| `--no-git` | Skip git repository initialization | — |
+| `--yes` / `--defaults` | Skip prompts, use defaults | — |
 
-- **Neon** (Postgres) - Recommended, generous free tier
-- **Supabase** (Postgres) - Auth + DB + Storage
-- **PlanetScale** (MySQL) - Serverless MySQL
-- **SQLite** - Local development
+## Deactivate License
 
-## After Installation
+Free up a machine activation slot:
 
 ```bash
-cd your-app
-
-# 1. Set up environment variables
-cp .env.example .env.local
-# Edit .env.local with your keys
-
-# 2. Run migrations
-npm run db:push
-
-# 3. Start dev server
-npm run dev
+npx create-supersaas-app deactivate
 ```
 
-Visit `http://localhost:3000`
-
-## CLI Commands (built-in)
-
-Once your app is created, use the built-in CLI from your project directory:
+## After Scaffolding
 
 ```bash
-npx supersaas setup stripe
-npx supersaas add blog
-npx supersaas deploy
+cd my-saas
+pnpm dev   # deps already installed if you said yes during setup
+# Open http://localhost:3000/setup — the setup wizard walks you through everything
 ```
 
-## License
-
-You need a valid supersaas-kit license to use this. Get yours at [supersaas-kit.superbuilds.fun](https://supersaas-kit.superbuilds.fun)
+The setup wizard configures:
+- Database connection
+- Auth secrets
+- Payment provider
+- Email provider
+- App identity
 
-## Support
+After setup, manage runtime config at `/admin/settings`.
 
-- **Docs:** https://supersaas-kit.superbuilds.fun/docs
-- **Issues:** https://github.com/bixblues/supersaas-kit/issues
-- **Email:** hi@superbuilds.fun
+## License
 
-## What's Next?
+Requires a valid SuperSaaS Kit license. One purchase ($129), unlimited projects, 3 machine activations.
 
-1. Read the docs: https://supersaas-kit.superbuilds.fun/docs
-2. Join Discord: https://supersaas-kit.superbuilds.fun/discord
-3. Follow updates: https://x.com/superbuilds
+Get yours at [supersaas-kit.superbuilds.fun](https://supersaas-kit.superbuilds.fun)
 
----
+## Support
 
-Built with ❤️ by indie hackers, for indie hackers.
+- **Docs:** [supersaas-kit.superbuilds.fun/docs](https://supersaas-kit.superbuilds.fun/docs)
+- **Discord:** [discord.gg/bM3w3RZYYH](https://discord.gg/bM3w3RZYYH)
+- **Email:** hi@superbuilds.fun

package/dist/index.js

@@ -47,7 +47,7 @@ async function downloadTemplate(licenseKey, targetDir) {
       const msg = errorBody.error || `HTTP ${res.status}`;
       p3.log.error(chalk.red(msg));
       if (res.status === 403) {
-        p3.log.info(chalk.dim("Your license may not include this tier. Check https://supersaas-kit.superbuilds.fun"));
+        p3.log.info(chalk.dim("Your license may be invalid. Check https://supersaas-kit.superbuilds.fun"));
       }
       if (res.status === 429) {
         p3.log.info(chalk.dim("Too many downloads. Wait an hour and try again."));
@@ -61,9 +61,22 @@ async function downloadTemplate(licenseKey, targetDir) {
     await fs.writeFile(archivePath, Buffer.from(arrayBuffer));
     spinner.text = "Extracting template...";
     await fs.ensureDir(targetDir);
-    execSync(`tar -xzf "${archivePath}" -C "${targetDir}"`, {
-      stdio: "pipe"
-    });
+    try {
+      execSync(`tar -xzf "${archivePath}" -C "${targetDir}"`, {
+        stdio: "pipe"
+      });
+    } catch (tarErr) {
+      spinner.fail(chalk.red("Extraction failed"));
+      const isWindows = process.platform === "win32";
+      if (isWindows) {
+        p3.log.error(chalk.red("tar is not available on this system."));
+        p3.log.info(chalk.dim("Install tar via Windows Build Tools, or use WSL."));
+      } else {
+        p3.log.error(chalk.red(`tar extraction failed: ${tarErr.message}`));
+      }
+      await fs.remove(tmpDir);
+      return false;
+    }
     await fs.remove(tmpDir);
     spinner.succeed(chalk.green("Template downloaded and extracted"));
     return true;
@@ -86,6 +99,9 @@ async function createApp(config) {
   }
   const downloaded = await downloadTemplate(config.licenseKey, targetDir);
   if (!downloaded) {
+    if (await fs.pathExists(targetDir)) {
+      await fs.remove(targetDir);
+    }
     process.exit(1);
   }
   const excludePaths = /* @__PURE__ */ new Set();
@@ -112,11 +128,49 @@ async function createApp(config) {
   const envExample = path.join(targetDir, ".env.example");
   if (await fs.pathExists(envExample)) {
     await fs.copy(envExample, path.join(targetDir, ".env"));
+    p3.log.info(chalk.dim("Created .env from template \u2014 configure via /setup after first run"));
   }
   await cleanupFeatureImports(targetDir, config);
   const activeFeatures = ["auth", "payments", "email", "seo", ...config.features];
   p3.log.info(chalk.dim(`Database: ${config.database}`));
   p3.log.info(chalk.dim(`Features: ${activeFeatures.join(", ")}`));
+  if (config.install) {
+    const pm = detectPackageManager();
+    const spinner = ora(`Installing dependencies with ${pm}...`).start();
+    try {
+      execSync(`${pm} install`, { cwd: targetDir, stdio: "pipe" });
+      spinner.succeed(chalk.green("Dependencies installed"));
+    } catch {
+      spinner.fail(chalk.yellow("Install failed \u2014 run it manually after setup"));
+    }
+  }
+  if (!config.skipGit && hasGit()) {
+    try {
+      execSync("git init", { cwd: targetDir, stdio: "pipe" });
+      execSync("git add -A", { cwd: targetDir, stdio: "pipe" });
+      execSync('git commit -m "Initial commit from create-supersaas-app"', {
+        cwd: targetDir,
+        stdio: "pipe"
+      });
+      p3.log.info(chalk.dim("Initialized git repository"));
+    } catch {
+    }
+  }
+}
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  if (userAgent.startsWith("bun")) return "bun";
+  return "pnpm";
+}
+function hasGit() {
+  try {
+    execSync("git --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
 }
 async function configureDatabase(targetDir, config) {
   const dbConfig = DATABASE_CONFIGS[config.database];
@@ -131,14 +185,6 @@ DATABASE_URL=`);
       await fs.writeFile(envPath, content);
     }
   }
-  if (config.database === "local") {
-    const envPath2 = path.join(targetDir, ".env.example");
-    if (await fs.pathExists(envPath2)) {
-      let content = await fs.readFile(envPath2, "utf-8");
-      if (content.includes("DATABASE_URL=postgres://postgres:postgres@localhost:5432/app")) ;
-      await fs.writeFile(envPath2, content);
-    }
-  }
 }
 async function updateManifest(targetDir, config) {
   const manifestPath = path.join(targetDir, ".supersaas", "manifest.json");
@@ -146,7 +192,6 @@ async function updateManifest(targetDir, config) {
     const manifest = await fs.readJson(manifestPath);
     manifest.database = config.database;
     manifest.features = config.features;
-    manifest.tier = config.tier;
     manifest.createdAt = (/* @__PURE__ */ new Date()).toISOString();
     if (manifest.providers) {
       if (manifest.providers.db) manifest.providers.db = "postgres";
@@ -184,7 +229,7 @@ export default function sitemap(): MetadataRoute.Sitemap {
     const sidebarPath = path.join(targetDir, "src/components/layout/sidebar.tsx");
     if (await fs.pathExists(sidebarPath)) {
       let content = await fs.readFile(sidebarPath, "utf-8");
-      content = content.replace(/\s*\{\s*label:\s*["']Admin["'].*?\},?\n?/gs, "");
+      content = content.replace(/\s*\{\s*name:\s*["']Admin["'].*?\},?\n?/gs, "");
       await fs.writeFile(sidebarPath, content);
     }
   }
@@ -237,14 +282,11 @@ async function getAllFiles(dir) {
 var SUPERSAAS_DIR = path.join(os2.homedir(), ".supersaas");
 var LICENSE_PATH = path.join(SUPERSAAS_DIR, "license.json");
 var DODO_BASE_URL = process.env.SUPERSAAS_DODO_URL || "https://test.dodopayments.com";
-function inferTierFromActivation(_data) {
-  return "bundle";
-}
 async function loadLocalLicense() {
   try {
     if (await fs.pathExists(LICENSE_PATH)) {
       const data = await fs.readJson(LICENSE_PATH);
-      if (data.key && data.tier && data.instance_id) {
+      if (data.key && data.instance_id) {
         return data;
       }
     }
@@ -291,10 +333,8 @@ async function activateOnline(key) {
       return null;
     }
     const result = await res.json();
-    const tier = inferTierFromActivation(result);
     const license = {
       key,
-      tier,
       instance_id: result.id || result.license_key_instance_id || "",
       activated_at: (/* @__PURE__ */ new Date()).toISOString(),
       valid: true
@@ -315,14 +355,14 @@ async function activate(keyArg, nonInteractive) {
     const check = await validateKey(existing.key).catch(() => ({ valid: true }));
     if (check.valid) {
       p3.log.success(
-        chalk.dim(
-          `Licensed (${existing.tier}) - ${existing.key.slice(0, 12)}...`
-        )
+        chalk.dim(`Licensed \u2014 ${existing.key.slice(0, 12)}...`)
       );
       return existing;
     }
     await fs.remove(LICENSE_PATH);
-    p3.log.warning(chalk.yellow("License expired or revoked. Please re-activate."));
+    if (!nonInteractive) {
+      p3.log.warning(chalk.yellow("License expired or revoked. Please re-activate."));
+    }
   }
   if (!keyArg && nonInteractive) {
     return null;
@@ -339,18 +379,51 @@ async function activate(keyArg, nonInteractive) {
   p3.log.step("Activating license...");
   const license = await activateOnline(key);
   if (license) {
-    p3.log.success(chalk.green(`Activated! Tier: ${license.tier}`));
+    p3.log.success(chalk.green("License activated!"));
     return license;
   }
   return null;
 }
+async function deactivate() {
+  const existing = await loadLocalLicense();
+  if (!existing) {
+    p3.log.warning(chalk.yellow("No active license found on this machine."));
+    return false;
+  }
+  try {
+    const res = await fetch(`${DODO_BASE_URL}/licenses/deactivate`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        license_key: existing.key,
+        license_key_instance_id: existing.instance_id
+      })
+    });
+    if (res.ok) {
+      await fs.remove(LICENSE_PATH);
+      p3.log.success(chalk.green("License deactivated. Machine slot freed."));
+      return true;
+    }
+    const body = await res.json().catch(() => ({}));
+    p3.log.error(chalk.red(`Deactivation failed: ${body.message || "Unknown error"}`));
+    return false;
+  } catch {
+    p3.log.error(chalk.red("Could not reach license server."));
+    return false;
+  }
+}
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var VALID_DBS = ["neon", "supabase", "local"];
 var VALID_FEATURES = ["blog", "admin"];
-program.name("create-supersaas-app").description("Scaffold production-ready SaaS apps in seconds").version(version).argument("[name]", "Name of your app").option("--key <license-key>", "License key for activation").option("--defaults", "Skip prompts, use default settings (for agents)").option("--yes", "Alias for --defaults (non-interactive mode)").option("--db <provider>", "Database provider (neon|supabase|local)").option("--features <list>", "Comma-separated features (blog,admin)").action(async (name, options) => {
+program.name("create-supersaas-app").description("Scaffold production-ready SaaS apps in seconds").version(version).argument("[name]", "Name of your app").option("--key <license-key>", "License key for activation").option("--defaults", "Skip prompts, use default settings (for agents)").option("--yes", "Alias for --defaults (non-interactive mode)").option("--db <provider>", "Database provider (neon|supabase|local)").option("--features <list>", "Comma-separated features (blog,admin)").option("--install", "Install dependencies after scaffolding").option("--no-git", "Skip git repository initialization").action(async (name, options) => {
   const nonInteractive = options.defaults || options.yes || !process.stdin.isTTY;
-  if (!nonInteractive) p3.intro(chalk.bold("supersaas-kit"));
+  if (!nonInteractive) {
+    p3.intro(
+      `${chalk.bold("supersaas-kit")} ${chalk.dim(`v${version}`)}
+` + chalk.dim("  Production-ready SaaS in one command")
+    );
+  }
   let licenseResult = await activate(options.key, nonInteractive);
   if (!licenseResult) {
     if (!nonInteractive) p3.cancel("License activation failed.");
@@ -418,8 +491,8 @@ program.name("create-supersaas-app").description("Scaffold production-ready SaaS
     features = await p3.multiselect({
       message: "Include optional modules?",
       options: [
-        { value: "blog", label: "Blog (MDX)", hint: "SEO boost" },
-        { value: "admin", label: "Admin Dashboard", hint: "Pro" }
+        { value: "blog", label: "Blog (MDX)", hint: "SEO-ready with RSS feed" },
+        { value: "admin", label: "Admin Dashboard", hint: "user management, analytics" }
       ],
       required: false
     });
@@ -428,19 +501,62 @@ program.name("create-supersaas-app").description("Scaffold production-ready SaaS
       process.exit(0);
     }
   }
+  let shouldInstall = options.install || false;
+  if (!nonInteractive && !options.install) {
+    shouldInstall = await p3.confirm({
+      message: "Install dependencies?",
+      initialValue: true
+    });
+    if (p3.isCancel(shouldInstall)) {
+      p3.cancel("Cancelled.");
+      process.exit(0);
+    }
+  }
   await createApp({
     name: appName,
     database: dbChoice,
     features: features || [],
-    tier: licenseResult.tier,
-    licenseKey: licenseResult.key
+    licenseKey: licenseResult.key,
+    install: shouldInstall,
+    skipGit: options.git === false
   });
   if (!nonInteractive) {
-    p3.outro(
-      chalk.green("Done!") + ` Run ${chalk.cyan(`cd ${appName} && npm install && npm run dev`)} to start.`
+    const steps = [
+      chalk.green("Your app is ready!"),
+      "",
+      `  ${chalk.cyan("cd")} ${appName}`
+    ];
+    if (!shouldInstall) {
+      steps.push(`  ${chalk.cyan("pnpm install")}`);
+    }
+    steps.push(
+      `  ${chalk.cyan("pnpm dev")}`,
+      "",
+      chalk.dim("  Then visit /setup to configure your services."),
+      chalk.dim("  Docs: https://supersaas-kit.superbuilds.fun/docs")
     );
+    p3.outro(steps.join("\n"));
   } else {
-    console.log(`\u2714 Created ${appName}. Run: cd ${appName} && npm install && npm run dev`);
+    const installCmd = shouldInstall ? "" : "pnpm install && ";
+    console.log(`\u2714 Created ${appName}. Run: cd ${appName} && ${installCmd}pnpm dev`);
+  }
+});
+program.command("deactivate").description("Deactivate your license on this machine (frees a machine slot)").action(async () => {
+  p3.intro(chalk.bold("supersaas-kit \u2014 deactivate"));
+  const confirmed = await p3.confirm({
+    message: "This will free one of your 3 machine activation slots. Continue?",
+    initialValue: false
+  });
+  if (p3.isCancel(confirmed) || !confirmed) {
+    p3.outro(chalk.dim("Deactivation cancelled."));
+    return;
+  }
+  const success = await deactivate();
+  if (success) {
+    p3.outro(chalk.green("License deactivated. You can activate on another machine now."));
+  } else {
+    p3.outro(chalk.red("Deactivation failed. Run again or contact hi@superbuilds.fun"));
+    process.exit(1);
   }
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superbuilds/create-supersaas-app",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Scaffold production-ready SaaS apps in seconds — SuperSaaS Kit CLI",
   "author": "superbuilds",
   "license": "MIT",