create-esa-stack 0.1.13 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-02-07
+
+### Added
+- **Backend Selection**: Introduced a primary choice between different backend technologies.
+- **Jazz.tools**: Added support for Jazz.tools (local-first sync and auth).
+- **Bundled Email Tools**: Combined Resend and React Email into a single "Email" option for a smoother setup.
+
+### Changed
+- **Supabase**: Now part of the Backend Selection prompt instead of being a simple optional package.
+
+
 ## [0.1.13] - 2026-02-06
 
 ### Added

package/README.md

@@ -23,9 +23,10 @@ During setup, you can interactively choose to add:
 - 🎨 **shadcn/ui** - Beautiful, accessible, copy-paste components.
 - 📡 **TanStack Query** - Powerful asynchronous state management.
 - 🚦 **@next/third-parties** - Optimized loading for third-party scripts.
-- 📧 **Resend** - The best API for sending emails.
-- ✉️ **React Email** - Build emails using React components.
-- ⚡ **Supabase** - Open Source Firebase alternative (Auth, DB, Realtime).
+- 📧 **Email (Resend + React Email)** - Transactional emails with React components.
+- 📦 **Backend Choice** - Choose your primary backend infrastructure:
+    - ⚡ **Supabase** - Auth, DB, Realtime.
+    - 🎷 **Jazz.tools** - Local-first sync and auth.
 - 🧩 **Zod** - TypeScript-first schema validation with static type inference.
 - 🧪 **Testing Tools** - Vitest & React Testing Library (Unit/Integration testing).
 - 📚 **Storybook** - Frontend workshop for UI development (Includes testing setup).
@@ -68,9 +69,8 @@ The CLI will guide you through the setup:
     -   *Install shadcn/ui?* (Default: Yes)
     -   *Install TanStack Query?* (Default: Yes)
     -   *Install @next/third-parties?* (Default: Yes)
-    -   *Install Resend?* (Default: No)
-    -   *Install React Email?* (Default: No)
-    -   *Install Supabase?* (Default: Yes)
+    -   *Install Email tools? (Resend + React Email)* (Default: No)
+    -   *Choose Backend?* (Supabase, Jazz, or None)
     -   *Install Zod?* (Default: Yes)
     -   *Install Storybook?* (Default: No)
         -   *If Yes*: Sets up Storybook environment.
@@ -91,9 +91,10 @@ pnpm create esa-stack <project-name> [options]
 | `--shadcn` / `--no-shadcn` | Install shadcn/ui | Yes |
 | `--tanstack-query` / `--no-tanstack-query` | Install TanStack Query | Yes |
 | `--next-third-parties` / `--no-next-third-parties` | Install @next/third-parties | Yes |
-| `--resend` / `--no-resend` | Install Resend | No |
-| `--react-email` / `--no-react-email` | Install React Email | No |
-| `--supabase` / `--no-supabase` | Install Supabase | Yes |
+| `--email` / `--no-email` | Install Resend + React Email | No |
+| `--supabase` | Install Supabase (Backend) | * |
+| `--jazz` | Install Jazz.tools (Backend) | - |
+| `--no-backend` | Do not install any backend | - |
 | `--zod` / `--no-zod` | Install Zod | Yes |
 | `--storybook` / `--no-storybook` | Install Storybook | No |
 | `--testing` / `--no-testing` | Install Vitest + RTL | Yes |

package/dist/cli.js

@@ -2568,6 +2568,32 @@ class BD extends x {
     });
   }
 }
