fix: docs and command line options for create-start-app

Author: jherr

cli/create-start-app/README.md

@@ -10,25 +10,18 @@ To maintain compatability with `create-react-app` you can build a new applicatio
 
 | Command                                                                          | Description                                       |
 | -------------------------------------------------------------------------------- | ------------------------------------------------- |
-| `npx create-start-app@latest my-app`                                             | Create a new app                                  |
-| `npx create-start-app@latest my-app --template file-router`                      | Create a new file based app                       |
-| `npx create-start-app@latest my-app --template typescript`                       | Create a new TypeScript app using the Code Router |
-| `npx create-start-app@latest my-app --tailwind`                                  | Add Tailwind CSS support                          |
-| `npx create-start-app@latest my-app --framework solid`                           | Create a Solid app                                |
-| `npx create-start-app@latest my-app --framework solid --template file-router`    | Create a Solid app with file-router               |
+| `pnpx create-start-app@latest my-app`                                            | Create a new app                                  |
+| `pnpx create-start-app@latest my-app --framework solid`                          | Create a Solid app                                |
 
 If you don't specify a project name, the CLI will walk you through an interactive setup process:
 
 ```bash
-npx create-start-app@latest
+pnpx create-start-app@latest
 ```
 
 This will start an interactive CLI that guides you through the setup process, allowing you to choose:
 
 - Project Name
-- Router Type (File-based or Code-based routing)
-- TypeScript support
-- Tailwind CSS integration
 - Package manager
 - Toolchain
 - Git initialization
@@ -38,13 +31,11 @@ This will start an interactive CLI that guides you through the setup process, al
 You can also use command line flags to specify your preferences directly:
 
 ```bash
-npx create-start-app@latest my-app --template file-router --tailwind --package-manager pnpm
+pnpx create-start-app@latest my-app --tailwind --package-manager pnpm
 ```
 
 Available options:
 
-- `--template <type>`: Choose between `file-router`, `typescript`, or `javascript`
-- `--tailwind`: Enable Tailwind CSS
 - `--package-manager`: Specify your preferred package manager (`npm`, `yarn`, `pnpm`, `bun`, or `deno`)
 - `--toolchain`: Specify your toolchain solution for formatting/linting (`biome`, `eslint+prettier`)
 - `--no-git`: Do not initialize a git repository
