create-better-t-stack 2.35.3 → 2.35.5-canary.449f72a5

package/README.md

@@ -45,6 +45,40 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | **Examples**             | • Todo app<br>• AI Chat interface (using Vercel AI SDK)                                                                                                                                                                                                    |
 | **Developer Experience** | • Automatic Git initialization<br>• Package manager choice (npm, pnpm, bun)<br>• Automatic dependency installation                                                                                                                                         |
 
+## MCP (Model Context Protocol) Support
+
+The CLI now supports the Model Context Protocol, allowing AI assistants to scaffold projects programmatically. This enables seamless integration with AI coding assistants like Claude, Cursor, and others.
+
+### Quick Start with MCP
+
+```bash
+# Start the MCP server
+npx create-better-t-stack --mcp
+```
+
+### MCP Client Configuration
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "better-t-stack": {
+      "command": "npx",
+      "args": ["-y", "create-better-t-stack", "--mcp"]
+    }
+  }
+}
+```
+
+### Available MCP Tools
+
+- **`create_project`** - Create a new Better-T Stack project with specified configuration
+- **`list_configurations`** - List all available configuration options
+- **`get_project_info`** - Get information about an existing project
+
+For detailed MCP documentation, see [MCP_README.md](./MCP_README.md).
+
 ## Usage
 
 ```bash

package/dist/cli.js

@@ -1,8 +1,426 @@
 #!/usr/bin/env node