+var wD = Object.defineProperty;
+var yD = (e, u, F) => (u in e) ? wD(e, u, { enumerable: true, configurable: true, writable: true, value: F }) : e[u] = F;
+var Z = (e, u, F) => (yD(e, typeof u != "symbol" ? u + "" : u, F), F);
+var $D = class extends x {
+  constructor(u) {
+    super(u, false), Z(this, "options"), Z(this, "cursor", 0), this.options = u.options, this.cursor = this.options.findIndex(({ value: F }) => F === u.initialValue), this.cursor === -1 && (this.cursor = 0), this.changeValue(), this.on("cursor", (F) => {
+      switch (F) {
+        case "left":
+        case "up":
+          this.cursor = this.cursor === 0 ? this.options.length - 1 : this.cursor - 1;
+          break;
+        case "down":
+        case "right":
+          this.cursor = this.cursor === this.options.length - 1 ? 0 : this.cursor + 1;
+          break;
+      }
+      this.changeValue();
+    });
+  }
+  get _value() {
+    return this.options[this.cursor];
+  }
+  changeValue() {
+    this.value = this._value.value;
+  }
+};
 var TD = Object.defineProperty;
 var jD = (e, u, F) => (u in e) ? TD(e, u, { enumerable: true, configurable: true, writable: true, value: F }) : e[u] = F;
 var MD = (e, u, F) => (jD(e, typeof u != "symbol" ? u + "" : u, F), F);
@@ -2655,6 +2681,16 @@ var y2 = (s) => {
       return import_picocolors2.default.green(M2);
   }
 };