@@ -58,43 +49,13 @@ What you'll get is a Vite application that uses TanStack Router. All the files w
 
 `create-start-app` is everything you loved about CRA but implemented with modern tools and best practices, on top of the popular TanStack set of libraries. Which includes [@tanstack/react-query](https://tanstack.com/query/latest) and [@tanstack/react-router](https://tanstack.com/router/latest).
 
-## Routing Options
-
-### File Based Routing (Recommended)
-
-File Based Routing is the default option when using the interactive CLI. The location of the home page will be `app/routes/index.tsx`. This approach provides a more intuitive and maintainable way to structure your routes.
-
-To explicitly choose File Based Routing, use:
-
-```bash
-npx create-start-app@latest my-app --template file-router
-```
-
-### Code Based Routing
-
-If you prefer traditional code-based routing, you can select it in the interactive CLI or specify it by using either the `typescript` or `javascript` template:
-
-```bash
-npx create-start-app@latest my-app --template typescript
-```
-
 ## Additional Configuration
 
-### TypeScript
-
-- File Based Routing always uses TypeScript
-- For Code Based Routing, you can choose between TypeScript and JavaScript
-- Enable TypeScript explicitly with `--template typescript`
-
-### Tailwind CSS
-
-Enable Tailwind CSS either through the interactive CLI or by adding the `--tailwind` flag. This will automatically configure [Tailwind V4](https://tailwindcss.com/).
-
 ### Package Manager
 
 Choose your preferred package manager (`npm`, `bun`, `yarn`, `pnpm`, or `deno`) either through the interactive CLI or using the `--package-manager` flag.
 
-Extensive documentation on using the TanStack Router, migrating to a File Base Routing approach, as well as integrating [@tanstack/react-query](https://tanstack.com/query/latest) and [@tanstack/store](https://tanstack.com/store/latest) can be found in the generated `README.md` for your project.
+Extensive documentation on using the TanStack Start, as well as integrating [@tanstack/react-query](https://tanstack.com/query/latest) and [@tanstack/store](https://tanstack.com/store/latest) can be found in the generated `README.md` for your project.
 
 ### Toolchain
 
@@ -109,37 +70,35 @@ Setting this flag to `eslint+prettier` will configure it as your toolchain of ch
 You can enable add-on selection:
 
 ```bash
-npx create-start-app@latest --add-ons
+pnpx create-start-app@latest --add-ons
 ```
 
 This will prompt you to select the add-ons you want to enable during application creation.
 
 You can enable specific add-ons directly by adding a comma separated list of add-on names to the `--add-ons` flag. For example:
 
 ```bash
-npx create-start-app@latest my-app --add-ons shadcn,tanstack-query
+pnpx create-start-app@latest my-app --add-ons shadcn,tanstack-query
 ```
 
 You can get a list of all available add-ons by running:
 
 ```bash
-npx create-start-app@latest --list-add-ons
+pnpx create-start-app@latest --list-add-ons
 ```
 
-This will display a list of all available add-ons for React that are compatible with the Code Router.
+This will get you a list of all available add-ons for Solid.
 
 ```bash
-npx create-start-app@latest --list-add-ons --framework solid --template file-router
+pnpx create-start-app@latest --list-add-ons --framework solid
 ```
 
-Will get you a list of all available add-ons for Solid that are compatible with the File Router.
-
 ## MCP (Model Context Protocol) Support (experimental)
 
-You can launch the `create-start-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Router applications.
+You can launch the `create-start-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Start applications.
 
 ```bash
-npx create-start-app@latest --mcp
+pnpx create-start-app@latest --mcp
 ```
 
 Shown below is the configuration for MCP support in Cursor.

cli/create-tsrouter-app/README.md

@@ -10,17 +10,17 @@ To maintain compatability with `create-react-app` you can build a new applicatio
 
 | Command                                                                          | Description                                       |
 | -------------------------------------------------------------------------------- | ------------------------------------------------- |
-| `npx create-tsrouter-app@latest my-app`                                          | Create a new app                                  |
-| `npx create-tsrouter-app@latest my-app --template file-router`                   | Create a new file based app                       |
-| `npx create-tsrouter-app@latest my-app --template typescript`                    | Create a new TypeScript app using the Code Router |
-| `npx create-tsrouter-app@latest my-app --tailwind`                               | Add Tailwind CSS support                          |
-| `npx create-tsrouter-app@latest my-app --framework solid`                        | Create a Solid app                                |
-| `npx create-tsrouter-app@latest my-app --framework solid --template file-router` | Create a Solid app with file-router               |
+| `pnpx create-tsrouter-app@latest my-app`                                          | Create a new app                                  |
+| `pnpx create-tsrouter-app@latest my-app --template file-router`                   | Create a new file based app                       |
+| `pnpx create-tsrouter-app@latest my-app --template typescript`                    | Create a new TypeScript app using the Code Router |
+| `pnpx create-tsrouter-app@latest my-app --tailwind`                               | Add Tailwind CSS support                          |
+| `pnpx create-tsrouter-app@latest my-app --framework solid`                        | Create a Solid app                                |
+| `pnpx create-tsrouter-app@latest my-app --framework solid --template file-router` | Create a Solid app with file-router               |
 
 If you don't specify a project name, the CLI will walk you through an interactive setup process:
 
 ```bash
-npx create-tsrouter-app@latest
+pnpx create-tsrouter-app@latest
 ```
 
 This will start an interactive CLI that guides you through the setup process, allowing you to choose:
@@ -38,7 +38,7 @@ This will start an interactive CLI that guides you through the setup process, al
 You can also use command line flags to specify your preferences directly:
 
 ```bash
-npx create-tsrouter-app@latest my-app --template file-router --tailwind --package-manager pnpm
+pnpx create-tsrouter-app@latest my-app --template file-router --tailwind --package-manager pnpm
 ```
 
 Available options:
@@ -67,15 +67,15 @@ File Based Routing is the default option when using the interactive CLI. The loc
 To explicitly choose File Based Routing, use:
 
 ```bash
-npx create-tsrouter-app@latest my-app --template file-router
+pnpx create-tsrouter-app@latest my-app --template file-router
 ```
 
 ### Code Based Routing
 
 If you prefer traditional code-based routing, you can select it in the interactive CLI or specify it by using either the `typescript` or `javascript` template:
 
 ```bash
-npx create-tsrouter-app@latest my-app --template typescript
+pnpx create-tsrouter-app@latest my-app --template typescript
 ```
 
 ## Additional Configuration
@@ -109,27 +109,27 @@ Setting this flag to `eslint+prettier` will configure it as your toolchain of ch
 You can enable add-on selection:
 
 ```bash
-npx create-tsrouter-app@latest --add-ons
+pnpx create-tsrouter-app@latest --add-ons
 ```
 
 This will prompt you to select the add-ons you want to enable during application creation.
 
 You can enable specific add-ons directly by adding a comma separated list of add-on names to the `--add-ons` flag. For example:
 
 ```bash
-npx create-tsrouter-app@latest my-app --add-ons shadcn,tanstack-query
+pnpx create-tsrouter-app@latest my-app --add-ons shadcn,tanstack-query
 ```
 
 You can get a list of all available add-ons by running:
 
 ```bash
-npx create-tsrouter-app@latest --list-add-ons
+pnpx create-tsrouter-app@latest --list-add-ons
 ```
 
 This will display a list of all available add-ons for React that are compatible with the Code Router.
 
 ```bash
-npx create-tsrouter-app@latest --list-add-ons --framework solid --template file-router
+pnpx create-tsrouter-app@latest --list-add-ons --framework solid --template file-router
 ```
 
 Will get you a list of all available add-ons for Solid that are compatible with the File Router.
@@ -139,7 +139,7 @@ Will get you a list of all available add-ons for Solid that are compatible with
 You can launch the `create-tsrouter-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Router applications.
 
 ```bash
-npx create-tsrouter-app@latest --mcp
+pnpx create-tsrouter-app@latest --mcp
 ```
 
 Shown below is the configuration for MCP support in Cursor.

packages/cta-engine/src/options.ts

@@ -66,7 +66,9 @@ export async function normalizeOptions(
       forcedAddOns
     ) {
       addOns = true
-      let finalAddOns = [...(overlay?.dependsOn || [])]
+      let finalAddOns = Array.from(
+        new Set([...(overlay?.dependsOn || []), ...(forcedAddOns || [])]),
+      )
       if (cliOptions.addOns && Array.isArray(cliOptions.addOns)) {
         finalAddOns = Array.from(
           new Set([