create-esa-stack 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -5,15 +5,51 @@ 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).
 
-## [Unreleased]
-
-### Planned for 0.2.0
-- Template registry system
-- Project structure schema
-- Commander.js CLI framework
-- AST-based code transformations
-- Test infrastructure
-- Critical bug fixes
+## [0.1.10] - 2026-01-24
+
+### Docs
+- Comprehensive documentation update in README and CHANGELOG.
+
+## [0.1.9] - 2026-01-24
+
+### Added
+- **Storybook**: Added support for Storybook component development environment.
+- **Smart Testing Configuration**: Automatically skips separate testing tools setup if Storybook is used (since it includes testing infrastructure).
+
+## [0.1.8] - 2026-01-24
+
+### Added
+- **Testing Tools**: Added optional installation for Vitest and React Testing Library.
+
+## [0.1.7] - 2026-01-24
+
+### Added
+- **Supabase**: Added optional integration for Supabase (Auth, Database, Realtime). Installs `@supabase/supabase-js`, `@supabase/ssr` and CLI.
+
+## [0.1.6] - 2026-01-24
+
+### Added
+- **React Email**: Added optional integration for React Email, including preview server and components.
+
+## [0.1.5] - 2026-01-24
+
+### Added
+- **Resend**: Added optional integration for Resend transactional emails.
+
+## [0.1.4] - 2026-01-24
+
+### Added
+- **@next/third-parties**: Added optional support for optimized third-party scripts (Google Analytics, GTM, etc).
+
+## [0.1.3] - 2026-01-24
+
+### Added
+- **TanStack Query**: Added optional integration for server-state management.
+
+## [0.1.2] - 2026-01-24
+
+### Added
+- **shadcn/ui**: Added optional integration for shadcn/ui component library.
 
 ## [0.1.0] - 2026-01-22
 

package/README.md

@@ -1,49 +1,82 @@
 # create-esa-stack
 
-A CLI tool to quickly scaffold Next.js projects with ESA's preferred tech stack.
+A CLI tool to quickly scaffold Next.js projects with ESA's preferred tech stack. 
+
+> **Opinionated but flexible.** Starts with a robust modern foundation, then lets you pick exactly the extras you need.
 
 ## Features
 
-Creates a Next.js project with the following tech stack:
+Every project is created with a solid baseline:
 
 - ✅ **Next.js** - React framework with App Router
 - ✅ **TypeScript** - Type-safe JavaScript
-- ✅ **Tailwind CSS** - Utility-first CSS framework
-- ✅ **Biome.js** - Fast linter and formatter
+- ✅ **Tailwind CSS** - Utility-first CSS framework (v4)
+- ✅ **Biome.js** - Ultra-fast linter and formatter
 - ✅ **React Compiler** - Optimized React performance
 - ✅ **Turbopack** - Fast bundler for development
 - ✅ **pnpm** - Efficient package manager
 
+### Optional Integrations
+
+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).
+- 🧪 **Testing Tools** - Vitest & React Testing Library (Unit/Integration testing).
+- 📚 **Storybook** - Frontend workshop for UI development (Includes testing setup).
+
 ## Usage
 
-### Using npx (Recommended)
+### Recommended (pnpm)
 
 ```bash
-npx create-esa-stack
+pnpm create esa-stack@latest
 ```
 
-### Using Bun
+### Other Package Managers
+
+**npm**
 
 ```bash
-bun create esa-stack
+npx create-esa-stack@latest
 ```
 
-### Local Development
+**yarn**
 
 ```bash
-# Install dependencies
-bun install
+yarn create esa-stack
+```
 
-# Run the CLI locally
-bun run dev
+**bun**
 
-# Build the CLI
-bun run build
+```bash
+bun create esa-stack
 ```
 
+### Interactive Flow
+
+The CLI will guide you through the setup:
+
+1.  **Project Name**: Choose a name for your directory.
+2.  **Scaffolding**: Sets up the base Next.js application.
+3.  **Optional Packages**:
+    -   *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 Storybook?* (Default: No)
+        -   *If Yes*: Sets up Storybook environment.
+        -   *If No*: Asks to install *Testing Tools (Vitest)* separately.
+
 ## How It Works
 