-import { createBtsCli } from "./src-dID--AYy.js";
+import { createBtsCli, init } from "./src-BN1_H4yj.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
+//#region src/mcp-server.ts
+const server = new Server({
+	name: "create-better-t-stack",
+	version: "1.0.0"
+});
+const createProjectTool = {
+	name: "create_project",
+	description: "Create a new Better-T Stack project with the specified configuration",
+	inputSchema: {
+		type: "object",
+		properties: {
+			projectName: {
+				type: "string",
+				description: "Name of the project to create"
+			},
+			database: {
+				type: "string",
+				enum: [
+					"none",
+					"sqlite",
+					"postgres",
+					"mysql",
+					"mongodb"
+				],
+				description: "Database type to use"
+			},
+			orm: {
+				type: "string",
+				enum: [
+					"drizzle",
+					"prisma",
+					"mongoose",
+					"none"
+				],
+				description: "ORM to use"
+			},
+			backend: {
+				type: "string",
+				enum: [
+					"hono",
+					"express",
+					"fastify",
+					"next",
+					"elysia",
+					"convex",
+					"none"
+				],
+				description: "Backend framework to use"
+			},
+			runtime: {
+				type: "string",
+				enum: [
+					"bun",
+					"node",
+					"workers",
+					"none"
+				],
+				description: "Runtime environment"
+			},
+			frontend: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"tanstack-router",
+						"react-router",
+						"tanstack-start",
+						"next",
+						"nuxt",
+						"native-nativewind",
+						"native-unistyles",
+						"svelte",
+						"solid",
+						"none"
+					]
+				},
+				description: "Frontend frameworks to use"
+			},
+			addons: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"pwa",
+						"tauri",
+						"starlight",
+						"biome",
+						"husky",
+						"ruler",
+						"turborepo",
+						"fumadocs",
+						"ultracite",
+						"oxlint",
+						"none"
+					]
+				},
+				description: "Addons to include"
+			},
+			examples: {
+				type: "array",
+				items: {
+					type: "string",
+					enum: [
+						"todo",
+						"ai",
+						"none"
+					]
+				},
+				description: "Example templates to include"
+			},
+			auth: {
+				type: "boolean",
+				description: "Whether to include authentication"
+			},
+			git: {
+				type: "boolean",
+				description: "Whether to initialize git repository"
+			},
+			packageManager: {
+				type: "string",
+				enum: [
+					"npm",
+					"pnpm",
+					"bun"
+				],
+				description: "Package manager to use"
+			},
+			install: {
+				type: "boolean",
+				description: "Whether to install dependencies"
+			},
+			dbSetup: {
+				type: "string",
+				enum: [
+					"turso",
+					"neon",
+					"prisma-postgres",
+					"mongodb-atlas",
+					"supabase",
+					"d1",
+					"docker",
+					"none"
+				],
+				description: "Database setup configuration"
+			},
+			api: {
+				type: "string",
+				enum: [
+					"trpc",
+					"orpc",
+					"none"
+				],
+				description: "API type to use"
+			},
+			webDeploy: {
+				type: "string",
+				enum: [
+					"vercel",
+					"netlify",
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				description: "Web deployment platform"
+			},
+			serverDeploy: {
+				type: "string",
+				enum: [
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				description: "Server deployment platform"
+			},
+			directoryConflict: {
+				type: "string",
+				enum: [
+					"merge",
+					"overwrite",
+					"increment",
+					"error"
+				],
+				description: "How to handle directory conflicts"
+			},
+			yes: {
+				type: "boolean",
+				description: "Use default configuration without prompts"
+			},
+			yolo: {
+				type: "boolean",
+				description: "Bypass validations and compatibility checks"
+			},
+			verbose: {
+				type: "boolean",
+				description: "Show detailed result information"
+			},
+			disableAnalytics: {
+				type: "boolean",
+				description: "Disable analytics"
+			}
+		},
+		required: ["projectName"]
+	}
+};
+const listConfigurationsTool = {
+	name: "list_configurations",
+	description: "List available configurations for Better-T Stack projects",
+	inputSchema: {
+		type: "object",
+		properties: {}
+	}
+};
+const getProjectInfoTool = {
+	name: "get_project_info",
+	description: "Get information about a Better-T Stack project",
+	inputSchema: {
+		type: "object",
+		properties: { projectPath: {
+			type: "string",
+			description: "Path to the project directory"
+		} },
+		required: ["projectPath"]
+	}
+};
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+	return { tools: [
+		createProjectTool,
+		listConfigurationsTool,
+		getProjectInfoTool
+	] };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+	const { name, arguments: args } = request.params;
+	switch (name) {
+		case "create_project": try {
+			const projectConfig = {
+				projectName: args?.projectName,
+				database: args?.database,
+				orm: args?.orm,
+				backend: args?.backend,
+				runtime: args?.runtime,
+				frontend: args?.frontend,
+				addons: args?.addons,
+				examples: args?.examples,
+				auth: args?.auth,
+				git: args?.git,
+				packageManager: args?.packageManager,
+				install: args?.install,
+				dbSetup: args?.dbSetup,
+				api: args?.api,
+				webDeploy: args?.webDeploy,
+				serverDeploy: args?.serverDeploy,
+				directoryConflict: args?.directoryConflict,
+				yes: args?.yes,
+				yolo: args?.yolo,
+				verbose: args?.verbose,
+				disableAnalytics: args?.disableAnalytics
+			};
+			const result = await init(args?.projectName, projectConfig);
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 2)
+			}] };
+		} catch (error) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error creating project: ${error instanceof Error ? error.message : String(error)}`
+				}],
+				isError: true
+			};
+		}
+		case "list_configurations": {
+			const configurations = {
+				databases: [
+					"none",
+					"sqlite",
+					"postgres",
+					"mysql",
+					"mongodb"
+				],
+				orms: [
+					"drizzle",
+					"prisma",
+					"mongoose",
+					"none"
+				],
+				backends: [
+					"hono",
+					"express",
+					"fastify",
+					"next",
+					"elysia",
+					"convex",
+					"none"
+				],
+				runtimes: [
+					"bun",
+					"node",
+					"workers",
+					"none"
+				],
+				frontends: [
+					"tanstack-router",
+					"react-router",
+					"tanstack-start",
+					"next",
+					"nuxt",
+					"native-nativewind",
+					"native-unistyles",
+					"svelte",
+					"solid",
+					"none"
+				],
+				addons: [
+					"pwa",
+					"tauri",
+					"starlight",
+					"biome",
+					"husky",
+					"ruler",
+					"turborepo",
+					"fumadocs",
+					"ultracite",
+					"oxlint",
+					"none"
+				],
+				examples: [
+					"todo",
+					"ai",
+					"none"
+				],
+				packageManagers: [
+					"npm",
+					"pnpm",
+					"bun"
+				],
+				dbSetups: [
+					"turso",
+					"neon",
+					"prisma-postgres",
+					"mongodb-atlas",
+					"supabase",
+					"d1",
+					"docker",
+					"none"
+				],
+				apis: [
+					"trpc",
+					"orpc",
+					"none"
+				],
+				webDeploys: [
+					"vercel",
+					"netlify",
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				serverDeploys: [
+					"wrangler",
+					"alchemy",
+					"none"
+				],
+				directoryConflicts: [
+					"merge",
+					"overwrite",
+					"increment",
+					"error"
+				]
+			};
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(configurations, null, 2)
+			}] };
+		}
+		case "get_project_info": try {
+			return { content: [{
+				type: "text",
+				text: "Project info functionality not yet implemented"
+			}] };
+		} catch (error) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error getting project info: ${error instanceof Error ? error.message : String(error)}`
+				}],
+				isError: true
+			};
+		}
+		default: throw new Error(`Unknown tool: ${name}`);
+	}
+});
+async function startMCPServer() {
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	console.error("Better-T Stack MCP server started");
+}
+async function main$1() {
+	await startMCPServer();
+}
+if (import.meta.url === `file://${process.argv[1]}`) main$1().catch((error) => {
+	console.error("MCP server error:", error);
+	process.exit(1);
+});
+
+//#endregion
 //#region src/cli.ts
