create-esa-stack 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -5,15 +5,58 @@ 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.11] - 2026-01-24
+
+### Added
+- **CLI Flags**: Added support for CLI arguments and flags (e.g., `create-esa-stack my-app --supabase --no-testing`).
+- **Non-Interactive Mode**: Added `--default` / `-y` flag to skip all prompts and use default values.
+- **Help Command**: Added `--help` to list all available options.
+
+## [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,111 @@
 # 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
+pnpm create esa-stack@latest
+```
+
+### Other Package Managers
+
+**npm**
+
+```bash
+npx create-esa-stack@latest
+```
+
+**yarn**
 
 ```bash
-npx create-esa-stack
+yarn create esa-stack
 ```
 
-### Using Bun
+**bun**
 
 ```bash
 bun create esa-stack
 ```
 
-### Local Development
+### 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.
+
+### CLI Options
+
+You can pass the project name and options directly via CLI to skip prompts:
 
 ```bash
-# Install dependencies
-bun install
+pnpm create esa-stack <project-name> [options]
+```
+
+**Available Flags:**
+
+| Flag | Description | Default |
+| :--- | :--- | :--- |
+| `--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 |
+| `--storybook` / `--no-storybook` | Install Storybook | No |
+| `--testing` / `--no-testing` | Install Vitest + RTL | Yes |
+| `--default`, `-y` | Skip prompts and use defaults | - |
+| `--help` | Show help message | - |
 
-# Run the CLI locally
-bun run dev
+**Example:**
 
-# Build the CLI
-bun run build
+```bash
+pnpm create esa-stack my-app --supabase --no-testing -y
 ```
 
 ## 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 +119,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