create-better-t-stack 2.27.1 → 2.28.1

package/README.md

@@ -21,6 +21,12 @@ pnpm create better-t-stack@latest
 
 Follow the prompts to configure your project or use the `--yes` flag for defaults.
 
+## Sponsors
+
+<p align="center">
+<img src="https://sponsors.amanv.dev/sponsors.png" alt="Sponsors">
+</p>
+
 ## Features
 
 | Category                 | Options                                                                                                                                                                                                                                                    |
@@ -211,9 +217,3 @@ my-better-t-app/
 ```
 
 After project creation, you'll receive detailed instructions for next steps and additional setup requirements.
-
-## Sponsors
-
-<p align="center">
-<img src="https://sponsors.amanv.dev/sponsors.png" alt="Sponsors" width="300">
-</p>

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
+import { cancel, confirm, group, groupMultiselect, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
 import consola, { consola as consola$1 } from "consola";
 import pc from "picocolors";
 import { createCli, trpcServer } from "trpc-cli";
@@ -49,8 +49,8 @@ const DEFAULT_CONFIG = {
 	webDeploy: "none"
 };
 const dependencyVersionMap = {
-	"better-auth": "^1.3.0",
-	"@better-auth/expo": "^1.3.0",
+	"better-auth": "^1.3.4",
+	"@better-auth/expo": "^1.3.4",
 	"drizzle-orm": "^0.44.2",
 	"drizzle-kit": "^0.31.2",
 	"@libsql/client": "^0.15.9",
@@ -60,16 +60,18 @@ const dependencyVersionMap = {
 	"@types/ws": "^8.18.1",
 	ws: "^8.18.3",
 	mysql2: "^3.14.0",
-	"@prisma/client": "^6.12.0",
-	prisma: "^6.12.0",
+	"@prisma/client": "^6.13.0",
+	prisma: "^6.13.0",
 	"@prisma/extension-accelerate": "^2.0.2",
 	mongoose: "^8.14.0",
 	"vite-plugin-pwa": "^1.0.1",
 	"@vite-pwa/assets-generator": "^1.0.0",
 	"@tauri-apps/cli": "^2.4.0",
-	"@biomejs/biome": "^2.0.0",
+	"@biomejs/biome": "^2.1.2",
+	oxlint: "^1.8.0",
+	ultracite: "5.1.1",
 	husky: "^9.1.7",
-	"lint-staged": "^15.5.0",
+	"lint-staged": "^16.1.2",
 	tsx: "^4.19.2",
 	"@types/node": "^22.13.11",
 	"@types/bun": "^1.2.6",
@@ -130,6 +132,9 @@ const ADDON_COMPATIBILITY = {
 	husky: [],
 	turborepo: [],
 	starlight: [],
+	ultracite: [],
+	oxlint: [],
+	fumadocs: [],
 	none: []
 };
 const WEB_FRAMEWORKS = [
@@ -191,6 +196,9 @@ const AddonsSchema = z.enum([
 	"biome",
 	"husky",
 	"turborepo",
+	"fumadocs",
+	"ultracite",
+	"oxlint",
 	"none"
 ]).describe("Additional addons");
 const ExamplesSchema = z.enum([
@@ -258,87 +266,136 @@ function getCompatibleAddons(allAddons, frontend, existingAddons = []) {
 
 //#endregion
 //#region src/prompts/addons.ts
-function getAddonDisplay(addon, isRecommended = false) {
+function getAddonDisplay(addon) {
 	let label;
 	let hint;
-	if (addon === "turborepo") {
-		label = isRecommended ? "Turborepo (Recommended)" : "Turborepo";
-		hint = "High-performance build system for JavaScript and TypeScript";
-	} else if (addon === "pwa") {
-		label = "PWA (Progressive Web App)";
-		hint = "Make your app installable and work offline";
-	} else if (addon === "tauri") {
-		label = isRecommended ? "Tauri Desktop App" : "Tauri";
-		hint = "Build native desktop apps from your web frontend";
-	} else if (addon === "biome") {
-		label = "Biome";
-		hint = isRecommended ? "Add Biome for linting and formatting" : "Fast formatter and linter for JavaScript, TypeScript, JSX";
-	} else if (addon === "husky") {
-		label = "Husky";
-		hint = isRecommended ? "Add Git hooks with Husky, lint-staged (requires Biome)" : "Git hooks made easy";
-	} else if (addon === "starlight") {
-		label = "Starlight";
-		hint = isRecommended ? "Add Astro Starlight documentation site" : "Documentation site with Astro";
-	} else {
-		label = addon;
-		hint = `Add ${addon}`;
+	switch (addon) {
+		case "turborepo":
+			label = "Turborepo";
+			hint = "High-performance build system";
+			break;
+		case "pwa":
+			label = "PWA";
+			hint = "Make your app installable and work offline";
+			break;
+		case "tauri":
+			label = "Tauri";
+			hint = "Build native desktop apps from your web frontend";
+			break;
+		case "biome":
+			label = "Biome";
+			hint = "Format, lint, and more";
+			break;
+		case "oxlint":
+			label = "Oxlint";
+			hint = "Rust-powered linter";
+			break;
+		case "ultracite":
+			label = "Ultracite";
+			hint = "Zero-config Biome preset with AI integration";
+			break;
+		case "husky":
+			label = "Husky";
+			hint = "Modern native Git hooks made easy";
+			break;
+		case "starlight":
+			label = "Starlight";
+			hint = "Build stellar docs with astro";
+			break;
+		case "fumadocs":
+			label = "Fumadocs";
+			hint = "Build excellent documentation site";
+			break;
+		default:
+			label = addon;
+			hint = `Add ${addon}`;
 	}
 	return {
 		label,
 		hint
 	};
 }
+const ADDON_GROUPS = {
+	Documentation: ["starlight", "fumadocs"],
+	Linting: [
+		"biome",
+		"oxlint",
+		"ultracite"
+	],
+	Other: [
+		"turborepo",
+		"pwa",
+		"tauri",
+		"husky"
+	]
+};
 async function getAddonsChoice(addons, frontends) {
 	if (addons !== void 0) return addons;
 	const allAddons = AddonsSchema.options.filter((addon) => addon !== "none");
-	const allPossibleOptions = [];
+	const groupedOptions = {
+		Documentation: [],
+		Linting: [],
+		Other: []
+	};
+	const frontendsArray = frontends || [];
 	for (const addon of allAddons) {
-		const { isCompatible } = validateAddonCompatibility(addon, frontends || []);
-		if (isCompatible) {
-			const { label, hint } = getAddonDisplay(addon, true);
-			allPossibleOptions.push({
-				value: addon,
-				label,
-				hint
-			});
-		}
+		const { isCompatible } = validateAddonCompatibility(addon, frontendsArray);
+		if (!isCompatible) continue;
+		const { label, hint } = getAddonDisplay(addon);
+		const option = {
+			value: addon,
+			label,
+			hint
+		};
+		if (ADDON_GROUPS.Documentation.includes(addon)) groupedOptions.Documentation.push(option);
+		else if (ADDON_GROUPS.Linting.includes(addon)) groupedOptions.Linting.push(option);
+		else if (ADDON_GROUPS.Other.includes(addon)) groupedOptions.Other.push(option);
 	}
-	const options = allPossibleOptions.sort((a, b) => {
-		if (a.value === "turborepo") return -1;
-		if (b.value === "turborepo") return 1;
-		return 0;
+	Object.keys(groupedOptions).forEach((group$1) => {
+		if (groupedOptions[group$1].length === 0) delete groupedOptions[group$1];
 	});
-	const initialValues = DEFAULT_CONFIG.addons.filter((addonValue) => options.some((opt) => opt.value === addonValue));
-	const response = await multiselect({
+	const initialValues = DEFAULT_CONFIG.addons.filter((addonValue) => Object.values(groupedOptions).some((options) => options.some((opt) => opt.value === addonValue)));
+	const response = await groupMultiselect({
 		message: "Select addons",
-		options,
+		options: groupedOptions,
 		initialValues,
-		required: false
+		required: false,
+		selectableGroups: false
 	});
 	if (isCancel(response)) {
 		cancel(pc.red("Operation cancelled"));
 		process.exit(0);
 	}
-	if (response.includes("husky") && !response.includes("biome")) response.push("biome");
 	return response;
 }
 async function getAddonsToAdd(frontend, existingAddons = []) {
-	const options = [];
-	const allAddons = AddonsSchema.options.filter((addon) => addon !== "none");
-	const compatibleAddons = getCompatibleAddons(allAddons, frontend, existingAddons);
+	const groupedOptions = {
+		Documentation: [],
+		Linting: [],
+		Other: []
+	};
+	const frontendArray = frontend || [];
+	const compatibleAddons = getCompatibleAddons(AddonsSchema.options.filter((addon) => addon !== "none"), frontendArray, existingAddons);
 	for (const addon of compatibleAddons) {
-		const { label, hint } = getAddonDisplay(addon, false);
-		options.push({
+		const { label, hint } = getAddonDisplay(addon);
+		const option = {
 			value: addon,
 			label,
 			hint
-		});
+		};
+		if (ADDON_GROUPS.Documentation.includes(addon)) groupedOptions.Documentation.push(option);
+		else if (ADDON_GROUPS.Linting.includes(addon)) groupedOptions.Linting.push(option);
+		else if (ADDON_GROUPS.Other.includes(addon)) groupedOptions.Other.push(option);
 	}
-	if (options.length === 0) return [];
-	const response = await multiselect({
-		message: "Select addons",
-		options,
-		required: false
+	Object.keys(groupedOptions).forEach((group$1) => {
+		if (groupedOptions[group$1].length === 0) delete groupedOptions[group$1];
+	});
+	if (Object.keys(groupedOptions).length === 0) return [];
+	const response = await groupMultiselect({
+		message: "Select addons to add",
+		options: groupedOptions,
+		required: false,
+		selectableGroups: false
 	});
 	if (isCancel(response)) {
 		cancel(pc.red("Operation cancelled"));
@@ -640,7 +697,7 @@ async function getExamplesChoice(examples, database, frontends, backend, api) {
 async function getFrontendChoice(frontendOptions, backend) {
 	if (frontendOptions !== void 0) return frontendOptions;
 	const frontendTypes = await multiselect({
-		message: "Select platforms to develop for",
+		message: "Select project type",
 		options: [{
 			value: "web",
 			label: "Web",
@@ -1682,6 +1739,70 @@ function getPackageExecutionCommand(packageManager, commandWithArgs) {
 	}
 }
 
+//#endregion
+//#region src/helpers/setup/fumadocs-setup.ts
+const TEMPLATES = {
+	"next-mdx": {
+		label: "Next.js: Fumadocs MDX",
+		hint: "Recommended template with MDX support",
+		value: "+next+fuma-docs-mdx"
+	},
+	"next-content-collections": {
+		label: "Next.js: Content Collections",
+		hint: "Template using Next.js content collections",
+		value: "+next+content-collections"
+	},
+	"react-router-mdx-remote": {
+		label: "React Router: MDX Remote",
+		hint: "Template for React Router with MDX remote",
+		value: "react-router"
+	},
+	"tanstack-start-mdx-remote": {
+		label: "Tanstack Start: MDX Remote",
+		hint: "Template for Tanstack Start with MDX remote",
+		value: "tanstack-start"
+	}
+};
+async function setupFumadocs(config) {
+	const { packageManager, projectDir } = config;
+	try {
+		log.info("Setting up Fumadocs...");
+		const template = await select({
+			message: "Choose a template",
+			options: Object.entries(TEMPLATES).map(([key, template$1]) => ({
+				value: key,
+				label: template$1.label,
+				hint: template$1.hint
+			})),
+			initialValue: "next-mdx"
+		});
+		if (isCancel(template)) {
+			cancel(pc.red("Operation cancelled"));
+			process.exit(0);
+		}
+		const templateArg = TEMPLATES[template].value;
+		const commandWithArgs = `create-fumadocs-app@latest fumadocs --template ${templateArg} --src --no-install --pm ${packageManager} --no-eslint`;
+		const fumadocsInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
+		await execa(fumadocsInitCommand, {
+			cwd: path.join(projectDir, "apps"),
+			env: { CI: "true" },
+			shell: true
+		});
+		const fumadocsDir = path.join(projectDir, "apps", "fumadocs");
+		const packageJsonPath = path.join(fumadocsDir, "package.json");
+		if (await fs.pathExists(packageJsonPath)) {
+			const packageJson = await fs.readJson(packageJsonPath);
+			packageJson.name = "fumadocs";
+			if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port=4000`;
+			await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+		}
+		log.success("Fumadocs setup successfully!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up Fumadocs"));
+		if (error instanceof Error) consola.error(pc.red(error.message));
+	}
+}
+
 //#endregion
 //#region src/helpers/setup/starlight-setup.ts
 async function setupStarlight(config) {
@@ -1770,6 +1891,106 @@ async function setupTauri(config) {
 	}
 }
 