-createBtsCli().run();
+async function main() {
+	const args = process.argv.slice(2);
+	if (args.includes("--mcp")) await startMCPServer();
+	else createBtsCli().run();
+}
+main().catch((error) => {
+	console.error("CLI error:", error);
+	process.exit(1);
+});
 
 //#endregion
 export {  };

package/dist/index.d.ts

@@ -134,6 +134,7 @@ type CreateInput = {
   directoryConflict?: DirectoryConflict;
   renderTitle?: boolean;
   disableAnalytics?: boolean;
+  mcp?: boolean;
 };
 type AddInput = {
   addons?: Addons[];
@@ -221,6 +222,7 @@ declare const router: trpcServer.TRPCBuiltRouter<{
       directoryConflict?: "error" | "merge" | "overwrite" | "increment" | undefined;
       renderTitle?: boolean | undefined;
       disableAnalytics?: boolean | undefined;
+      mcp?: boolean | undefined;
     }];
     output: InitResult | undefined;
     meta: object;

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { builder, createBtsCli, docs, init, router, sponsors } from "./src-dID--AYy.js";
+import { builder, createBtsCli, docs, init, router, sponsors } from "./src-BN1_H4yj.js";
 
 export { builder, createBtsCli, docs, init, router, sponsors };

package/dist/{src-dID--AYy.js → src-BN1_H4yj.js}

