@tanstack/create-start 0.18.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-present Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# Create React App for TanStack Router
+
+This CLI application builds Tanstack Router applications that are the functional equivalent of [Create React App](https://create-react-app.dev/).
+
+To help accelerate the migration away from `create-react-app` we created the `create-start` CLI which is a plug-n-play replacement for CRA.
+
+## Quick Start
+
+To maintain compatability with `create-react-app` you can build a new application by running:
+
+| Command                                                       | Description        |
+| ------------------------------------------------------------- | ------------------ |
+| `pnpm create @tanstack/start@latest my-app`                   | Create a new app   |
+| `pnpm create @tanstack/start@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
+pnpm create @tanstack/start@latest
+```
+
+This will start an interactive CLI that guides you through the setup process, allowing you to choose:
+
+- Project Name
+- Package manager
+- Toolchain
+- Git initialization
+
+## Command Line Options
+
+You can also use command line flags to specify your preferences directly:
+
+```bash
+pnpm create @tanstack/start@latest my-app --tailwind --package-manager pnpm
+```
+
+Available options:
+
+- `--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
+- `--add-ons`: Enable add-on selection or specify add-ons to install
+
+When using flags, the CLI will display which options were provided and only prompt for the remaining choices.
+
+## Features
+
+What you'll get is a Vite application that uses TanStack Router. All the files will still be in the same place as in CRA, but you'll get a fully functional Router setup under in `app/main.tsx`.
+
+`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).
+
+## Additional Configuration
+
+### 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 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
+
+Choose your preferred solution for formatting and linting either through the interactive CLI or using the `--toolchain` flag.
+
+Setting this flag to `biome` will configure it as your toolchain of choice, adding a `biome.json` to the root of the project. Consult the [biome documentation](https://biomejs.dev/guides/getting-started/) for further customization.
+
+Setting this flag to `eslint+prettier` will configure it as your toolchain of choice, adding an `eslint.config.js` and `prettier.config.js` to the root of the project, as well as a `.prettierignore` file. Consult the [eslint documentation](https://eslint.org/docs/latest/) and [prettier documentation](https://prettier.io/docs/) for further customization.
+
+## Add-ons (experimental)
+
+You can enable add-on selection:
+
+```bash
+pnpm create @tanstack/start@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
+pnpm create @tanstack/start@latest my-app --add-ons shadcn,tanstack-query
+```
+
+You can get a list of all available add-ons by running:
+
+```bash
+pnpm create @tanstack/start@latest --list-add-ons
+```
+
+This will get you a list of all available add-ons for Solid.
+
+```bash
+pnpm create @tanstack/start@latest --list-add-ons --framework solid
+```
+
+## 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 Start applications.
+
+```bash
+pnpm create @tanstack/start@latest --mcp
+```
+
+Here is the JSON configuration for MCP support in many MCP clients.
+
+```json
+{
+  "mcpServers": {
+    "create-start-app": {
+      "command": "pnpx",
+      "args": ["create-start-app@latest", "--mcp"]
+    }
+  }
+}
+```
+
+# Contributing
+
+Check out the [Contributing](CONTRIBUTING.md) guide.
+
+# License
+
+MIT

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { cli } from '@tanstack/cta-cli';
+import { register as registerReactCra } from '@tanstack/cta-framework-react-cra';
+import { register as registerSolid } from '@tanstack/cta-framework-solid';
+registerReactCra();
+registerSolid();
+cli({
+    name: '@tanstack/create-start',
+    appName: 'TanStack Start',
+    forcedMode: 'file-router',
+    forcedAddOns: ['start'],
+    craCompatible: true,
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@tanstack/create-start",
+  "version": "0.18.0",
+  "description": "Tanstack Start Builder",
+  "bin": "./dist/index.js",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TanStack/create-tsrouter-app.git"
+  },
+  "homepage": "https://tanstack.com/router",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "keywords": [
+    "react",
+    "tanstack",
+    "router",
+    "tanstack start",
+    "create-react-app"
+  ],
+  "author": "Jack Herrington <jherr@pobox.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@tanstack/cta-cli": "0.17.5",
+    "@tanstack/cta-framework-react-cra": "0.17.5",
+    "@tanstack/cta-framework-solid": "0.17.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {}
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { cli } from '@tanstack/cta-cli'
+
+import { register as registerReactCra } from '@tanstack/cta-framework-react-cra'
+import { register as registerSolid } from '@tanstack/cta-framework-solid'
+
+registerReactCra()
+registerSolid()
+
+cli({
+  name: '@tanstack/create-start',
+  appName: 'TanStack Start',
+  forcedMode: 'file-router',
+  forcedAddOns: ['start'],
+  craCompatible: true,
+})

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node"
+  },
+  "include": ["./src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}