create-better-t-stack 2.40.3-canary.50a1b944 → 2.40.4-canary.49f23d48

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createBtsCli } from "./src-D59j3XG5.js";
+import { createBtsCli } from "./src-D32Mc1TH.js";
 
 //#region src/cli.ts
 createBtsCli().run();

package/dist/index.d.ts

@@ -80,6 +80,7 @@ declare const DatabaseSetupSchema: z.ZodEnum<{
   turso: "turso";
   neon: "neon";
   "prisma-postgres": "prisma-postgres";
+  planetscale: "planetscale";
   "mongodb-atlas": "mongodb-atlas";
   supabase: "supabase";
   d1: "d1";
@@ -218,7 +219,7 @@ declare const router: trpcServer.TRPCBuiltRouter<{
       git?: boolean | undefined;
       packageManager?: "npm" | "pnpm" | "bun" | undefined;
       install?: boolean | undefined;
-      dbSetup?: "none" | "turso" | "neon" | "prisma-postgres" | "mongodb-atlas" | "supabase" | "d1" | "docker" | undefined;
+      dbSetup?: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "d1" | "docker" | undefined;
       backend?: "none" | "next" | "hono" | "express" | "fastify" | "elysia" | "convex" | undefined;
       runtime?: "none" | "bun" | "node" | "workers" | undefined;
       api?: "none" | "trpc" | "orpc" | undefined;

package/dist/index.js

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

package/dist/{src-D59j3XG5.js → src-D32Mc1TH.js}

@@ -67,6 +67,7 @@ const dependencyVersionMap = {
 	"@clerk/clerk-expo": "^2.14.25",
 	"drizzle-orm": "^0.44.2",
 	"drizzle-kit": "^0.31.2",
+	"@planetscale/database": "^1.19.0",
 	"@libsql/client": "^0.15.9",
 	"@neondatabase/serverless": "^1.0.1",
 	pg: "^8.14.1",
@@ -76,7 +77,10 @@ const dependencyVersionMap = {
 	mysql2: "^3.14.0",
 	"@prisma/client": "^6.15.0",
 	prisma: "^6.15.0",
+	"@prisma/adapter-d1": "^6.15.0",
 	"@prisma/extension-accelerate": "^2.0.2",
+	"@prisma/adapter-planetscale": "^6.15.0",
+	undici: "^7.15.0",
 	mongoose: "^8.14.0",
 	"vite-plugin-pwa": "^1.0.1",
 	"@vite-pwa/assets-generator": "^1.0.0",
@@ -110,6 +114,8 @@ const dependencyVersionMap = {
 	streamdown: "^1.1.6",
 	"@orpc/server": "^1.8.6",
 	"@orpc/client": "^1.8.6",
+	"@orpc/openapi": "^1.8.6",
+	"@orpc/zod": "^1.8.6",
 	"@orpc/tanstack-query": "^1.8.6",
 	"@trpc/tanstack-react-query": "^11.5.0",
 	"@trpc/server": "^11.5.0",
@@ -134,7 +140,7 @@ const dependencyVersionMap = {
 	"nitro-cloudflare-dev": "^0.2.2",
 	"@sveltejs/adapter-cloudflare": "^7.2.1",
 	"@cloudflare/workers-types": "^4.20250822.0",
-	alchemy: "^0.63.0",
+	alchemy: "^0.65.0",
 	nitropack: "^2.12.4",
 	dotenv: "^17.2.1"
 };
@@ -233,6 +239,7 @@ const DatabaseSetupSchema = z.enum([
 	"turso",
 	"neon",
 	"prisma-postgres",
+	"planetscale",
 	"mongodb-atlas",
 	"supabase",
 	"d1",
@@ -737,11 +744,10 @@ async function getDatabaseChoice(database, backend, runtime) {
 
 //#endregion
 //#region src/prompts/database-setup.ts
-async function getDBSetupChoice(databaseType, dbSetup, orm, backend, runtime) {
+async function getDBSetupChoice(databaseType, dbSetup, _orm, backend, runtime) {
 	if (backend === "convex") return "none";
 	if (dbSetup !== void 0) return dbSetup;
 	if (databaseType === "none") return "none";
-	if (databaseType === "sqlite" && orm === "prisma") return "none";
 	let options = [];
 	if (databaseType === "sqlite") options = [
 		{
@@ -766,6 +772,11 @@ async function getDBSetupChoice(databaseType, dbSetup, orm, backend, runtime) {
 			label: "Neon Postgres",
 			hint: "Serverless Postgres with branching capability"
 		},
+		{
+			value: "planetscale",
+			label: "PlanetScale",
+			hint: "Serverless MySQL platform with branching (Postgres compatible)"
+		},
 		{
 			value: "supabase",
 			label: "Supabase",
@@ -787,15 +798,23 @@ async function getDBSetupChoice(databaseType, dbSetup, orm, backend, runtime) {
 			hint: "Manual setup"
 		}
 	];
-	else if (databaseType === "mysql") options = [{
-		value: "docker",
-		label: "Docker",
-		hint: "Run locally with docker compose"
-	}, {
-		value: "none",
-		label: "None",
-		hint: "Manual setup"
-	}];
+	else if (databaseType === "mysql") options = [
+		{
+			value: "planetscale",
+			label: "PlanetScale",
+			hint: "Serverless MySQL platform with branching"
+		},
+		{
+			value: "docker",
+			label: "Docker",
+			hint: "Run locally with docker compose"
+		},
+		{
+			value: "none",
+			label: "None",
+			hint: "Manual setup"
+		}
+	];
 	else if (databaseType === "mongodb") options = [
 		{
 			value: "mongodb-atlas",
@@ -1651,6 +1670,7 @@ function validateDatabaseSetup(config, providedFlags) {
 			database: "postgres",
 			errorMessage: "Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
 		},
+		planetscale: { errorMessage: "PlanetScale setup requires PostgreSQL or MySQL database. Please use '--database postgres' or '--database mysql' or choose a different setup." },
 		"mongodb-atlas": {
 			database: "mongodb",
 			errorMessage: "MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup."
@@ -1669,7 +1689,9 @@ function validateDatabaseSetup(config, providedFlags) {
 	};
 	if (dbSetup && dbSetup !== "none") {
 		const validation = setupValidations[dbSetup];
-		if (validation.database && database !== validation.database) exitWithError(validation.errorMessage);
+		if (dbSetup === "planetscale") {
+			if (database !== "postgres" && database !== "mysql") exitWithError(validation.errorMessage);
+		} else if (validation.database && database !== validation.database) exitWithError(validation.errorMessage);
 		if (validation.runtime && runtime !== validation.runtime) exitWithError(validation.errorMessage);
 		if (dbSetup === "docker") {
 			if (database === "sqlite") exitWithError("Docker setup is not compatible with SQLite database. SQLite is file-based and doesn't require Docker. Please use '--database postgres', '--database mysql', '--database mongodb', or choose a different setup.");
@@ -3044,8 +3066,11 @@ async function generateCloudflareWorkerTypes({ serverDir, packageManager }) {
 	const s = spinner();
 	try {
 		s.start("Generating Cloudflare Workers types...");
-		const runCmd = packageManager === "npm" ? "npm" : packageManager;
-		await execa(runCmd, ["run", "cf-typegen"], { cwd: serverDir });
+		const runCmd = getPackageExecutionCommand(packageManager, "wrangler types --env-interface CloudflareBindings");
+		await execa(runCmd, {
+			cwd: serverDir,
+			shell: true
+		});
 		s.stop("Cloudflare Workers types generated successfully!");
 	} catch {
 		s.stop(pc.yellow("Failed to generate Cloudflare Workers types"));
@@ -3093,8 +3118,7 @@ async function setupNextAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3119,8 +3143,7 @@ async function setupNuxtAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3183,8 +3206,7 @@ async function setupReactRouterAlchemyDeploy(projectDir, _packageManager, option
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3205,8 +3227,7 @@ async function setupSolidAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3231,8 +3252,7 @@ async function setupSvelteAlchemyDeploy(projectDir, _packageManager, options) {
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3298,8 +3318,7 @@ async function setupTanStackRouterAlchemyDeploy(projectDir, _packageManager, opt
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3324,8 +3343,7 @@ async function setupTanStackStartAlchemyDeploy(projectDir, _packageManager, opti
 		if (!options?.skipAppScripts) pkg.scripts = {
 			...pkg.scripts,
 			deploy: "alchemy deploy",
-			destroy: "alchemy destroy",
-			dev: "alchemy dev"
+			destroy: "alchemy destroy"
 		};
 		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 	}
@@ -3889,7 +3907,12 @@ function getFrontendType(frontend) {
 }
 function getApiDependencies(api, frontendType) {
 	const deps = {};
-	if (api === "orpc") deps.server = { dependencies: ["@orpc/server", "@orpc/client"] };
+	if (api === "orpc") deps.server = { dependencies: [
+		"@orpc/server",
+		"@orpc/client",
+		"@orpc/openapi",
+		"@orpc/zod"
+	] };
 	else if (api === "trpc") deps.server = { dependencies: ["@trpc/server", "@trpc/client"] };
 	if (frontendType.hasReactWeb) {
 		if (api === "orpc") deps.web = { dependencies: ["@orpc/tanstack-query", "@orpc/client"] };
@@ -4374,7 +4397,7 @@ async function setupEnvironmentVariables(config) {
 //#endregion
 //#region src/helpers/database-providers/d1-setup.ts
 async function setupCloudflareD1(config) {
-	const { projectDir, serverDeploy } = config;
+	const { projectDir, serverDeploy, orm } = config;
 	if (serverDeploy === "wrangler") {
 		const envPath = path.join(projectDir, "apps/server", ".env");
 		const variables = [
@@ -4398,6 +4421,22 @@ async function setupCloudflareD1(config) {
 			await addEnvVariablesToFile(envPath, variables);
 		} catch (_err) {}
 	}
+	if ((serverDeploy === "wrangler" || serverDeploy === "alchemy") && orm === "prisma") {
+		const envPath = path.join(projectDir, "apps/server", ".env");
+		const variables = [{
+			key: "DATABASE_URL",
+			value: "file:./local.db",
+			condition: true
+		}];
+		try {
+			await addEnvVariablesToFile(envPath, variables);
+		} catch (_err) {}
+		const serverDir = path.join(projectDir, "apps/server");
+		await addPackageDependency({
+			dependencies: ["@prisma/adapter-d1"],
+			projectDir: serverDir
+		});
+	}
 }
 
 //#endregion
@@ -4703,6 +4742,71 @@ async function setupNeonPostgres(config) {
 	}
 }
 
+//#endregion
+//#region src/helpers/database-providers/planetscale-setup.ts
+async function setupPlanetScale(config) {
+	const { projectDir, database, orm } = config;
+	const envPath = path.join(projectDir, "apps/server", ".env");
+	if (database === "mysql" && orm === "drizzle") {
+		const variables = [
+			{
+				key: "# enable foreign key constraints in database settings",
+				value: "",
+				condition: true
+			},
+			{
+				key: "DATABASE_URL",
+				value: "mysql://username:password@host/database?ssl={\"rejectUnauthorized\":true}",
+				condition: true
+			},
+			{
+				key: "DATABASE_HOST",
+				value: "",
+				condition: true
+			},
+			{
+				key: "DATABASE_USERNAME",
+				value: "",
+				condition: true
+			},
+			{
+				key: "DATABASE_PASSWORD",
+				value: "",
+				condition: true
+			}
+		];
+		await fs.ensureDir(path.join(projectDir, "apps/server"));
+		await addEnvVariablesToFile(envPath, variables);
+	}
+	if (database === "postgres" && orm === "prisma") {
+		const variables = [{
+			key: "DATABASE_URL",
+			value: "postgresql://username:password@host/database?sslaccept=strict",
+			condition: true
+		}];
+		await fs.ensureDir(path.join(projectDir, "apps/server"));
+		await addEnvVariablesToFile(envPath, variables);
+	}
+	if (database === "postgres" && orm === "drizzle") {
+		const variables = [{
+			key: "DATABASE_URL",
+			value: "postgresql://username:password@host/database?sslmode=verify-full",
+			condition: true
+		}];
+		await fs.ensureDir(path.join(projectDir, "apps/server"));
+		await addEnvVariablesToFile(envPath, variables);
+	}
+	if (database === "mysql" && orm === "prisma") {
+		const variables = [{
+			key: "DATABASE_URL",
+			value: "mysql://username:password@host/database?sslaccept=strict",
+			condition: true
+		}];
+		await fs.ensureDir(path.join(projectDir, "apps/server"));
+		await addEnvVariablesToFile(envPath, variables);
+	}
+}
+
 //#endregion
 //#region src/helpers/database-providers/prisma-postgres-setup.ts
 const AVAILABLE_REGIONS = [
@@ -5251,7 +5355,16 @@ async function setupDatabase(config) {
 	const serverDir = path.join(projectDir, "apps/server");
 	if (!await fs.pathExists(serverDir)) return;
 	try {
-		if (orm === "prisma") await addPackageDependency({
+		if (orm === "prisma") if (database === "mysql" && dbSetup === "planetscale") await addPackageDependency({
+			dependencies: [
+				"@prisma/client",
+				"@prisma/adapter-planetscale",
+				"undici"
+			],
+			devDependencies: ["prisma"],
+			projectDir: serverDir
+		});
+		else await addPackageDependency({
 			dependencies: ["@prisma/client"],
 			devDependencies: ["prisma"],
 			projectDir: serverDir
@@ -5271,12 +5384,22 @@ async function setupDatabase(config) {
 				devDependencies: ["drizzle-kit", "@types/ws"],
 				projectDir: serverDir
 			});
+			else if (dbSetup === "planetscale") await addPackageDependency({
+				dependencies: ["drizzle-orm", "pg"],
+				devDependencies: ["drizzle-kit", "@types/pg"],
+				projectDir: serverDir
+			});
 			else await addPackageDependency({
 				dependencies: ["drizzle-orm", "pg"],
 				devDependencies: ["drizzle-kit", "@types/pg"],
 				projectDir: serverDir
 			});
-			else if (database === "mysql") await addPackageDependency({
+			else if (database === "mysql") if (dbSetup === "planetscale") await addPackageDependency({
+				dependencies: ["drizzle-orm", "@planetscale/database"],
+				devDependencies: ["drizzle-kit"],
+				projectDir: serverDir
+			});
+			else await addPackageDependency({
 				dependencies: ["drizzle-orm", "mysql2"],
 				devDependencies: ["drizzle-kit"],
 				projectDir: serverDir
@@ -5292,7 +5415,10 @@ async function setupDatabase(config) {
 		else if (database === "postgres") {
 			if (dbSetup === "prisma-postgres") await setupPrismaPostgres(config);
 			else if (dbSetup === "neon") await setupNeonPostgres(config);
+			else if (dbSetup === "planetscale") await setupPlanetScale(config);
 			else if (dbSetup === "supabase") await setupSupabase(config);
+		} else if (database === "mysql") {
+			if (dbSetup === "planetscale") await setupPlanetScale(config);
 		} else if (database === "mongodb" && dbSetup === "mongodb-atlas") await setupMongoDBAtlas(config);
 	} catch (error) {
 		s.stop(pc.red("Failed to set up database"));
@@ -5737,7 +5863,7 @@ async function getDockerStatus(database) {
 //#endregion
 //#region src/helpers/core/post-installation.ts
 async function displayPostInstallInstructions(config) {
-	const { database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup, webDeploy, serverDeploy } = config;
+	const { api, database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup, webDeploy, serverDeploy } = config;
 	const isConvex = backend === "convex";
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager === "pnpm" ? "pnpm run" : "bun run";
 	const cdCmd = `cd ${relativePath}`;
@@ -5785,7 +5911,11 @@ async function displayPostInstallInstructions(config) {
 	output += `${pc.bold("Your project will be available at:")}\n`;
 	if (hasWeb) output += `${pc.cyan("•")} Frontend: http://localhost:${webPort}\n`;
 	else if (!hasNative && !addons?.includes("starlight")) output += `${pc.yellow("NOTE:")} You are creating a backend-only app\n   (no frontend selected)\n`;
-	if (!isConvex) output += `${pc.cyan("•")} Backend API: http://localhost:3000\n`;
+	if (!isConvex) {
+		output += `${pc.cyan("•")} Backend API: http://localhost:3000\n`;
+		if (api === "orpc") if (backend === "next") output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:3000/rpc/api\n`;
+		else output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:3000/api\n`;
+	}
 	if (addons?.includes("starlight")) output += `${pc.cyan("•")} Docs: http://localhost:4321\n`;
 	if (addons?.includes("fumadocs")) output += `${pc.cyan("•")} Fumadocs: http://localhost:4000\n`;
 	if (nativeInstructions) output += `\n${nativeInstructions.trim()}\n`;
@@ -5834,7 +5964,13 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 		instructions.push(`${pc.cyan("5.")} Apply migrations locally: ${pc.white(`${packageManager} wrangler d1 migrations apply YOUR_DB_NAME --local`)}`);
 		instructions.push(`${pc.cyan("6.")} Apply migrations to production: ${pc.white(`${packageManager} wrangler d1 migrations apply YOUR_DB_NAME`)}`);
 	}
-	if (dbSetup === "d1" && serverDeploy === "alchemy") instructions.push(`${pc.yellow("NOTE:")} D1 migrations are automatically handled by Alchemy`);
+	if (dbSetup === "d1" && serverDeploy === "alchemy") {
+		if (orm === "drizzle") instructions.push(`${pc.yellow("NOTE:")} D1 migrations are automatically handled by Alchemy`);
+		else if (orm === "prisma") {
+			instructions.push(`${pc.cyan("•")} Generate migrations: ${`${runCmd} db:generate`}`);
+			instructions.push(`${pc.cyan("•")} Apply migrations: ${`${runCmd} db:migrate`}`);
+		}
+	}
 	if (orm === "prisma") {
 		if (dbSetup === "turso") instructions.push(`${pc.yellow("NOTE:")} Turso support with Prisma is in Early Access and requires\n   additional setup. Learn more at:\n   https://www.prisma.io/docs/orm/overview/databases/turso`);
 		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker combination\n   may not work.`);
@@ -5921,7 +6057,7 @@ async function updateRootPackageJson(projectDir, options) {
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = `turbo -F ${backendPackageName} db:studio`;
 			if (options.orm === "prisma") {
 				scripts["db:generate"] = `turbo -F ${backendPackageName} db:generate`;
-				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `turbo -F ${backendPackageName} db:migrate`;
+				scripts["db:migrate"] = `turbo -F ${backendPackageName} db:migrate`;
 			} else if (options.orm === "drizzle") {
 				scripts["db:generate"] = `turbo -F ${backendPackageName} db:generate`;
 				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `turbo -F ${backendPackageName} db:migrate`;
@@ -5946,7 +6082,7 @@ async function updateRootPackageJson(projectDir, options) {
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = `pnpm --filter ${backendPackageName} db:studio`;
 			if (options.orm === "prisma") {
 				scripts["db:generate"] = `pnpm --filter ${backendPackageName} db:generate`;
-				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `pnpm --filter ${backendPackageName} db:migrate`;
+				scripts["db:migrate"] = `pnpm --filter ${backendPackageName} db:migrate`;
 			} else if (options.orm === "drizzle") {
 				scripts["db:generate"] = `pnpm --filter ${backendPackageName} db:generate`;
 				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `pnpm --filter ${backendPackageName} db:migrate`;
@@ -5971,7 +6107,7 @@ async function updateRootPackageJson(projectDir, options) {
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = `npm run db:studio --workspace ${backendPackageName}`;
 			if (options.orm === "prisma") {
 				scripts["db:generate"] = `npm run db:generate --workspace ${backendPackageName}`;
-				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `npm run db:migrate --workspace ${backendPackageName}`;
+				scripts["db:migrate"] = `npm run db:migrate --workspace ${backendPackageName}`;
 			} else if (options.orm === "drizzle") {
 				scripts["db:generate"] = `npm run db:generate --workspace ${backendPackageName}`;
 				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `npm run db:migrate --workspace ${backendPackageName}`;
@@ -5996,7 +6132,7 @@ async function updateRootPackageJson(projectDir, options) {
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = `bun run --filter ${backendPackageName} db:studio`;
 			if (options.orm === "prisma") {
 				scripts["db:generate"] = `bun run --filter ${backendPackageName} db:generate`;
-				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `bun run --filter ${backendPackageName} db:migrate`;
+				scripts["db:migrate"] = `bun run --filter ${backendPackageName} db:migrate`;
 			} else if (options.orm === "drizzle") {
 				scripts["db:generate"] = `bun run --filter ${backendPackageName} db:generate`;
 				if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = `bun run --filter ${backendPackageName} db:migrate`;
@@ -6039,7 +6175,7 @@ async function updateServerPackageJson(projectDir, options) {
 			scripts["db:push"] = "prisma db push";
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = "prisma studio";
 			scripts["db:generate"] = "prisma generate";
-			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:migrate"] = "prisma migrate dev";
+			scripts["db:migrate"] = "prisma migrate dev";
 		} else if (options.orm === "drizzle") {
 			scripts["db:push"] = "drizzle-kit push";
 			if (!(options.dbSetup === "d1" && options.serverDeploy === "alchemy")) scripts["db:studio"] = "drizzle-kit studio";
@@ -6362,7 +6498,7 @@ async function openUrl(url) {
 
 //#endregion
 //#region src/utils/sponsors.ts
-const SPONSORS_JSON_URL = "https://sponsors.amanv.dev/sponsors.json";
+const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
 async function fetchSponsors(url = SPONSORS_JSON_URL) {
 	const s = spinner();
 	s.start("Fetching sponsors…");
@@ -6376,23 +6512,30 @@ async function fetchSponsors(url = SPONSORS_JSON_URL) {
 	return sponsors$1;
 }
 function displaySponsors(sponsors$1) {
-	if (sponsors$1.length === 0) {
+	const { total_sponsors } = sponsors$1.summary;
+	if (total_sponsors === 0) {
 		log.info("No sponsors found. You can be the first one! ✨");
 		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
 		return;
 	}
-	sponsors$1.forEach((entry, idx) => {
-		const sponsor = entry.sponsor;
-		const displayName = sponsor.name ?? sponsor.login;
-		const tier = entry.tierName ? ` (${entry.tierName})` : "";
-		log.step(`${idx + 1}. ${pc.green(displayName)}${pc.yellow(tier)}`);
-		log.message(`   ${pc.dim("GitHub:")} https://github.com/${sponsor.login}`);
-		const website = sponsor.websiteUrl ?? sponsor.linkUrl;
-		if (website) log.message(`   ${pc.dim("Website:")} ${website}`);
-	});
-	log.message("");
+	displaySponsorsBox(sponsors$1);
+	if (total_sponsors - sponsors$1.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors$1.specialSponsors.length} more amazing sponsors.\n`));
 	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
 }
+function displaySponsorsBox(sponsors$1) {
+	if (sponsors$1.specialSponsors.length === 0) return;
+	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
+	sponsors$1.specialSponsors.forEach((sponsor, idx) => {
+		const displayName = sponsor.name ?? sponsor.githubId;
+		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
+		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
+		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
+		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
+		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
+		if (idx < sponsors$1.specialSponsors.length - 1) output += "\n";
+	});
+	consola$1.box(output);
+}
 
 //#endregion
 //#region src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.40.3-canary.50a1b944",
+  "version": "2.40.4-canary.49f23d48",
   "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/api/orpc/server/next/src/app/rpc/[...all]/route.ts.hbs

@@ -2,18 +2,47 @@
 import { createContext } from '@/lib/context'
 {{/if}}
 import { appRouter } from '@/routers'
+import { OpenAPIHandler } from '@orpc/openapi/fetch'
+import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
+import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 import { RPCHandler } from '@orpc/server/fetch'
+import { onError } from '@orpc/server'
 import { NextRequest } from 'next/server'
 
-const handler = new RPCHandler(appRouter)
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error)
+    }),
+  ],
+})
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error)
+    }),
+  ],
+})
 
 async function handleRequest(req: NextRequest) {
-  const { response } = await handler.handle(req, {
+  const rpcResult = await rpcHandler.handle(req, {
     prefix: '/rpc',
     context: {{#if (eq auth "better-auth")}}await createContext(req){{else}}{}{{/if}},
   })
+  if (rpcResult.response) return rpcResult.response
 
-  return response ?? new Response('Not found', { status: 404 })
+  const apiResult = await apiHandler.handle(req, {
+    prefix: '/rpc/api',
+    context: {{#if (eq auth "better-auth")}}await createContext(req){{else}}{}{{/if}},
+  })
+  if (apiResult.response) return apiResult.response
+
+  return new Response('Not found', { status: 404 })
 }
 
 export const GET = handleRequest

package/templates/auth/better-auth/server/base/src/lib/auth.ts.hbs

@@ -4,7 +4,7 @@ import { prismaAdapter } from "better-auth/adapters/prisma";
 {{#if (or (includes frontend "native-nativewind") (includes frontend "native-unistyles"))}}
 import { expo } from "@better-auth/expo";
 {{/if}}
-import prisma from "../../prisma";
+import prisma from "@/db";
 
 export const auth = betterAuth({
   database: prismaAdapter(prisma, {

package/templates/backend/server/elysia/src/index.ts.hbs

@@ -10,7 +10,11 @@ import { appRouter } from "./routers/index";
 import { fetchRequestHandler } from "@trpc/server/adapters/fetch";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/fetch";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/fetch";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers";
 import { createContext } from "./lib/context";
 {{/if}}
@@ -19,7 +23,25 @@ import { auth } from "./lib/auth";
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
 {{/if}}
 
 {{#if (eq runtime "node")}}
@@ -48,12 +70,19 @@ const app = new Elysia()
   {{/if}}
 {{#if (eq api "orpc")}}
   .all('/rpc*', async (context) => {
-    const { response } = await handler.handle(context.request, {
+    const { response } = await rpcHandler.handle(context.request, {
       prefix: '/rpc',
       context: await createContext({ context })
     })
     return response ?? new Response('Not Found', { status: 404 })
   })
+  .all('/api*', async (context) => {
+    const { response } = await apiHandler.handle(context.request, {
+      prefix: '/api',
+      context: await createContext({ context })
+    })
+    return response ?? new Response('Not Found', { status: 404 })
+  })
 {{/if}}
 {{#if (eq api "trpc")}}
   .all("/trpc/*", async (context) => {

package/templates/backend/server/express/src/index.ts.hbs

@@ -5,7 +5,11 @@ import { createContext } from "./lib/context";
 import { appRouter } from "./routers/index";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/node";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/node";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers";
 {{#if (eq auth "better-auth")}}
 import { createContext } from "./lib/context";
@@ -50,9 +54,28 @@ app.use(
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
-app.use("/rpc{*path}", async (req, res, next) => {
-  const { matched } = await handler.handle(req, res, {
+const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+app.use(async (req, res, next) => {
+  const rpcResult = await rpcHandler.handle(req, res, {
     prefix: "/rpc",
     {{#if (eq auth "better-auth")}}
     context: await createContext({ req }),
@@ -60,7 +83,18 @@ app.use("/rpc{*path}", async (req, res, next) => {
     context: {},
     {{/if}}
   });
-  if (matched) return;
+  if (rpcResult.matched) return;
+
+  const apiResult = await apiHandler.handle(req, res, {
+    prefix: "/api",
+    {{#if (eq auth "better-auth")}}
+    context: await createContext({ req }),
+    {{else}}
+    context: {},
+    {{/if}}
+  });
+  if (apiResult.matched) return;
+
   next();
 });
 {{/if}}

package/templates/backend/server/fastify/src/index.ts.hbs

@@ -9,8 +9,12 @@ import { appRouter, type AppRouter } from "./routers/index";
 {{/if}}
 
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/node";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/node";
 import { CORSPlugin } from "@orpc/server/plugins";
+import { onError } from "@orpc/server";
 import { appRouter } from "./routers/index";
 import { createServer } from "node:http";
 {{#if (eq auth "better-auth")}}
@@ -40,7 +44,7 @@ const baseCorsConfig = {
 };
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter, {
+const rpcHandler = new RPCHandler(appRouter, {
   plugins: [
     new CORSPlugin({
       origin: process.env.CORS_ORIGIN,
@@ -48,13 +52,31 @@ const handler = new RPCHandler(appRouter, {
       allowHeaders: ["Content-Type", "Authorization"],
     }),
   ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
 });
 
 const fastify = Fastify({
   logger: true,
   serverFactory: (fastifyHandler) => {
     const server = createServer(async (req, res) => {
-      const { matched } = await handler.handle(req, res, {
+      const { matched } = await rpcHandler.handle(req, res, {
         context: await createContext(req.headers),
         prefix: "/rpc",
       });
@@ -63,6 +85,15 @@ const fastify = Fastify({
         return;
       }
 
+      const apiResult = await apiHandler.handle(req, res, {
+        context: await createContext(req.headers),
+        prefix: "/api",
+      });
+
+      if (apiResult.matched) {
+        return;
+      }
+
       fastifyHandler(req, res);
     });
 

package/templates/backend/server/hono/src/index.ts.hbs

@@ -5,7 +5,11 @@ import "dotenv/config";
 import { env } from "cloudflare:workers";
 {{/if}}
 {{#if (eq api "orpc")}}
+import { OpenAPIHandler } from "@orpc/openapi/fetch";
+import { OpenAPIReferencePlugin } from "@orpc/openapi/plugins";
+import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import { RPCHandler } from "@orpc/server/fetch";
+import { onError } from "@orpc/server";
 import { createContext } from "./lib/context";
 import { appRouter } from "./routers/index";
 {{/if}}
@@ -54,17 +58,48 @@ app.on(["POST", "GET"], "/api/auth/**", (c) => auth.handler(c.req.raw));
 {{/if}}
 
 {{#if (eq api "orpc")}}
-const handler = new RPCHandler(appRouter);
-app.use("/rpc/*", async (c, next) => {
+export const apiHandler = new OpenAPIHandler(appRouter, {
+  plugins: [
+    new OpenAPIReferencePlugin({
+      schemaConverters: [new ZodToJsonSchemaConverter()],
+    }),
+  ],
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+export const rpcHandler = new RPCHandler(appRouter, {
+  interceptors: [
+    onError((error) => {
+      console.error(error);
+    }),
+  ],
+});
+
+app.use("/*", async (c, next) => {
   const context = await createContext({ context: c });
-  const { matched, response } = await handler.handle(c.req.raw, {
+
+  const rpcResult = await rpcHandler.handle(c.req.raw, {
     prefix: "/rpc",
     context: context,
   });
 
-  if (matched) {
-    return c.newResponse(response.body, response);
+  if (rpcResult.matched) {
+    return c.newResponse(rpcResult.response.body, rpcResult.response);
   }
+
+  const apiResult = await apiHandler.handle(c.req.raw, {
+    prefix: "/api",
+    context: context,
+  });
+
+  if (apiResult.matched) {
+    return c.newResponse(apiResult.response.body, apiResult.response);
+  }
+
   await next();
 });
 {{/if}}

package/templates/db/drizzle/mysql/src/db/index.ts.hbs

@@ -1,4 +1,15 @@
 {{#if (or (eq runtime "bun") (eq runtime "node"))}}
+{{#if (eq dbSetup "planetscale")}}
+import { drizzle } from "drizzle-orm/planetscale-serverless";
+
+export const db = drizzle({
+  connection: {
+    host: process.env.DATABASE_HOST,
+    username: process.env.DATABASE_USERNAME,
+    password: process.env.DATABASE_PASSWORD,
+  },
+});
+{{else}}
 import { drizzle } from "drizzle-orm/mysql2";
 
 export const db = drizzle({
@@ -7,8 +18,21 @@ export const db = drizzle({
   },
 });
 {{/if}}
+{{/if}}
 
 {{#if (eq runtime "workers")}}
+{{#if (eq dbSetup "planetscale")}}
+import { drizzle } from "drizzle-orm/planetscale-serverless";
+import { env } from "cloudflare:workers";
+
+export const db = drizzle({
+  connection: {
+    host: env.DATABASE_HOST,
+    username: env.DATABASE_USERNAME,
+    password: env.DATABASE_PASSWORD,
+  },
+});
+{{else}}
 import { drizzle } from "drizzle-orm/mysql2";
 import { env } from "cloudflare:workers";
 
@@ -18,3 +42,4 @@ export const db = drizzle({
   },
 });
 {{/if}}
+{{/if}}

package/templates/db/prisma/mongodb/src/db/index.ts.hbs

@@ -0,0 +1,5 @@
+import { PrismaClient } from "../../prisma/generated/client";
+
+const prisma = new PrismaClient();
+
+export default prisma;

package/templates/db/prisma/mysql/prisma/schema/schema.prisma.hbs

@@ -11,9 +11,15 @@ generator client {
   {{#if (eq runtime "workers")}}
   runtime = "workerd"
   {{/if}}
+  {{#if (eq dbSetup "planetscale")}}
+  previewFeatures = ["driverAdapters"]
+  {{/if}}
 }
 
 datasource db {
   provider = "mysql"
   url      = env("DATABASE_URL")
+  {{#if (eq dbSetup "planetscale")}}
+  relationMode = "prisma"
+  {{/if}}
 }

package/templates/db/prisma/mysql/src/db/index.ts.hbs

@@ -0,0 +1,12 @@
+import { PrismaClient } from "../../prisma/generated/client";
+{{#if (eq dbSetup "planetscale")}}
+import { PrismaPlanetScale } from '@prisma/adapter-planetscale'
+import { fetch as undiciFetch } from 'undici'
+
+const adapter = new PrismaPlanetScale({ url: process.env.DATABASE_URL, fetch: undiciFetch })
+const prisma = new PrismaClient({adapter});
+{{else}}
+const prisma = new PrismaClient();
+{{/if}}
+
+export default prisma;

package/templates/db/prisma/postgres/prisma/schema/schema.prisma.hbs

@@ -19,4 +19,7 @@ datasource db {
   {{#if (eq dbSetup "supabase")}}
   directUrl = env("DIRECT_URL")
   {{/if}}
+  {{#if (eq dbSetup "planetscale")}}
+  relationMode = "prisma"
+  {{/if}}
 }

package/templates/db/prisma/postgres/src/db/index.ts.hbs

@@ -0,0 +1,5 @@
+import { PrismaClient } from "../../prisma/generated/client";
+
+const prisma = new PrismaClient();
+
+export default prisma;

package/templates/db/prisma/sqlite/prisma/schema/schema.prisma.hbs

@@ -10,6 +10,9 @@ generator client {
   {{/if}}
   {{#if (eq runtime "workers")}}
   runtime = "workerd"
+  {{#if (eq dbSetup "d1")}}
+  previewFeatures = ["driverAdapters"]
+  {{/if}}
   {{/if}}
 }
 

package/templates/db/prisma/sqlite/prisma.config.ts.hbs

@@ -1,10 +1,27 @@
 import "dotenv/config";
 import path from "node:path";
 import type { PrismaConfig } from "prisma";
+{{#if (eq serverDeploy "wrangler")}}
+import { PrismaD1 } from "@prisma/adapter-d1";
+{{/if}}
 
 export default {
+  {{#if (eq serverDeploy "wrangler")}}
+  experimental: {
+    adapter: true
+  },
+  {{/if}}
   schema: path.join("prisma", "schema"),
   migrations: {
     path: path.join("prisma", "migrations"),
-  }
+  },
+  {{#if (eq serverDeploy "wrangler")}}
+  async adapter() {
+			return new PrismaD1({
+				CLOUDFLARE_D1_TOKEN: process.env.CLOUDFLARE_D1_TOKEN!,
+				CLOUDFLARE_ACCOUNT_ID: process.env.CLOUDFLARE_ACCOUNT_ID!,
+				CLOUDFLARE_DATABASE_ID: process.env.CLOUDFLARE_DATABASE_ID!,
+			});
+		},
+  {{/if}}
 } satisfies PrismaConfig;

package/templates/db/prisma/sqlite/src/db/index.ts.hbs

@@ -0,0 +1,16 @@
+{{#if (and (eq dbSetup "d1") (eq runtime "workers"))}}
+import { env } from "cloudflare:workers";
+import { PrismaD1 } from "@prisma/adapter-d1";
+import { PrismaClient } from "../../prisma/generated/client";
+
+const adapter = new PrismaD1(env.DB);
+const prisma = new PrismaClient({ adapter });
+
+export default prisma;
+{{else}}
+import { PrismaClient } from "../../prisma/generated/client";
+
+const prisma = new PrismaClient();
+
+export default prisma;
+{{/if}}

package/templates/deploy/alchemy/alchemy.run.ts.hbs

@@ -44,7 +44,11 @@ await Exec("db-generate", {
 });
 
 const db = await D1Database("database", {
+	{{#if (eq orm "prisma")}}
+	migrationsDir: "apps/server/prisma/migrations",
+	{{else if (eq orm "drizzle")}}
 	migrationsDir: "apps/server/src/db/migrations",
+	{{/if}}
 });
 {{/if}}
 

package/templates/deploy/wrangler/server/wrangler.jsonc.hbs

@@ -27,7 +27,12 @@
       "database_name": "YOUR_DB_NAME",
       "database_id": "YOUR_DB_ID",
       "preview_database_id": "local-test-db",
+      {{#if (eq orm "drizzle")}}
       "migrations_dir": "./src/db/migrations"
+      {{/if}}
+      {{#if (eq orm "prisma")}}
+      "migrations_dir": "./prisma/migrations"
+      {{/if}}
     }
   ]
   {{/if}}

package/templates/examples/todo/server/prisma/base/src/routers/todo.ts.hbs

@@ -1,6 +1,6 @@
 {{#if (eq api "orpc")}}
 import z from "zod";
-import prisma from "../../prisma";
+import prisma from "@/db";
 import { publicProcedure } from "../lib/orpc";
 
 export const todoRouter = {
@@ -52,7 +52,7 @@ export const todoRouter = {
 {{#if (eq api "trpc")}}
 import { TRPCError } from "@trpc/server";
 import z from "zod";
-import prisma from "../../prisma";
+import prisma from "@/db";
 import { publicProcedure, router } from "../lib/trpc";
 
 export const todoRouter = router({

package/templates/db/prisma/mongodb/prisma/index.ts.hbs

@@ -1,5 +0,0 @@
-import { PrismaClient } from "./generated/client";
-
-const prisma = new PrismaClient();
-
-export default prisma;

package/templates/db/prisma/mysql/prisma/index.ts

@@ -1,5 +0,0 @@
-import { PrismaClient } from "./generated/client";
-
-const prisma = new PrismaClient();
-
-export default prisma;

package/templates/db/prisma/postgres/prisma/index.ts

@@ -1,5 +0,0 @@
-import { PrismaClient } from "./generated/client";
-
-const prisma = new PrismaClient();
-
-export default prisma;

package/templates/db/prisma/sqlite/prisma/index.ts

@@ -1,5 +0,0 @@
-import { PrismaClient } from "./generated/client";
-
-const prisma = new PrismaClient();
-
-export default prisma;