create-better-t-stack 2.22.5 → 2.22.6

package/README.md

@@ -27,12 +27,12 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **TypeScript**           | End-to-end type safety across all parts of your application                                                                                                                                                                                                |
 | **Frontend**             | • React with TanStack Router<br>• React with React Router<br>• React with TanStack Start (SSR)<br>• Next.js<br>• SvelteKit<br>• Nuxt (Vue)<br>• SolidJS<br>• React Native with NativeWind (via Expo)<br>• React Native with Unistyles (via Expo)<br>• None |
-| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Next.js API routes<br>• Convex<br>• Fastify<br>• None                                                                                                                                                                              |
+| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Next.js API routes<br>• Convex<br>• Fastify<br>• None                                                                                                                                                                 |
 | **API Layer**            | • tRPC (type-safe APIs)<br>• oRPC (OpenAPI-compatible type-safe APIs)<br>• None                                                                                                                                                                            |
-| **Runtime**              | • Bun<br>• Node.js                                                                                                                                                                                                                                         |
+| **Runtime**              | • Bun<br>• Node.js<br>• Cloudflare Workers<br>• None                                                                                                                                                                                                       |
 | **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• None                                                                                                                                                                                                 |
 | **ORM**                  | • Drizzle (TypeScript-first)<br>• Prisma (feature-rich)<br>• Mongoose (for MongoDB)<br>• None                                                                                                                                                              |
-| **Database Setup**       | • Turso (SQLite)<br>• Neon (PostgreSQL)<br>• Prisma Postgres (via Prisma Accelerate)<br>• MongoDB Atlas<br>• None (manual setup)                                                                                                                           |
+| **Database Setup**       | • Turso (SQLite)<br>• Cloudflare D1 (SQLite)<br>• Neon (PostgreSQL)<br>• Supabase (PostgreSQL)<br>• Prisma Postgres (via Prisma Accelerate)<br>• MongoDB Atlas<br>• None (manual setup)                                                                    |
 | **Authentication**       | Better-Auth (email/password, with more options coming soon)                                                                                                                                                                                                |
 | **Styling**              | Tailwind CSS with shadcn/ui components                                                                                                                                                                                                                     |
 | **Addons**               | • PWA support<br>• Tauri (desktop applications)<br>• Starlight (documentation site)<br>• Biome (linting and formatting)<br>• Husky (Git hooks)<br>• Turborepo (optimized builds)                                                                           |
@@ -59,9 +59,9 @@ Options:
   --package-manager <pm>          Package manager (npm, pnpm, bun)
   --install                       Install dependencies
   --no-install                    Skip installing dependencies
-  --db-setup <setup>              Database setup (turso, neon, prisma-postgres, mongodb-atlas, none)
+  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, none)
   --backend <framework>           Backend framework (hono, express, elysia, next, convex, fastify, none)
-  --runtime <runtime>             Runtime (bun, node, none)
+  --runtime <runtime>             Runtime (bun, node, workers, none)
   --api <type>                    API type (trpc, orpc, none)
   -h, --help                      Display help
 ```
@@ -104,6 +104,12 @@ Create a project with Turso database setup:
 npx create-better-t-stack my-app --database sqlite --orm drizzle --db-setup turso
 ```
 
+Create a project with Supabase PostgreSQL setup:
+
+```bash
+npx create-better-t-stack my-app --database postgres --orm drizzle --db-setup supabase --auth
+```
+
 Create a project with Convex backend:
 
 ```bash
@@ -116,10 +122,48 @@ Create a project with documentation site:
 npx create-better-t-stack my-app --addons starlight
 ```
 
+Create a minimal TypeScript project with no backend:
+
+```bash
+npx create-better-t-stack my-app --backend none --frontend tanstack-router
+```
+
+Create a backend-only project with no frontend:
+
+```bash
+npx create-better-t-stack my-app --frontend none --backend hono --database postgres --orm drizzle
+```
+
+Create a simple frontend-only project:
+
+```bash
+npx create-better-t-stack my-app --backend none --frontend next --addons none --examples none
+```
+
+Create a Cloudflare Workers project:
+
+```bash
+npx create-better-t-stack my-app --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1
+```
+
+Create a minimal API-only project:
+
+```bash
+npx create-better-t-stack my-app --frontend none --backend hono --api trpc --database none --addons none
+```
+
 ## Compatibility Notes
 
 - **Convex backend**: Automatically disables authentication, database, ORM, and API options
 - **Backend 'none'**: If selected, this option will force related options like API, ORM, database, authentication, and runtime to 'none'. Examples will also be disabled (set to none/empty).