+//#endregion
+//#region src/helpers/setup/ultracite-setup.ts
+const EDITORS = {
+	vscode: {
+		label: "VSCode / Cursor / Windsurf",
+		hint: "Visual Studio Code editor configuration"
+	},
+	zed: {
+		label: "Zed",
+		hint: "Zed editor configuration"
+	}
+};
+const RULES = {
+	"vscode-copilot": {
+		label: "VS Code Copilot",
+		hint: "GitHub Copilot integration for VS Code"
+	},
+	cursor: {
+		label: "Cursor",
+		hint: "Cursor AI editor configuration"
+	},
+	windsurf: {
+		label: "Windsurf",
+		hint: "Windsurf editor configuration"
+	},
+	zed: {
+		label: "Zed",
+		hint: "Zed editor rules"
+	},
+	claude: {
+		label: "Claude",
+		hint: "Claude AI integration"
+	},
+	codex: {
+		label: "Codex",
+		hint: "Codex AI integration"
+	}
+};
+async function setupUltracite(config, hasHusky) {
+	const { packageManager, projectDir } = config;
+	try {
+		log.info("Setting up Ultracite...");
+		await setupBiome(projectDir);
+		const editors = await multiselect({
+			message: "Choose editors",
+			options: Object.entries(EDITORS).map(([key, editor]) => ({
+				value: key,
+				label: editor.label,
+				hint: editor.hint
+			})),
+			required: false
+		});
+		if (isCancel(editors)) {
+			cancel(pc.red("Operation cancelled"));
+			process.exit(0);
+		}
+		const rules = await multiselect({
+			message: "Choose rules",
+			options: Object.entries(RULES).map(([key, rule]) => ({
+				value: key,
+				label: rule.label,
+				hint: rule.hint
+			})),
+			required: false
+		});
+		if (isCancel(rules)) {
+			cancel(pc.red("Operation cancelled"));
+			process.exit(0);
+		}
+		const ultraciteArgs = [
+			"init",
+			"--pm",
+			packageManager
+		];
+		if (editors.length > 0) ultraciteArgs.push("--editors", ...editors);
+		if (rules.length > 0) ultraciteArgs.push("--rules", ...rules);
+		if (hasHusky) ultraciteArgs.push("--features", "husky", "lint-staged");
+		const ultraciteArgsString = ultraciteArgs.join(" ");
+		const commandWithArgs = `ultracite@latest ${ultraciteArgsString} --skip-install`;
+		const ultraciteInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
+		await execa(ultraciteInitCommand, {
+			cwd: projectDir,
+			env: { CI: "true" },
+			shell: true
+		});
+		if (hasHusky) await addPackageDependency({
+			devDependencies: ["husky", "lint-staged"],
+			projectDir
+		});
+		await addPackageDependency({
+			devDependencies: ["ultracite"],
+			projectDir
+		});
+		log.success("Ultracite setup successfully!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up Ultracite"));
+		if (error instanceof Error) console.error(pc.red(error.message));
+	}
+}
+
 //#endregion
 //#region src/utils/ts-morph.ts
 const tsProject = new Project({
@@ -1824,7 +2045,7 @@ async function addPwaToViteConfig(viteConfigPath, projectName) {
 //#endregion
 //#region src/helpers/setup/addons-setup.ts
 async function setupAddons(config, isAddCommand = false) {
-	const { addons, frontend, projectDir } = config;
+	const { addons, frontend, projectDir, packageManager } = config;
 	const hasReactWebFrontend = frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("next");
 	const hasNuxtFrontend = frontend.includes("nuxt");
 	const hasSvelteFrontend = frontend.includes("svelte");
@@ -1845,9 +2066,23 @@ ${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
 	}
 	if (addons.includes("pwa") && (hasReactWebFrontend || hasSolidFrontend)) await setupPwa(projectDir, frontend);
 	if (addons.includes("tauri") && (hasReactWebFrontend || hasNuxtFrontend || hasSvelteFrontend || hasSolidFrontend || hasNextFrontend)) await setupTauri(config);
-	if (addons.includes("biome")) await setupBiome(projectDir);
-	if (addons.includes("husky")) await setupHusky(projectDir);
+	const hasUltracite = addons.includes("ultracite");
+	const hasBiome = addons.includes("biome");
+	const hasHusky = addons.includes("husky");
+	const hasOxlint = addons.includes("oxlint");
+	if (hasUltracite) await setupUltracite(config, hasHusky);
+	else {
+		if (hasBiome) await setupBiome(projectDir);
+		if (hasHusky) {
+			let linter;
+			if (hasOxlint) linter = "oxlint";
+			else if (hasBiome) linter = "biome";
+			await setupHusky(projectDir, linter);
+		}
+	}
+	if (addons.includes("oxlint")) await setupOxlint(projectDir, packageManager);
 	if (addons.includes("starlight")) await setupStarlight(config);
+	if (addons.includes("fumadocs")) await setupFumadocs(config);
 }
 function getWebAppDir(projectDir, frontends) {
 	if (frontends.some((f) => [
@@ -1874,7 +2109,7 @@ async function setupBiome(projectDir) {
 		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	}
 }
-async function setupHusky(projectDir) {
+async function setupHusky(projectDir, linter) {
 	await addPackageDependency({
 		devDependencies: ["husky", "lint-staged"],
 		projectDir
@@ -1886,7 +2121,9 @@ async function setupHusky(projectDir) {
 			...packageJson.scripts,
 			prepare: "husky"
 		};
-		packageJson["lint-staged"] = { "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": ["biome check --write ."] };
+		if (linter === "oxlint") packageJson["lint-staged"] = { "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "oxlint" };
+		else if (linter === "biome") packageJson["lint-staged"] = { "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": ["biome check --write ."] };
+		else packageJson["lint-staged"] = { "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "" };
 		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	}
 }
@@ -1916,6 +2153,27 @@ async function setupPwa(projectDir, frontends) {
 	const viteConfigTs = path.join(clientPackageDir, "vite.config.ts");
 	if (await fs.pathExists(viteConfigTs)) await addPwaToViteConfig(viteConfigTs, path.basename(projectDir));
 }
+async function setupOxlint(projectDir, packageManager) {
+	await addPackageDependency({
+		devDependencies: ["oxlint"],
+		projectDir
+	});
+	const packageJsonPath = path.join(projectDir, "package.json");
+	if (await fs.pathExists(packageJsonPath)) {
+		const packageJson = await fs.readJson(packageJsonPath);
+		packageJson.scripts = {
+			...packageJson.scripts,
+			check: "oxlint"
+		};
+		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+	}
+	const oxlintInitCommand = getPackageExecutionCommand(packageManager, "oxlint@latest --init");
+	await execa(oxlintInitCommand, {
+		cwd: projectDir,
+		env: { CI: "true" },
+		shell: true
+	});
+}
 
 //#endregion
 //#region src/helpers/project-generation/detect-project-config.ts
@@ -2319,6 +2577,11 @@ async function handleExtras(projectDir, context) {
 		const pnpmWorkspaceDest = path.join(projectDir, "pnpm-workspace.yaml");
 		if (await fs.pathExists(pnpmWorkspaceSrc)) await fs.copy(pnpmWorkspaceSrc, pnpmWorkspaceDest);
 	}
+	if (context.packageManager === "bun") {
+		const bunfigSrc = path.join(extrasDir, "bunfig.toml");
+		const bunfigDest = path.join(projectDir, "bunfig.toml");
+		if (await fs.pathExists(bunfigSrc)) await fs.copy(bunfigSrc, bunfigDest);
+	}
 	if (context.packageManager === "pnpm" && (hasNative || context.frontend.includes("nuxt"))) {
 		const npmrcTemplateSrc = path.join(extrasDir, "_npmrc.hbs");
 		const npmrcDest = path.join(projectDir, ".npmrc");
@@ -3334,6 +3597,10 @@ const NEON_REGIONS = [
 		label: "AWS Asia Pacific (Singapore)",
 		value: "aws-ap-southeast-1"
 	},
+	{
+		label: "AWS South America East 1 (São Paulo)",
+		value: "aws-sa-east-1"
+	},
 	{
 		label: "AWS Asia Pacific (Sydney)",
 		value: "aws-ap-southeast-2"
@@ -3472,7 +3739,7 @@ async function setupNeonPostgres(config) {
 //#region src/helpers/database-providers/prisma-postgres-setup.ts
 async function setupWithCreateDb(serverDir, packageManager, orm) {
 	try {
-		log.info("Starting Prisma PostgreSQL setup. Please follow the instructions below:");
+		log.info("Starting Prisma Postgres setup. Please follow the instructions below:");
 		const createDbCommand = getPackageExecutionCommand(packageManager, "create-db@latest -i");
 		await execa(createDbCommand, {
 			cwd: serverDir,
@@ -3539,6 +3806,16 @@ async function writeEnvFile$1(projectDir, config) {
 		consola$1.error("Failed to update environment configuration");
 	}
 }
+async function addDotenvImportToPrismaConfig(projectDir) {
+	try {
+		const prismaConfigPath = path.join(projectDir, "apps/server/prisma.config.ts");
+		let content = await fs.readFile(prismaConfigPath, "utf8");
+		content = `import "dotenv/config";\n${content}`;
+		await fs.writeFile(prismaConfigPath, content);
+	} catch (_error) {
+		consola$1.error("Failed to update prisma.config.ts");
+	}
+}
 function displayManualSetupInstructions$1() {
 	log.info(`Manual Prisma PostgreSQL Setup Instructions:
 
@@ -3596,7 +3873,7 @@ async function setupPrismaPostgres(config) {
 			hint: "More control (requires auth)"
 		});
 		const setupMethod = await select({
-			message: "Choose your Prisma setup method:",
+			message: "Choose your Prisma Postgres setup method:",
 			options: setupOptions,
 			initialValue: "create-db"
 		});
@@ -3609,20 +3886,15 @@ async function setupPrismaPostgres(config) {
 		else prismaConfig = await initPrismaDatabase(serverDir, packageManager);
 		if (prismaConfig) {
 			await writeEnvFile$1(projectDir, prismaConfig);
-			if (orm === "prisma") {
-				await addPrismaAccelerateExtension(serverDir);
-				log.info(pc.cyan("NOTE: Make sure to uncomment `import \"dotenv/config\";` in `apps/server/src/prisma.config.ts` to load environment variables."));
-			}
-			log.success(pc.green("Prisma PostgreSQL database configured successfully!"));
+			await addDotenvImportToPrismaConfig(projectDir);
+			if (orm === "prisma") await addPrismaAccelerateExtension(serverDir);
+			log.success(pc.green("Prisma Postgres database configured successfully!"));
 		} else {
-			const fallbackSpinner = spinner();
-			fallbackSpinner.start("Setting up fallback configuration...");
 			await writeEnvFile$1(projectDir);
-			fallbackSpinner.stop("Fallback configuration ready");
 			displayManualSetupInstructions$1();
 		}
 	} catch (error) {
-		consola$1.error(pc.red(`Error during Prisma PostgreSQL setup: ${error instanceof Error ? error.message : String(error)}`));
+		consola$1.error(pc.red(`Error during Prisma Postgres setup: ${error instanceof Error ? error.message : String(error)}`));
 		try {
 			await writeEnvFile$1(projectDir);
 			displayManualSetupInstructions$1();
@@ -4553,6 +4825,7 @@ async function displayPostInstallInstructions(config) {
 	else if (!hasNative && !addons?.includes("starlight")) output += `${pc.yellow("NOTE:")} You are creating a backend-only app (no frontend selected)\n`;
 	if (!isConvex) output += `${pc.cyan("•")} Backend API: http://localhost:3000\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`;
 	if (databaseInstructions) output += `\n${databaseInstructions.trim()}\n`;
 	if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;
@@ -4599,8 +4872,7 @@ async function getDatabaseInstructions(database, orm, runCmd, runtime, dbSetup)
 		instructions.push("");
 	}
 	if (orm === "prisma") {
-		if (database === "sqlite") instructions.push(`${pc.yellow("NOTE:")} Turso support with Prisma is in Early Access and requires additional setup.`, `Learn more at: https://www.prisma.io/docs/orm/overview/databases/turso`);
-		if (runtime === "bun") instructions.push(`${pc.yellow("NOTE:")} Prisma with Bun may require additional configuration. If you encounter errors,\nfollow the guidance provided in the error messages`);
+		if (dbSetup === "turso") instructions.push(`${pc.yellow("NOTE:")} Turso support with Prisma is in Early Access and requires additional setup.`, `Learn more at: https://www.prisma.io/docs/orm/overview/databases/turso`);
 		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker combination may not work.`);
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
 		instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
@@ -4760,11 +5032,6 @@ async function updateRootPackageJson(projectDir, options) {
 			scripts["db:down"] = `bun run --filter ${backendPackageName} db:down`;
 		}
 	}
-	if (options.addons.includes("biome")) scripts.check = "biome check --write .";
-	if (options.addons.includes("husky")) {
-		scripts.prepare = "husky";
-		packageJson["lint-staged"] = { "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": ["biome check --write ."] };
-	}
 	try {
 		const { stdout } = await execa(options.packageManager, ["-v"], { cwd: projectDir });
 		packageJson.packageManager = `${options.packageManager}@${stdout.trim()}`;
@@ -4792,9 +5059,9 @@ async function updateServerPackageJson(projectDir, options) {
 	if (options.database !== "none") {
 		if (options.database === "sqlite" && options.orm === "drizzle" && options.dbSetup !== "d1") scripts["db:local"] = "turso dev --db-file local.db";
 		if (options.orm === "prisma") {
-			scripts["db:push"] = "prisma db push --schema ./prisma/schema";
+			scripts["db:push"] = "prisma db push";
 			scripts["db:studio"] = "prisma studio";
-			scripts["db:generate"] = "prisma generate --schema ./prisma/schema";
+			scripts["db:generate"] = "prisma generate";
 			scripts["db:migrate"] = "prisma migrate dev";
 		} else if (options.orm === "drizzle") {
 			scripts["db:push"] = "drizzle-kit push";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.27.1",
+  "version": "2.28.1",
   "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/biome/biome.json.hbs

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.1.2/schema.json",
 	"vcs": {
 		"enabled": false,
 		"clientKind": "git",
@@ -20,7 +20,8 @@
 			"!**/.nuxt",
 			"!bts.jsonc",
 			"!**/.expo",
-			"!**/.wrangler"
+			"!**/.wrangler",
+			"!**/.source"
 		]
 	},
 	"formatter": {

package/templates/addons/ultracite/biome.json.hbs

@@ -0,0 +1,22 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.1.2/schema.json",
+	"files": {
+		"ignoreUnknown": false,
+		"includes": [
+			"**",
+			"!**/.next",
+			"!**/dist",
+			"!**/.turbo",
+			"!**/dev-dist",
+			"!**/.zed",
+			"!**/.vscode",
+			"!**/routeTree.gen.ts",
+			"!**/src-tauri",
+			"!**/.nuxt",
+			"!bts.jsonc",
+			"!**/.expo",
+			"!**/.wrangler",
+			"!**/.source"
+		]
+	}
+}

package/templates/auth/web/react/next/src/components/sign-in-form.tsx

@@ -58,7 +58,7 @@ export default function SignInForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         className="space-y-4"
       >

package/templates/auth/web/react/next/src/components/sign-up-form.tsx

@@ -61,7 +61,7 @@ export default function SignUpForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         className="space-y-4"
       >

package/templates/auth/web/react/react-router/src/components/sign-in-form.tsx

@@ -58,7 +58,7 @@ export default function SignInForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         className="space-y-4"
       >

package/templates/auth/web/react/react-router/src/components/sign-up-form.tsx

@@ -61,7 +61,7 @@ export default function SignUpForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         className="space-y-4"
       >

package/templates/auth/web/react/tanstack-router/src/components/sign-in-form.tsx

@@ -62,7 +62,7 @@ export default function SignInForm({
 				onSubmit={(e) => {
 					e.preventDefault();
 					e.stopPropagation();
-					void form.handleSubmit();
+					form.handleSubmit();
 				}}
 				className="space-y-4"
 			>

package/templates/auth/web/react/tanstack-router/src/components/sign-up-form.tsx

@@ -65,7 +65,7 @@ export default function SignUpForm({
 				onSubmit={(e) => {
 					e.preventDefault();
 					e.stopPropagation();
-					void form.handleSubmit();
+					form.handleSubmit();
 				}}
 				className="space-y-4"
 			>

package/templates/auth/web/react/tanstack-start/src/components/sign-in-form.tsx

@@ -62,7 +62,7 @@ export default function SignInForm({
 				onSubmit={(e) => {
 					e.preventDefault();
 					e.stopPropagation();
-					void form.handleSubmit();
+					form.handleSubmit();
 				}}
 				className="space-y-4"
 			>

package/templates/auth/web/react/tanstack-start/src/components/sign-up-form.tsx

@@ -65,7 +65,7 @@ export default function SignUpForm({
 				onSubmit={(e) => {
 					e.preventDefault();
 					e.stopPropagation();
-					void form.handleSubmit();
+					form.handleSubmit();
 				}}
 				className="space-y-4"
 			>

package/templates/auth/web/solid/src/components/sign-in-form.tsx

@@ -53,7 +53,7 @@ export default function SignInForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         class="space-y-4"
       >

package/templates/auth/web/solid/src/components/sign-up-form.tsx

@@ -56,7 +56,7 @@ export default function SignUpForm({
         onSubmit={(e) => {
           e.preventDefault();
           e.stopPropagation();
-          void form.handleSubmit();
+          form.handleSubmit();
         }}
         class="space-y-4"
       >

package/templates/backend/server/next/package.json.hbs

@@ -11,7 +11,7 @@
     "next": "15.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "dotenv": "^16.5.0"
+    "dotenv": "^17.2.1"
   },
 {{#if (eq dbSetup 'supabase')}}
   "trustedDependencies": [
@@ -21,6 +21,7 @@
   "devDependencies": {
     "@types/node": "^20",
     "@types/react": "^19",
+    "zod": "^4.0.13",
     "typescript": "^5"
   }
 }

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

@@ -7,13 +7,8 @@
 		"check-types": "tsc -b",
 		"compile": "bun build --compile --minify --sourcemap --bytecode ./src/index.ts --outfile server"
 	},
-	{{#if (eq orm 'prisma')}}
-    "prisma": {
-        "schema": "./schema"
-    },
-    {{/if}}
 	"dependencies": {
-		"dotenv": "^16.4.7",
+		"dotenv": "^17.2.1",
 		"zod": "^4.0.2"
 	},
 	{{#if (eq dbSetup 'supabase')}}

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

@@ -3,6 +3,8 @@ import path from "node:path";
 import type { PrismaConfig } from "prisma";
 
 export default {
-  earlyAccess: true,
   schema: path.join("prisma", "schema"),
+  migrations: {
+    path: path.join("prisma", "migrations"),
+  }
 } satisfies PrismaConfig;

package/templates/db/prisma/mysql/{prisma.config.ts → prisma.config.ts.hbs}

@@ -3,6 +3,8 @@ import path from "node:path";
 import type { PrismaConfig } from "prisma";
 
 export default {
-  earlyAccess: true,
   schema: path.join("prisma", "schema"),
+  migrations: {
+    path: path.join("prisma", "migrations"),
+  }
 } satisfies PrismaConfig;

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

@@ -1,12 +1,12 @@
-{{#if (eq dbSetup "prisma-postgres")}}
-// import "dotenv/config"; uncomment this to load .env
-{{else}}
+{{#unless (eq dbSetup "prisma-postgres")}}
 import "dotenv/config";
-{{/if}}
+{{/unless}}
 import path from "node:path";
 import type { PrismaConfig } from "prisma";
 
 export default {
-  earlyAccess: true,
   schema: path.join("prisma", "schema"),
+  migrations: {
+    path: path.join("prisma", "migrations"),
+  }
 } satisfies PrismaConfig;

package/templates/db/prisma/sqlite/{prisma.config.ts → prisma.config.ts.hbs}

@@ -3,6 +3,8 @@ import path from "node:path";
 import type { PrismaConfig } from "prisma";
 
 export default {
-  earlyAccess: true,
   schema: path.join("prisma", "schema"),
+  migrations: {
+    path: path.join("prisma", "migrations"),
+  }
 } satisfies PrismaConfig;

package/templates/extras/bunfig.toml

@@ -0,0 +1,2 @@
+[install]
+linker = "isolated"

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

@@ -10,17 +10,6 @@
 		"start": "vite",
 		"check-types": "tsc --noEmit"
 	},
-	"devDependencies": {
-		"@tanstack/react-router-devtools": "^1.114.27",
-		"@tanstack/router-plugin": "^1.114.27",
-		"@types/node": "^22.13.13",
-		"@types/react": "^19.0.12",
-		"@types/react-dom": "^19.0.4",
-		"@vitejs/plugin-react": "^4.3.4",
-		"postcss": "^8.5.3",
-		"tailwindcss": "^4.0.15",
-		"vite": "^6.2.2"
-	},
 	"dependencies": {
         "@hookform/resolvers": "^5.1.1",
         "radix-ui": "^1.4.2",
@@ -37,5 +26,17 @@
 		"tailwind-merge": "^3.3.1",
 		"tw-animate-css": "^1.2.5",
 		"zod": "^4.0.2"
+	},
+	"devDependencies": {
+		"@tanstack/react-router-devtools": "^1.114.27",
+		"@tanstack/router-plugin": "^1.114.27",
+		"@types/node": "^22.13.13",
+		"@types/react": "^19.0.12",
+		"@types/react-dom": "^19.0.4",
+		"@vitejs/plugin-react": "^4.3.4",
+		"postcss": "^8.5.3",
+		"typescript": "^5.8.3",
+		"tailwindcss": "^4.0.15",
+		"vite": "^6.2.2"
 	}
 }