-The CLI prompts you for a project name and then runs `create-next-app` with the following flags:
+The CLI wraps `create-next-app` with a specific set of high-performance flags:
 
 ```bash
 npx create-next-app@latest <project-name> \
@@ -57,18 +90,16 @@ npx create-next-app@latest <project-name> \
   --yes
 ```
 
-## Roadmap
-
-Optional integrations available:
+After scaffolding, it programmatically installs and configures selected integrations (e.g., running `shadcn init`, `storybook init`, etc.) so you're ready to code immediately.
 
-- [x] **@tanstack/react-query** - Data fetching and caching ✨
-- [x] **shadcn/ui** - Beautiful UI component library ✨
-- [x] **resend** - Email API for sending emails ✨
+## Contributing
 
-Coming soon:
+Contributions are welcome!
 
-- [ ] **react-email** - Email templates
-- [ ] **Storybook** - Component development
+1.  Clone the repository.
+2.  Install dependencies: `bun install`
+3.  Run the CLI locally: `bun run dev`
+4.  Build: `bun run build`
 
 ## License
 

package/dist/cli.js

@@ -712,17 +712,29 @@ async function main() {
     he("Operation cancelled.");
     process.exit(0);
   }
-  const installTesting = await ce({
-    message: "Do you want to install Testing tools (Vitest + React Testing Library)?",
-    initialValue: true
+  const installStorybook = await ce({
+    message: "Do you want to install Storybook?",
+    initialValue: false
   });
-  if (typeof installTesting === "symbol") {
+  if (typeof installStorybook === "symbol") {
     he("Operation cancelled.");
     process.exit(0);
   }
+  let installTesting = false;
+  if (!installStorybook) {
+    const testing = await ce({
+      message: "Do you want to install Testing tools (Vitest + React Testing Library)?",
+      initialValue: true
+    });
+    if (typeof testing === "symbol") {
+      he("Operation cancelled.");
+      process.exit(0);
+    }
+    installTesting = testing;
+  }
   const s = _2();
   s.start("Scaffolding project...");
-  const command = `pnpm create next-app@latest ${projectName} --biome --ts --tailwind --react-compiler --app --src-dir --import-alias "@/*" --use-pnpm --turbopack --skip-install --yes`;
+  const command = `npx create-next-app@latest ${projectName} --biome --ts --tailwind --react-compiler --app --src-dir --import-alias "@/*" --use-pnpm --turbopack --skip-install --yes`;
   try {
     s.stop("Starting scaffolding...");
     execSync(command, { stdio: "inherit" });
@@ -733,7 +745,7 @@ Setting up shadcn/ui...`);
       console.log("Installing dependencies...");
       execSync("pnpm install", { stdio: "inherit", cwd: projectPath });
       console.log("Initializing shadcn/ui...");
-      execSync("pnpm dlx shadcn@latest init", { stdio: "inherit", cwd: projectPath });
+      execSync("npx shadcn@latest init", { stdio: "inherit", cwd: projectPath });
     }
     if (installTanstackQuery) {
       console.log(`
@@ -805,6 +817,17 @@ Setting up Testing tools...`);
       console.log("Installing Vitest, React Testing Library, and related tools...");
       execSync("pnpm add vitest @vitejs/plugin-react jsdom @testing-library/react @testing-library/dom vite-tsconfig-paths -D -E", { stdio: "inherit", cwd: projectPath });
     }
+    if (installStorybook) {
+      console.log(`
+Setting up Storybook...`);
+      const hasNodeModules = existsSync(join(projectPath, "node_modules"));
+      if (!hasNodeModules) {
+        console.log("Installing dependencies...");
+        execSync("pnpm install", { stdio: "inherit", cwd: projectPath });
+      }
+      console.log("Installing Storybook...");
+      execSync("pnpm create storybook@latest --no-dev -y --package-manager pnpm", { stdio: "inherit", cwd: projectPath });
+    }
     ge(`Successfully created ${projectName}!`);
   } catch (error) {
     s.stop("Failed to scaffold project.");

package/package.json

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