+var E = (s) => {
+  const { cursor: n, options: t, style: i } = s, r2 = s.maxItems ?? 1 / 0, o = Math.max(process.stdout.rows - 4, 0), c2 = Math.min(o, Math.max(r2, 5));
+  let l2 = 0;
+  n >= l2 + c2 - 3 ? l2 = Math.max(Math.min(n - c2 + 3, t.length - c2), 0) : n < l2 + 2 && (l2 = Math.max(n - 2, 0));
+  const d2 = c2 < t.length && l2 > 0, p = c2 < t.length && l2 + c2 < t.length;
+  return t.slice(l2, l2 + c2).map((S2, f2, x2) => {
+    const g2 = f2 === 0 && d2, m2 = f2 === x2.length - 1 && p;
+    return g2 || m2 ? import_picocolors2.default.dim("...") : i(S2, f2 + l2 === n);
+  });
+};
 var ae = (s) => new PD({ validate: s.validate, placeholder: s.placeholder, defaultValue: s.defaultValue, initialValue: s.initialValue, render() {
   const n = `${import_picocolors2.default.gray(a2)}
 ${y2(this.state)}  ${s.message}
@@ -2695,6 +2731,38 @@ ${import_picocolors2.default.cyan($2)}
     }
   } }).prompt();
 };
+var le = (s) => {
+  const n = (t, i) => {
+    const r2 = t.label ?? String(t.value);
+    switch (i) {
+      case "selected":
+        return `${import_picocolors2.default.dim(r2)}`;
+      case "active":
+        return `${import_picocolors2.default.green(I2)} ${r2} ${t.hint ? import_picocolors2.default.dim(`(${t.hint})`) : ""}`;
+      case "cancelled":
+        return `${import_picocolors2.default.strikethrough(import_picocolors2.default.dim(r2))}`;
+      default:
+        return `${import_picocolors2.default.dim(T2)} ${import_picocolors2.default.dim(r2)}`;
+    }
+  };
+  return new $D({ options: s.options, initialValue: s.initialValue, render() {
+    const t = `${import_picocolors2.default.gray(a2)}
+${y2(this.state)}  ${s.message}
+`;
+    switch (this.state) {
+      case "submit":
+        return `${t}${import_picocolors2.default.gray(a2)}  ${n(this.options[this.cursor], "selected")}`;
+      case "cancel":
+        return `${t}${import_picocolors2.default.gray(a2)}  ${n(this.options[this.cursor], "cancelled")}
+${import_picocolors2.default.gray(a2)}`;
+      default:
+        return `${t}${import_picocolors2.default.cyan(a2)}  ${E({ cursor: this.cursor, options: this.options, maxItems: s.maxItems, style: (i, r2) => n(i, r2 ? "active" : "inactive") }).join(`
+${import_picocolors2.default.cyan(a2)}  `)}
+${import_picocolors2.default.cyan($2)}
+`;
+    }
+  } }).prompt();
+};
 var he = (s = "") => {
   process.stdout.write(`${import_picocolors2.default.gray($2)}  ${import_picocolors2.default.red(s)}
 
@@ -2757,7 +2825,7 @@ var {
 
 // src/cli.ts
 import { execSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 var __filename2 = fileURLToPath(import.meta.url);
@@ -2775,7 +2843,7 @@ function getVersion() {
 async function main() {
   const program2 = new Command;
   const version = getVersion();
-  program2.name("create-esa-stack").description("CLI tool to scaffold Next.js projects with ESA's preferred tech stack").version(version).argument("[project-name]", "Name of the project directory").option("--shadcn", "Install shadcn/ui").option("--no-shadcn", "Do not install shadcn/ui").option("--tanstack-query", "Install TanStack Query").option("--no-tanstack-query", "Do not install TanStack Query").option("--next-third-parties", "Install @next/third-parties").option("--no-next-third-parties", "Do not install @next/third-parties").option("--resend", "Install Resend").option("--no-resend", "Do not install Resend").option("--react-email", "Install React Email").option("--no-react-email", "Do not install React Email").option("--supabase", "Install Supabase").option("--no-supabase", "Do not install Supabase").option("--storybook", "Install Storybook").option("--no-storybook", "Do not install Storybook").option("--testing", "Install Testing tools (Vitest + RTL)").option("--no-testing", "Do not install Testing tools").option("--zod", "Install Zod").option("--no-zod", "Do not install Zod").option("-y, --default", "Skip prompts and use default values").parse(process.argv);
+  program2.name("create-esa-stack").description("CLI tool to scaffold Next.js projects with ESA's preferred tech stack").version(version).argument("[project-name]", "Name of the project directory").option("--shadcn", "Install shadcn/ui").option("--no-shadcn", "Do not install shadcn/ui").option("--tanstack-query", "Install TanStack Query").option("--no-tanstack-query", "Do not install TanStack Query").option("--next-third-parties", "Install @next/third-parties").option("--no-next-third-parties", "Do not install @next/third-parties").option("--email", "Install Resend + React Email").option("--no-email", "Do not install email tools").option("--supabase", "Install Supabase (Backend)").option("--jazz", "Install Jazz.tools (Backend)").option("--no-backend", "Do not install any backend").option("--storybook", "Install Storybook").option("--no-storybook", "Do not install Storybook").option("--testing", "Install Testing tools (Vitest + RTL)").option("--no-testing", "Do not install Testing tools").option("--zod", "Install Zod").option("--no-zod", "Do not install Zod").option("-y, --default", "Skip prompts and use default values").parse(process.argv);
   const options = program2.opts();
   const [cliProjectName] = program2.args;
   const useDefaults = !!options.default;
@@ -2837,9 +2905,32 @@ async function main() {
   const installShadcn = await resolveOption(options.shadcn, true, "Do you want to install shadcn/ui?");
   const installTanstackQuery = await resolveOption(options.tanstackQuery, true, "Do you want to install TanStack Query?");
   const installNextThirdParties = await resolveOption(options.nextThirdParties, true, "Do you want to install @next/third-parties?");
-  const installResend = await resolveOption(options.resend, false, "Do you want to install Resend?");
-  const installReactEmail = await resolveOption(options.reactEmail, false, "Do you want to install React Email?");
-  const installSupabase = await resolveOption(options.supabase, true, "Do you want to install Supabase?");
+  const installEmail = await resolveOption(options.email, false, "Do you want to install Email tools? (Resend + React Email)");
+  let backend = "none";
+  if (options.supabase) {
+    backend = "supabase";
+  } else if (options.jazz) {
+    backend = "jazz";
+  } else if (options.noBackend) {
+    backend = "none";
+  } else if (useDefaults) {
+    backend = "supabase";
+  } else {
+    const result = await le({
+      message: "Which backend tool do you want to use?",
+      options: [
+        { value: "supabase", label: "Supabase (Auth, DB, Realtime)", hint: "recommended" },
+        { value: "jazz", label: "Jazz.tools (Local-first, Sync, Auth)" },
+        { value: "none", label: "None (Pure Next.js)" }
+      ],
+      initialValue: "supabase"
+    });
+    if (typeof result === "symbol") {
+      he("Operation cancelled.");
+      process.exit(0);
+    }
+    backend = result;
+  }
   const installZod = await resolveOption(options.zod, true, "Do you want to install Zod?");
   const installStorybook = await resolveOption(options.storybook, false, "Do you want to install Storybook?");
   let installTesting = false;
@@ -2888,31 +2979,20 @@ Setting up @next/third-parties...`);
       console.log("Installing @next/third-parties...");
       execSync("pnpm add @next/third-parties", { stdio: "inherit", cwd: projectPath });
     }
-    if (installResend) {
-      console.log(`
-Setting up Resend...`);
-      const hasNodeModules = existsSync(join(projectPath, "node_modules"));
-      if (!hasNodeModules) {
-        console.log("Installing dependencies...");
-        execSync("pnpm install", { stdio: "inherit", cwd: projectPath });
-      }
-      console.log("Installing resend...");
-      execSync("pnpm add resend", { stdio: "inherit", cwd: projectPath });
-    }
-    if (installReactEmail) {
+    if (installEmail) {
       console.log(`
-Setting up React Email...`);
+Setting up Email (Resend + React Email)...`);
       const hasNodeModules = existsSync(join(projectPath, "node_modules"));
       if (!hasNodeModules) {
         console.log("Installing dependencies...");
         execSync("pnpm install", { stdio: "inherit", cwd: projectPath });
       }
-      console.log("Installing react-email and @react-email/preview-server...");
-      execSync("pnpm add react-email @react-email/preview-server -D -E", { stdio: "inherit", cwd: projectPath });
+      console.log("Installing resend and react-email...");
+      execSync("pnpm add resend react-email @react-email/preview-server -D -E", { stdio: "inherit", cwd: projectPath });
       console.log("Installing @react-email/components...");
       execSync("pnpm add @react-email/components -E", { stdio: "inherit", cwd: projectPath });
     }
-    if (installSupabase) {
+    if (backend === "supabase") {
       console.log(`
 Setting up Supabase...`);
       const hasNodeModules = existsSync(join(projectPath, "node_modules"));
@@ -2924,6 +3004,26 @@ Setting up Supabase...`);
       execSync("pnpm add @supabase/supabase-js @supabase/ssr -E", { stdio: "inherit", cwd: projectPath });
       console.log("Installing supabase CLI...");
       execSync("pnpm add supabase -D -E", { stdio: "inherit", cwd: projectPath });
+      console.log("Creating .env.example...");
+      const envContent = `NEXT_PUBLIC_SUPABASE_URL=""
+NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=""
+`;
+      writeFileSync(join(projectPath, ".env.example"), envContent);
+    }
+    if (backend === "jazz") {
+      console.log(`
+Setting up Jazz.tools...`);
+      const hasNodeModules = existsSync(join(projectPath, "node_modules"));
+      if (!hasNodeModules) {
+        console.log("Installing dependencies...");
+        execSync("pnpm install", { stdio: "inherit", cwd: projectPath });
+      }
+      console.log("Installing jazz-tools...");
+      execSync("pnpm add jazz-tools", { stdio: "inherit", cwd: projectPath });
+      console.log("Creating .env.example...");
+      const envContent = `NEXT_PUBLIC_JAZZ_API_KEY="" # or your API key
+`;
+      writeFileSync(join(projectPath, ".env.example"), envContent);
     }
     if (installZod) {
       console.log(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-esa-stack",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "description": "CLI tool to scaffold Next.js projects with esa's preferred tech stack",
   "type": "module",
   "bin": {