@@ -1080,7 +1080,8 @@ async function getServerDeploymentChoice(deployment, runtime, backend, webDeploy
 	if (backend === "none" || backend === "convex") return "none";
 	if (backend !== "hono") return "none";
 	const options = [];
-	if (runtime === "workers") ["alchemy", "wrangler"].forEach((deploy) => {
+	if (runtime !== "workers") return "none";
+	["alchemy", "wrangler"].forEach((deploy) => {
 		const { label, hint } = getDeploymentDisplay$1(deploy);
 		options.unshift({
 			value: deploy,
@@ -1088,11 +1089,6 @@ async function getServerDeploymentChoice(deployment, runtime, backend, webDeploy
 			hint
 		});
 	});
-	else options.push({
-		value: "none",
-		label: "None",
-		hint: "Manual setup"
-	});
 	const response = await select({
 		message: "Select server deployment",
 		options,
@@ -1123,11 +1119,7 @@ async function getServerDeploymentToAdd(runtime, existingDeployment, backend) {
 		}
 	}
 	if (existingDeployment && existingDeployment !== "none") return "none";
-	if (options.length > 0) options.push({
-		value: "none",
-		label: "None",
-		hint: "Skip deployment setup"
-	});
+	if (options.length > 0) {}
 	if (options.length === 0) return "none";
 	const response = await select({
 		message: "Select server deployment",
@@ -1353,7 +1345,7 @@ const getLatestCLIVersion = () => {
 */
 function isTelemetryEnabled() {
 	const BTS_TELEMETRY_DISABLED = process.env.BTS_TELEMETRY_DISABLED;
-	const BTS_TELEMETRY = "1";
+	const BTS_TELEMETRY = "0";
 	if (BTS_TELEMETRY_DISABLED !== void 0) return BTS_TELEMETRY_DISABLED !== "1";
 	if (BTS_TELEMETRY !== void 0) return BTS_TELEMETRY === "1";
 	return true;
@@ -1361,8 +1353,8 @@ function isTelemetryEnabled() {
 
 //#endregion
 //#region src/utils/analytics.ts
-const POSTHOG_API_KEY = "phc_8ZUxEwwfKMajJLvxz1daGd931dYbQrwKNficBmsdIrs";
-const POSTHOG_HOST = "https://us.i.posthog.com";
+const POSTHOG_API_KEY = "random";
+const POSTHOG_HOST = "random";
 function generateSessionId() {
 	const rand = Math.random().toString(36).slice(2);
 	const now = Date.now().toString(36);
@@ -1740,6 +1732,7 @@ function validateFullConfig(config, providedFlags, options) {
 	validateApiConstraints(config, options);
 	validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
 	validateWorkersCompatibility(providedFlags, options, config);
+	if (config.runtime === "workers" && config.serverDeploy === "none") exitWithError("Cloudflare Workers runtime requires a server deployment. Please choose 'wrangler' or 'alchemy' for --server-deploy.");
 	if (config.addons && config.addons.length > 0) {
 		validateAddonsAgainstFrontends(config.addons, config.frontend);
 		config.addons = [...new Set(config.addons)];
@@ -2983,11 +2976,7 @@ async function setupWorkersServerDeploy(serverDir, _packageManager) {
 	};
 	await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	await addPackageDependency({
-		devDependencies: [
-			"wrangler",
-			"@types/node",
-			"@cloudflare/workers-types"
-		],
+		devDependencies: ["wrangler", "@types/node"],
 		projectDir: serverDir
 	});
 }
@@ -3012,7 +3001,6 @@ async function setupAlchemyServerDeploy(serverDir, _packageManager) {
 			"alchemy",
 			"wrangler",
 			"@types/node",
-			"@cloudflare/workers-types",
 			"dotenv"
 		],
 		projectDir: serverDir
@@ -3380,6 +3368,17 @@ async function setupTanStackStartAlchemyDeploy(projectDir, _packageManager) {
 			defaultImport: "alchemy"
 		});
 		else alchemyImport.setModuleSpecifier("alchemy/cloudflare/tanstack-start");
+		const reactImport = sourceFile.getImportDeclaration("@vitejs/plugin-react");
+		let reactPluginIdentifier = "viteReact";
+		if (!reactImport) sourceFile.addImportDeclaration({
+			moduleSpecifier: "@vitejs/plugin-react",
+			defaultImport: "viteReact"
+		});
+		else {
+			const defaultImport = reactImport.getDefaultImport();
+			if (defaultImport) reactPluginIdentifier = defaultImport.getText();
+			else reactImport.setDefaultImport("viteReact");
+		}
 		const exportAssignment = sourceFile.getExportAssignment((d) => !d.isExportEquals());
 		if (!exportAssignment) return;
 		const defineConfigCall = exportAssignment.getExpression();
@@ -3403,26 +3402,33 @@ async function setupTanStackStartAlchemyDeploy(projectDir, _packageManager) {
 					const hasShim = initializer.getElements().some((el) => el.getText().includes("alchemy"));
 					if (!hasShim) initializer.addElement("alchemy()");
 					const tanstackElements = initializer.getElements().filter((el) => el.getText().includes("tanstackStart"));
+					let needsReactPlugin = false;
 					tanstackElements.forEach((element) => {
 						if (Node.isCallExpression(element)) {
 							const args = element.getArguments();
-							if (args.length === 0) element.addArgument(`{
+							if (args.length === 0) {
+								element.addArgument(`{
       target: "cloudflare-module",
       customViteReactPlugin: true,
     }`);
-							else if (args.length === 1 && Node.isObjectLiteralExpression(args[0])) {
+								needsReactPlugin = true;
+							} else if (args.length === 1 && Node.isObjectLiteralExpression(args[0])) {
 								const configObj = args[0];
 								if (!configObj.getProperty("target")) configObj.addPropertyAssignment({
 									name: "target",
 									initializer: "\"cloudflare-module\""
 								});
-								if (!configObj.getProperty("customViteReactPlugin")) configObj.addPropertyAssignment({
+								const hasCustomViteReactPlugin = !!configObj.getProperty("customViteReactPlugin");
+								if (!hasCustomViteReactPlugin) configObj.addPropertyAssignment({
 									name: "customViteReactPlugin",
 									initializer: "true"
 								});
+								needsReactPlugin = true;
 							}
 						}
 					});
+					const hasReactPlugin = initializer.getElements().some((el) => Node.isCallExpression(el) && el.getExpression().getText() === reactPluginIdentifier);
+					if (needsReactPlugin && !hasReactPlugin) initializer.addElement(`${reactPluginIdentifier}()`);
 				}
 			} else configObject.addPropertyAssignment({
 				name: "plugins",
@@ -3631,6 +3637,17 @@ async function setupTanstackStartWorkersDeploy(projectDir, packageManager) {
 	if (!await fs.pathExists(viteConfigPath)) return;
 	const sourceFile = tsProject.addSourceFileAtPathIfExists(viteConfigPath);
 	if (!sourceFile) return;
+	const reactImport = sourceFile.getImportDeclaration("@vitejs/plugin-react");
+	let reactPluginIdentifier = "viteReact";
+	if (!reactImport) sourceFile.addImportDeclaration({
+		moduleSpecifier: "@vitejs/plugin-react",
+		defaultImport: "viteReact"
+	});
+	else {
+		const defaultImport = reactImport.getDefaultImport();
+		if (defaultImport) reactPluginIdentifier = defaultImport.getText();
+		else reactImport.setDefaultImport("viteReact");
+	}
 	const defineCall = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).find((expr) => {
 		const expression = expr.getExpression();
 		return Node.isIdentifier(expression) && expression.getText() === "defineConfig";
@@ -3640,9 +3657,15 @@ async function setupTanstackStartWorkersDeploy(projectDir, packageManager) {
 	if (!configObj) return;
 	const pluginsArray = ensureArrayProperty(configObj, "plugins");
 	const tanstackPluginIndex = pluginsArray.getElements().findIndex((el) => el.getText().includes("tanstackStart("));
-	const tanstackPluginText = "tanstackStart({ target: \"cloudflare-module\" })";
+	const tanstackPluginText = "tanstackStart({ target: \"cloudflare-module\", customViteReactPlugin: true })";
 	if (tanstackPluginIndex === -1) pluginsArray.addElement(tanstackPluginText);
 	else pluginsArray.getElements()[tanstackPluginIndex].replaceWithText(tanstackPluginText);
+	const hasReactPlugin = pluginsArray.getElements().some((el) => Node.isCallExpression(el) && el.getExpression().getText() === reactPluginIdentifier);
+	if (!hasReactPlugin) {
+		const nextIndex = pluginsArray.getElements().findIndex((el) => el.getText().includes("tanstackStart(")) + 1;
+		if (nextIndex > 0) pluginsArray.insertElement(nextIndex, `${reactPluginIdentifier}()`);
+		else pluginsArray.addElement(`${reactPluginIdentifier}()`);
+	}
 	await tsProject.save();
 }
 
@@ -6297,7 +6320,8 @@ const router = t.router({
 		serverDeploy: ServerDeploySchema.optional(),
 		directoryConflict: DirectoryConflictSchema.optional(),
 		renderTitle: z.boolean().optional(),
-		disableAnalytics: z.boolean().optional().default(false).describe("Disable analytics")
+		disableAnalytics: z.boolean().optional().default(false).describe("Disable analytics"),
+		mcp: z.boolean().optional().default(false).describe("Start as MCP server")
 	})])).mutation(async ({ input }) => {
 		const [projectName, options] = input;
 		const combinedInput = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.35.3",
+  "version": "2.35.5-canary.449f72a5",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",
@@ -67,6 +67,7 @@
     "@biomejs/js-api": "^3.0.0",
     "@biomejs/wasm-nodejs": "^2.2.0",
     "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/sdk": "^0.4.0",
     "consola": "^3.4.2",
     "execa": "^9.6.0",
     "fs-extra": "^11.3.1",

package/templates/backend/server/server-base/tsconfig.json.hbs

@@ -8,28 +8,23 @@
     "skipLibCheck": true,
     "baseUrl": "./",
     "paths": {
-      "@/*": ["./src/*"]
-      {{#if (eq orm "prisma")}},
-      "prisma": ["node_modules/prisma"]
-      {{/if}}
+      "@/*": ["./src/*"]{{#if (eq orm "prisma")}},
+      "prisma": ["node_modules/prisma"]{{/if}}
     },
     "outDir": "./dist",
     "types": [
       {{#if (eq runtime "node")}}
-      "node"
+        "node"
       {{else if (eq runtime "bun")}}
-      "bun"
+        "bun"
       {{else if (eq runtime "workers")}}
-      "@cloudflare/workers-types",
-      "node"
+        "node"
       {{else}}
-      "node",
-      "bun"
+        "node",
+        "bun"
       {{/if}}
-    ],
-    {{#unless (or (eq backend "convex") (eq backend "none"))}}
-    "composite": true,
-    {{/unless}}
+    ]{{#unless (or (eq backend "convex") (eq backend "none"))}},
+    "composite": true{{/unless}},
     "jsx": "react-jsx"{{#if (eq backend "hono")}},
     "jsxImportSource": "hono/jsx"{{/if}}
   }

package/templates/frontend/react/tanstack-start/package.json.hbs

@@ -35,7 +35,7 @@
     "@testing-library/react": "^16.2.0",
     "@types/react": "^19.0.12",
     "@types/react-dom": "^19.0.4",
-    "@vitejs/plugin-react": "^4.5.2",
+    "@vitejs/plugin-react": "^5.0.1",
     "jsdom": "^26.0.0",
     "typescript": "^5.7.2",
     "vite": "^7.0.2",

package/templates/frontend/react/tanstack-start/{vite.config.ts → vite.config.ts.hbs}

@@ -2,7 +2,13 @@ import { defineConfig } from "vite";
 import tsconfigPaths from "vite-tsconfig-paths";
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import tailwindcss from "@tailwindcss/vite";
+import viteReact from "@vitejs/plugin-react";
 
 export default defineConfig({
-  plugins: [tsconfigPaths(), tailwindcss(), tanstackStart({})],
+  plugins: [
+    tsconfigPaths(),
+    tailwindcss(),
+    tanstackStart({ customViteReactPlugin: true }),
+    viteReact(),
+  ],
 });