+- **Frontend 'none'**: Creates a backend-only project. When selected, PWA, Tauri, and certain examples may be disabled.
+- **API 'none'**: Disables tRPC/oRPC setup. Can be used with backend frameworks for REST APIs or custom API implementations.
+- **Database 'none'**: Disables database setup. Automatically sets ORM to 'none' and disables authentication.
+- **ORM 'none'**: Can be used when you want to handle database operations manually or use a different ORM.
+- **Runtime 'none'**: Only available with Convex backend or when backend is 'none'.
+- **Cloudflare Workers runtime**: Only compatible with Hono backend, Drizzle ORM (or no ORM), and SQLite database (with D1 setup). Not compatible with MongoDB.
+- **Addons 'none'**: Skips all addons (PWA, Tauri, Starlight, Biome, Husky, Turborepo).
+- **Examples 'none'**: Skips all example implementations (todo, AI chat).
 - **SvelteKit, Nuxt, and SolidJS** frontends are only compatible with oRPC API layer
 - **PWA support** requires React with TanStack Router, React Router, or SolidJS
 - **Tauri desktop app** requires React (TanStack Router/React Router), Nuxt, SvelteKit, or SolidJS

package/dist/index.js

@@ -94,7 +94,7 @@ const dependencyVersionMap = {
 	"@trpc/tanstack-react-query": "^11.4.2",
 	"@trpc/server": "^11.4.2",
 	"@trpc/client": "^11.4.2",
-	convex: "^1.23.0",
+	convex: "^1.25.0",
 	"@convex-dev/react-query": "^0.0.0-alpha.8",
 	"convex-svelte": "^0.0.11",
 	"@tanstack/svelte-query": "^5.74.4",
@@ -3579,19 +3579,15 @@ function generateReadmeContent(options) {
 	const { projectName, packageManager, database, auth, addons = [], orm = "drizzle", runtime = "bun", frontend = ["tanstack-router"], backend = "hono", api = "trpc" } = options;
 	const isConvex = backend === "convex";
 	const hasReactRouter = frontend.includes("react-router");
-	const hasTanstackRouter = frontend.includes("tanstack-router");
 	const hasNative = frontend.includes("native-nativewind") || frontend.includes("native-unistyles");
-	const hasNext = frontend.includes("next");
-	const hasTanstackStart = frontend.includes("tanstack-start");
 	const hasSvelte = frontend.includes("svelte");
-	const hasSolid = frontend.includes("solid");
-	const hasNuxt = frontend.includes("nuxt");
 	const packageManagerRunCmd = packageManager === "npm" ? "npm run" : packageManager;
 	let webPort = "3001";
 	if (hasReactRouter || hasSvelte) webPort = "5173";
+	const stackDescription = generateStackDescription(frontend, backend, api, isConvex);
 	return `# ${projectName}
 
-This project was created with [Better-T-Stack](https://github.com/AmanVarshney01/create-better-t-stack), a modern TypeScript stack that combines ${hasTanstackRouter ? "React, TanStack Router" : hasReactRouter ? "React, React Router" : hasNext ? "Next.js" : hasTanstackStart ? "React, TanStack Start" : hasSvelte ? "SvelteKit" : hasNuxt ? "Nuxt" : hasSolid ? "SolidJS" : ""}, ${backend[0].toUpperCase() + backend.slice(1)}${isConvex ? "" : `, ${api.toUpperCase()}`}, and more.
+This project was created with [Better-T-Stack](https://github.com/AmanVarshney01/create-better-t-stack), a modern TypeScript stack${stackDescription ? ` that combines ${stackDescription}` : ""}.
 
 ## Features
 
@@ -3621,18 +3617,14 @@ Then, run the development server:
 ${packageManagerRunCmd} dev
 \`\`\`
 
-${hasTanstackRouter || hasReactRouter || hasNext || hasTanstackStart || hasSvelte || hasNuxt || hasSolid ? `Open [http://localhost:${webPort}](http://localhost:${webPort}) in your browser to see the web application.` : ""}
-${hasNative ? "Use the Expo Go app to run the mobile application.\n" : ""}
-${isConvex ? "Your app will connect to the Convex cloud backend automatically." : "The API is running at [http://localhost:3000](http://localhost:3000)."}
+${generateRunningInstructions(frontend, backend, webPort, hasNative, isConvex)}
 
 ${addons.includes("pwa") && hasReactRouter ? "\n## PWA Support with React Router v7\n\nThere is a known compatibility issue between VitePWA and React Router v7.\nSee: https://github.com/vite-pwa/vite-plugin-pwa/issues/809\n" : ""}
 
 ## Project Structure
 
 \`\`\`
-${projectName}/
-├── apps/
-${hasTanstackRouter || hasReactRouter || hasNext || hasTanstackStart || hasSvelte || hasNuxt || hasSolid ? `│   ├── web/         # Frontend application (${hasTanstackRouter ? "React + TanStack Router" : hasReactRouter ? "React + React Router" : hasNext ? "Next.js" : hasTanstackStart ? "React + TanStack Start" : hasSvelte ? "SvelteKit" : hasNuxt ? "Nuxt" : hasSolid ? "SolidJS" : ""})\n` : ""}${hasNative ? "│   ├── native/      # Mobile application (React Native, Expo)\n" : ""}${addons.includes("starlight") ? "│   ├── docs/        # Documentation site (Astro Starlight)\n" : ""}${isConvex ? "├── packages/\n│   └── backend/     # Convex backend functions and schema\n" : `│   └── server/      # Backend API (${backend[0].toUpperCase() + backend.slice(1)}, ${api.toUpperCase()})`}
+${generateProjectStructure(projectName, frontend, backend, addons, isConvex, api)}
 \`\`\`
 
 ## Available Scripts
@@ -3640,8 +3632,89 @@ ${hasTanstackRouter || hasReactRouter || hasNext || hasTanstackStart || hasSvelt
 ${generateScriptsList(packageManagerRunCmd, database, orm, auth, hasNative, addons, backend)}
 `;
 }
+function generateStackDescription(frontend, backend, api, isConvex) {
+	const parts = [];
+	const hasTanstackRouter = frontend.includes("tanstack-router");
+	const hasReactRouter = frontend.includes("react-router");
+	const hasNext = frontend.includes("next");
+	const hasTanstackStart = frontend.includes("tanstack-start");
+	const hasSvelte = frontend.includes("svelte");
+	const hasNuxt = frontend.includes("nuxt");
+	const hasSolid = frontend.includes("solid");
+	const hasFrontendNone = frontend.length === 0 || frontend.includes("none");
+	if (!hasFrontendNone) {
+		if (hasTanstackRouter) parts.push("React, TanStack Router");
+		else if (hasReactRouter) parts.push("React, React Router");
+		else if (hasNext) parts.push("Next.js");
+		else if (hasTanstackStart) parts.push("React, TanStack Start");
+		else if (hasSvelte) parts.push("SvelteKit");
+		else if (hasNuxt) parts.push("Nuxt");
+		else if (hasSolid) parts.push("SolidJS");
+	}
+	if (backend !== "none") parts.push(backend[0].toUpperCase() + backend.slice(1));
+	if (!isConvex && api !== "none") parts.push(api.toUpperCase());
+	return parts.length > 0 ? `${parts.join(", ")}, and more` : "";
+}
+function generateRunningInstructions(frontend, backend, webPort, hasNative, isConvex) {
+	const instructions = [];
+	const hasFrontendNone = frontend.length === 0 || frontend.includes("none");
+	const isBackendNone = backend === "none";
+	if (!hasFrontendNone) {
+		const hasTanstackRouter = frontend.includes("tanstack-router");
+		const hasReactRouter = frontend.includes("react-router");
+		const hasNext = frontend.includes("next");
+		const hasTanstackStart = frontend.includes("tanstack-start");
+		const hasSvelte = frontend.includes("svelte");
+		const hasNuxt = frontend.includes("nuxt");
+		const hasSolid = frontend.includes("solid");
+		if (hasTanstackRouter || hasReactRouter || hasNext || hasTanstackStart || hasSvelte || hasNuxt || hasSolid) instructions.push(`Open [http://localhost:${webPort}](http://localhost:${webPort}) in your browser to see the web application.`);
+	}
+	if (hasNative) instructions.push("Use the Expo Go app to run the mobile application.");
+	if (isConvex) instructions.push("Your app will connect to the Convex cloud backend automatically.");
+	else if (!isBackendNone) instructions.push("The API is running at [http://localhost:3000](http://localhost:3000).");
+	return instructions.join("\n");
+}
+function generateProjectStructure(projectName, frontend, backend, addons, isConvex, api) {
+	const structure = [`${projectName}/`, "├── apps/"];
+	const hasFrontendNone = frontend.length === 0 || frontend.includes("none");
+	const isBackendNone = backend === "none";
+	if (!hasFrontendNone) {
+		const hasTanstackRouter = frontend.includes("tanstack-router");
+		const hasReactRouter = frontend.includes("react-router");
+		const hasNext = frontend.includes("next");
+		const hasTanstackStart = frontend.includes("tanstack-start");
+		const hasSvelte = frontend.includes("svelte");
+		const hasNuxt = frontend.includes("nuxt");
+		const hasSolid = frontend.includes("solid");
+		if (hasTanstackRouter || hasReactRouter || hasNext || hasTanstackStart || hasSvelte || hasNuxt || hasSolid) {
+			let frontendType = "";
+			if (hasTanstackRouter) frontendType = "React + TanStack Router";
+			else if (hasReactRouter) frontendType = "React + React Router";
+			else if (hasNext) frontendType = "Next.js";
+			else if (hasTanstackStart) frontendType = "React + TanStack Start";
+			else if (hasSvelte) frontendType = "SvelteKit";
+			else if (hasNuxt) frontendType = "Nuxt";
+			else if (hasSolid) frontendType = "SolidJS";
+			structure.push(`│   ├── web/         # Frontend application (${frontendType})`);
+		}
+	}
+	const hasNative = frontend.includes("native-nativewind") || frontend.includes("native-unistyles");
+	if (hasNative) structure.push("│   ├── native/      # Mobile application (React Native, Expo)");
+	if (addons.includes("starlight")) structure.push("│   ├── docs/        # Documentation site (Astro Starlight)");
+	if (isConvex) {
+		structure.push("├── packages/");
+		structure.push("│   └── backend/     # Convex backend functions and schema");
+	} else if (!isBackendNone) {
+		const backendName = backend[0].toUpperCase() + backend.slice(1);
+		const apiName = api !== "none" ? api.toUpperCase() : "";
+		const backendDesc = apiName ? `${backendName}, ${apiName}` : backendName;
+		structure.push(`│   └── server/      # Backend API (${backendDesc})`);
+	}
+	return structure.join("\n");
+}
 function generateFeaturesList(database, auth, addons, orm, runtime, frontend, backend, api) {
 	const isConvex = backend === "convex";
+	const isBackendNone = backend === "none";
 	const hasTanstackRouter = frontend.includes("tanstack-router");
 	const hasReactRouter = frontend.includes("react-router");
 	const hasNative = frontend.includes("native-nativewind") || frontend.includes("native-unistyles");
@@ -3650,21 +3723,24 @@ function generateFeaturesList(database, auth, addons, orm, runtime, frontend, ba
 	const hasSvelte = frontend.includes("svelte");
 	const hasNuxt = frontend.includes("nuxt");
 	const hasSolid = frontend.includes("solid");
+	const hasFrontendNone = frontend.length === 0 || frontend.includes("none");
 	const addonsList = ["- **TypeScript** - For type safety and improved developer experience"];
-	if (hasTanstackRouter) addonsList.push("- **TanStack Router** - File-based routing with full type safety");
-	else if (hasReactRouter) addonsList.push("- **React Router** - Declarative routing for React");
-	else if (hasNext) addonsList.push("- **Next.js** - Full-stack React framework");
-	else if (hasTanstackStart) addonsList.push("- **TanStack Start** - SSR framework with TanStack Router");
-	else if (hasSvelte) addonsList.push("- **SvelteKit** - Web framework for building Svelte apps");
-	else if (hasNuxt) addonsList.push("- **Nuxt** - The Intuitive Vue Framework");
-	else if (hasSolid) addonsList.push("- **SolidJS** - Simple and performant reactivity");
+	if (!hasFrontendNone) {
+		if (hasTanstackRouter) addonsList.push("- **TanStack Router** - File-based routing with full type safety");
+		else if (hasReactRouter) addonsList.push("- **React Router** - Declarative routing for React");
+		else if (hasNext) addonsList.push("- **Next.js** - Full-stack React framework");
+		else if (hasTanstackStart) addonsList.push("- **TanStack Start** - SSR framework with TanStack Router");
+		else if (hasSvelte) addonsList.push("- **SvelteKit** - Web framework for building Svelte apps");
+		else if (hasNuxt) addonsList.push("- **Nuxt** - The Intuitive Vue Framework");
+		else if (hasSolid) addonsList.push("- **SolidJS** - Simple and performant reactivity");
+	}
 	if (hasNative) {
 		addonsList.push("- **React Native** - Build mobile apps using React");
 		addonsList.push("- **Expo** - Tools for React Native development");
 	}
-	addonsList.push("- **TailwindCSS** - Utility-first CSS for rapid UI development", "- **shadcn/ui** - Reusable UI components");
+	if (!hasFrontendNone) addonsList.push("- **TailwindCSS** - Utility-first CSS for rapid UI development", "- **shadcn/ui** - Reusable UI components");
 	if (isConvex) addonsList.push("- **Convex** - Reactive backend-as-a-service platform");
-	else {
+	else if (!isBackendNone) {
 		if (backend === "hono") addonsList.push("- **Hono** - Lightweight, performant server framework");
 		else if (backend === "express") addonsList.push("- **Express** - Fast, unopinionated web framework");
 		else if (backend === "fastify") addonsList.push("- **Fastify** - Fast, low-overhead web framework");
@@ -3672,9 +3748,13 @@ function generateFeaturesList(database, auth, addons, orm, runtime, frontend, ba
 		else if (backend === "next") addonsList.push("- **Next.js** - Full-stack React framework");
 		if (api === "trpc") addonsList.push("- **tRPC** - End-to-end type-safe APIs");
 		else if (api === "orpc") addonsList.push("- **oRPC** - End-to-end type-safe APIs with OpenAPI integration");
-		addonsList.push(`- **${runtime === "bun" ? "Bun" : "Node.js"}** - Runtime environment`);
+		if (runtime !== "none") addonsList.push(`- **${runtime === "bun" ? "Bun" : runtime === "node" ? "Node.js" : runtime}** - Runtime environment`);
+	}
+	if (database !== "none" && !isConvex) {
+		const ormName = orm === "drizzle" ? "Drizzle" : orm === "prisma" ? "Prisma" : orm === "mongoose" ? "Mongoose" : "ORM";
+		const dbName = database === "sqlite" ? "SQLite/Turso" : database === "postgres" ? "PostgreSQL" : database === "mysql" ? "MySQL" : database === "mongodb" ? "MongoDB" : "Database";
+		addonsList.push(`- **${ormName}** - TypeScript-first ORM`, `- **${dbName}** - Database engine`);
 	}
-	if (database !== "none" && !isConvex) addonsList.push(`- **${orm === "drizzle" ? "Drizzle" : orm === "prisma" ? "Prisma" : "Mongoose"}** - TypeScript-first ORM`, `- **${database === "sqlite" ? "SQLite/Turso" : database === "postgres" ? "PostgreSQL" : database === "mysql" ? "MySQL" : "MongoDB"}** - Database engine`);
 	if (auth && !isConvex) addonsList.push("- **Authentication** - Email & password authentication with Better Auth");
 	for (const addon of addons) if (addon === "pwa") addonsList.push("- **PWA** - Progressive Web App support");
 	else if (addon === "tauri") addonsList.push("- **Tauri** - Build native desktop applications");
@@ -3684,10 +3764,10 @@ function generateFeaturesList(database, auth, addons, orm, runtime, frontend, ba
 	else if (addon === "turborepo") addonsList.push("- **Turborepo** - Optimized monorepo build system");
 	return addonsList.join("\n");
 }
-function generateDatabaseSetup(database, auth, packageManagerRunCmd, orm) {
+function generateDatabaseSetup(database, _auth, packageManagerRunCmd, orm) {
 	if (database === "none") return "";
 	let setup = "## Database Setup\n\n";
-	if (database === "sqlite") setup += `This project uses SQLite${orm === "drizzle" ? " with Drizzle ORM" : " with Prisma"}.
+	if (database === "sqlite") setup += `This project uses SQLite${orm === "drizzle" ? " with Drizzle ORM" : orm === "prisma" ? " with Prisma" : ` with ${orm}`}.
 
 1. Start the local SQLite database:
 \`\`\`bash
@@ -3696,23 +3776,23 @@ cd apps/server && ${packageManagerRunCmd} db:local
 
 2. Update your \`.env\` file in the \`apps/server\` directory with the appropriate connection details if needed.
 `;
-	else if (database === "postgres") setup += `This project uses PostgreSQL${orm === "drizzle" ? " with Drizzle ORM" : " with Prisma"}.
+	else if (database === "postgres") setup += `This project uses PostgreSQL${orm === "drizzle" ? " with Drizzle ORM" : orm === "prisma" ? " with Prisma" : ` with ${orm}`}.
 
 1. Make sure you have a PostgreSQL database set up.
 2. Update your \`apps/server/.env\` file with your PostgreSQL connection details.
 `;
-	else if (database === "mysql") setup += `This project uses MySQL${orm === "drizzle" ? " with Drizzle ORM" : " with Prisma"}.
+	else if (database === "mysql") setup += `This project uses MySQL${orm === "drizzle" ? " with Drizzle ORM" : orm === "prisma" ? " with Prisma" : ` with ${orm}`}.
 
 1. Make sure you have a MySQL database set up.
 2. Update your \`apps/server/.env\` file with your MySQL connection details.
 `;
-	else if (database === "mongodb") setup += `This project uses MongoDB ${orm === "mongoose" ? "with Mongoose" : "with Prisma ORM"}.
+	else if (database === "mongodb") setup += `This project uses MongoDB ${orm === "mongoose" ? "with Mongoose" : orm === "prisma" ? "with Prisma ORM" : `with ${orm}`}.
 
 1. Make sure you have MongoDB set up.
 2. Update your \`apps/server/.env\` file with your MongoDB connection URI.
 `;
 	setup += `
-${auth ? "3" : "3"}. ${orm === "prisma" ? `Generate the Prisma client and push the schema:
+3. ${orm === "prisma" ? `Generate the Prisma client and push the schema:
 \`\`\`bash
 ${packageManagerRunCmd} db:push
 \`\`\`` : orm === "drizzle" ? `Apply the schema to your database:
@@ -3727,12 +3807,14 @@ ${packageManagerRunCmd} db:push
 }
 function generateScriptsList(packageManagerRunCmd, database, orm, _auth, hasNative, addons, backend) {
 	const isConvex = backend === "convex";
+	const isBackendNone = backend === "none";
 	let scripts = `- \`${packageManagerRunCmd} dev\`: Start all applications in development mode
-- \`${packageManagerRunCmd} build\`: Build all applications
+- \`${packageManagerRunCmd} build\`: Build all applications`;
+	scripts += `
 - \`${packageManagerRunCmd} dev:web\`: Start only the web application`;
 	if (isConvex) scripts += `
 - \`${packageManagerRunCmd} dev:setup\`: Setup and configure your Convex project`;
-	else scripts += `
+	else if (!isBackendNone) scripts += `
 - \`${packageManagerRunCmd} dev:server\`: Start only the server`;
 	scripts += `
 - \`${packageManagerRunCmd} check-types\`: Check TypeScript types across all apps`;
@@ -3793,6 +3875,7 @@ function displayPostInstallInstructions(config) {
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
 	if (isConvex) {
 		output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev:setup ${pc.dim("(this will guide you through Convex project setup)")}\n`;
+		output += `${pc.cyan(`${stepCounter++}.`)} Copy environment variables from ${pc.white("packages/backend/.env.local")} \nto ${pc.white("apps/*/.env")}\n`;
 		output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n\n`;
 	} else {
 		if (runtime !== "workers") output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n`;
@@ -3904,7 +3987,7 @@ async function updateRootPackageJson(projectDir, options) {
 		scripts["dev:native"] = "turbo -F native dev";
 		scripts["dev:web"] = "turbo -F web dev";
 		scripts["dev:server"] = serverDevScript;
-		if (options.backend === "convex") scripts["dev:setup"] = `turbo -F ${backendPackageName} setup`;
+		if (options.backend === "convex") scripts["dev:setup"] = `turbo -F ${backendPackageName} dev:setup`;
 		if (needsDbScripts) {
 			scripts["db:push"] = `turbo -F ${backendPackageName} db:push`;
 			scripts["db:studio"] = `turbo -F ${backendPackageName} db:studio`;
@@ -3923,7 +4006,7 @@ async function updateRootPackageJson(projectDir, options) {
 		scripts["dev:native"] = "pnpm --filter native dev";
 		scripts["dev:web"] = "pnpm --filter web dev";
 		scripts["dev:server"] = serverDevScript;
-		if (options.backend === "convex") scripts["dev:setup"] = `pnpm --filter ${backendPackageName} setup`;
+		if (options.backend === "convex") scripts["dev:setup"] = `pnpm --filter ${backendPackageName} dev:setup`;
 		if (needsDbScripts) {
 			scripts["db:push"] = `pnpm --filter ${backendPackageName} db:push`;
 			scripts["db:studio"] = `pnpm --filter ${backendPackageName} db:studio`;
@@ -3942,7 +4025,7 @@ async function updateRootPackageJson(projectDir, options) {
 		scripts["dev:native"] = "npm run dev --workspace native";
 		scripts["dev:web"] = "npm run dev --workspace web";
 		scripts["dev:server"] = serverDevScript;
-		if (options.backend === "convex") scripts["dev:setup"] = `npm run setup --workspace ${backendPackageName}`;
+		if (options.backend === "convex") scripts["dev:setup"] = `npm run dev:setup --workspace ${backendPackageName}`;
 		if (needsDbScripts) {
 			scripts["db:push"] = `npm run db:push --workspace ${backendPackageName}`;
 			scripts["db:studio"] = `npm run db:studio --workspace ${backendPackageName}`;
@@ -3961,7 +4044,7 @@ async function updateRootPackageJson(projectDir, options) {
 		scripts["dev:native"] = "bun run --filter native dev";
 		scripts["dev:web"] = "bun run --filter web dev";
 		scripts["dev:server"] = serverDevScript;
-		if (options.backend === "convex") scripts["dev:setup"] = `bun run --filter ${backendPackageName} setup`;
+		if (options.backend === "convex") scripts["dev:setup"] = `bun run --filter ${backendPackageName} dev:setup`;
 		if (needsDbScripts) {
 			scripts["db:push"] = `bun run --filter ${backendPackageName} db:push`;
 			scripts["db:studio"] = `bun run --filter ${backendPackageName} db:studio`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.22.5",
+  "version": "2.22.6",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",

package/templates/addons/turborepo/turbo.json.hbs

@@ -17,7 +17,7 @@
 			"cache": false,
 			"persistent": true
 		}{{#if (eq backend "convex")}},
-		"setup": {
+		"dev:setup": {
 			"cache": false,
 			"persistent": true
 		}

package/templates/backend/convex/packages/backend/package.json.hbs

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "scripts": {
     "dev": "convex dev",
-    "setup": "convex dev --configure --until-success"
+    "dev:setup": "convex dev --configure --until-success"
   },
   "author": "",
   "license": "ISC",
@@ -12,6 +12,6 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "convex": "^1.23.0"
+    "convex": "^1.25.0"
   }
 }