create-better-t-stack 3.9.0 → 3.11.0

package/dist/{src-DLvUK0Qf.mjs → src-XVvJUQ_h.mjs}

@@ -95,7 +95,7 @@ const dependencyVersionMap = {
 	"@vite-pwa/assets-generator": "^1.0.0",
 	"@tauri-apps/cli": "^2.4.0",
 	"@biomejs/biome": "^2.2.0",
-	oxlint: "^1.32.0",
+	oxlint: "^1.34.0",
 	oxfmt: "^0.19.0",
 	husky: "^9.1.7",
 	"lint-staged": "^16.1.2",
@@ -117,7 +117,7 @@ const dependencyVersionMap = {
 	"@fastify/cors": "^11.0.1",
 	turbo: "^2.6.3",
 	ai: "^5.0.49",
-	"@ai-sdk/google": "^2.0.13",
+	"@ai-sdk/google": "^2.0.51",
 	"@ai-sdk/vue": "^2.0.49",
 	"@ai-sdk/svelte": "^3.0.39",
 	"@ai-sdk/react": "^2.0.39",
@@ -132,12 +132,13 @@ const dependencyVersionMap = {
 	"@trpc/server": "^11.7.2",
 	"@trpc/client": "^11.7.2",
 	next: "^16.0.10",
-	convex: "^1.29.3",
+	convex: "^1.31.2",
 	"@convex-dev/react-query": "^0.1.0",
+	"@convex-dev/agent": "^0.3.2",
 	"convex-svelte": "^0.0.12",
 	"convex-nuxt": "0.1.5",
 	"convex-vue": "^0.1.5",
-	"@convex-dev/better-auth": "^0.9.7",
+	"@convex-dev/better-auth": "^0.10.6",
 	"@tanstack/svelte-query": "^5.85.3",
 	"@tanstack/svelte-query-devtools": "^5.85.3",
 	"@tanstack/vue-query-devtools": "^5.90.2",
@@ -184,6 +185,8 @@ const ADDON_COMPATIBILITY = {
 	ruler: [],
 	oxlint: [],
 	fumadocs: [],
+	opentui: [],
+	wxt: [],
 	none: []
 };
 
@@ -289,8 +292,12 @@ function isExampleTodoAllowed(backend, database) {
 	return !(backend !== "convex" && backend !== "none" && database === "none");
 }
 function isExampleAIAllowed(backend, frontends = []) {
-	if (backend === "convex") return false;
 	if (frontends.includes("solid")) return false;
+	if (backend === "convex") {
+		const includesNuxt = frontends.includes("nuxt");
+		const includesSvelte = frontends.includes("svelte");
+		if (includesNuxt || includesSvelte) return false;
+	}
 	return true;
 }
 function validateWebDeployRequiresWebFrontend(webDeploy, hasWebFrontendFlag) {
@@ -336,8 +343,13 @@ function validateExamplesCompatibility(examples, backend, database, frontend) {
 	const examplesArr = examples ?? [];
 	if (examplesArr.length === 0 || examplesArr.includes("none")) return;
 	if (examplesArr.includes("todo") && backend !== "convex" && backend !== "none" && database === "none") exitWithError("The 'todo' example requires a database if a backend (other than Convex) is present. Cannot use --examples todo when database is 'none' and a backend is selected.");
-	if (examplesArr.includes("ai") && backend === "convex") exitWithError("The 'ai' example is not yet available with Convex backend.");
 	if (examplesArr.includes("ai") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
+	if (examplesArr.includes("ai") && backend === "convex") {
+		const frontendArr = frontend ?? [];
+		const includesNuxt = frontendArr.includes("nuxt");
+		const includesSvelte = frontendArr.includes("svelte");
+		if (includesNuxt || includesSvelte) exitWithError("The 'ai' example with Convex backend only supports React-based frontends (Next.js, TanStack Router, TanStack Start, React Router). Svelte and Nuxt are not supported with Convex AI.");
+	}
 }
 
 //#endregion
@@ -386,6 +398,14 @@ function getAddonDisplay(addon) {
 			label = "Fumadocs";
 			hint = "Build excellent documentation site";
 			break;
+		case "opentui":
+			label = "OpenTUI";
+			hint = "Build terminal user interfaces";
+			break;
+		case "wxt":
+			label = "WXT";
+			hint = "Build browser extensions";
+			break;
 		default:
 			label = addon;
 			hint = `Add ${addon}`;
@@ -404,10 +424,12 @@ const ADDON_GROUPS = {
 	],
 	Other: [
 		"ruler",
-		"turborepo",
 		"pwa",
 		"tauri",
-		"husky"
+		"husky",
+		"opentui",
+		"wxt",
+		"turborepo"
 	]
 };
 async function getAddonsChoice(addons, frontends, auth) {
@@ -434,6 +456,12 @@ async function getAddonsChoice(addons, frontends, auth) {
 	}
 	Object.keys(groupedOptions).forEach((group$1) => {
 		if (groupedOptions[group$1].length === 0) delete groupedOptions[group$1];
+		else {
+			const groupOrder = ADDON_GROUPS[group$1] || [];
+			groupedOptions[group$1].sort((a, b) => {
+				return groupOrder.indexOf(a.value) - groupOrder.indexOf(b.value);
+			});
+		}
 	});
 	const response = await groupMultiselect({
 		message: "Select addons",
@@ -466,6 +494,12 @@ async function getAddonsToAdd(frontend, existingAddons = [], auth) {
 	}
 	Object.keys(groupedOptions).forEach((group$1) => {
 		if (groupedOptions[group$1].length === 0) delete groupedOptions[group$1];
+		else {
+			const groupOrder = ADDON_GROUPS[group$1] || [];
+			groupedOptions[group$1].sort((a, b) => {
+				return groupOrder.indexOf(a.value) - groupOrder.indexOf(b.value);
+			});
+		}
 	});
 	if (Object.keys(groupedOptions).length === 0) return [];
 	const response = await groupMultiselect({
@@ -1966,7 +2000,7 @@ function getPackageExecutionCommand(packageManager, commandWithArgs) {
 
 //#endregion
 //#region src/helpers/addons/fumadocs-setup.ts
-const TEMPLATES = {
+const TEMPLATES$2 = {
 	"next-mdx": {
 		label: "Next.js: Fumadocs MDX",
 		hint: "Recommended template with MDX support",
@@ -1999,7 +2033,7 @@ async function setupFumadocs(config) {
 		log.info("Setting up Fumadocs...");
 		const template = await select({
 			message: "Choose a template",
-			options: Object.entries(TEMPLATES).map(([key, template$1]) => ({
+			options: Object.entries(TEMPLATES$2).map(([key, template$1]) => ({
 				value: key,
 				label: template$1.label,
 				hint: template$1.hint
@@ -2007,7 +2041,7 @@ async function setupFumadocs(config) {
 			initialValue: "next-mdx"
 		});
 		if (isCancel(template)) return exitCancelled("Operation cancelled");
-		const fumadocsInitCommand = getPackageExecutionCommand(packageManager, `create-fumadocs-app@latest fumadocs --template ${TEMPLATES[template].value} --src --pm ${packageManager} --no-git`);
+		const fumadocsInitCommand = getPackageExecutionCommand(packageManager, `create-fumadocs-app@latest fumadocs --template ${TEMPLATES$2[template].value} --src --pm ${packageManager} --no-git`);
 		const appsDir = path.join(projectDir, "apps");
 		await fs.ensureDir(appsDir);
 		const s = spinner();
@@ -2235,6 +2269,53 @@ async function setupTauri(config) {
 	}
 }
 
+//#endregion
+//#region src/helpers/addons/tui-setup.ts
+const TEMPLATES$1 = {
+	core: {
+		label: "Core",
+		hint: "Basic OpenTUI template"
+	},
+	react: {
+		label: "React",
+		hint: "React-based OpenTUI template"
+	},
+	solid: {
+		label: "Solid",
+		hint: "SolidJS-based OpenTUI template"
+	}
+};
+async function setupTui(config) {
+	const { packageManager, projectDir } = config;
+	try {
+		log.info("Setting up OpenTUI...");
+		const template = await select({
+			message: "Choose a template",
+			options: Object.entries(TEMPLATES$1).map(([key, template$1]) => ({
+				value: key,
+				label: template$1.label,
+				hint: template$1.hint
+			})),
+			initialValue: "core"
+		});
+		if (isCancel(template)) return exitCancelled("Operation cancelled");
+		const tuiInitCommand = getPackageExecutionCommand(packageManager, `create-tui@latest --template ${template} --no-git --no-install tui`);
+		const appsDir = path.join(projectDir, "apps");
+		await fs.ensureDir(appsDir);
+		const s = spinner();
+		s.start("Running OpenTUI create command...");
+		await execa(tuiInitCommand, {
+			cwd: appsDir,
+			env: { CI: "true" },
+			shell: true
+		});
+		s.stop("OpenTUI setup complete!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up OpenTUI"));
+		if (error instanceof Error) console.error(pc.red(error.message));
+	}
+}
+
 //#endregion
 //#region src/helpers/addons/ultracite-setup.ts
 const EDITORS = {
@@ -2347,9 +2428,72 @@ async function setupUltracite(config, hasHusky) {
 	}
 }
 
+//#endregion
+//#region src/helpers/addons/wxt-setup.ts
+const TEMPLATES = {
+	vanilla: {
+		label: "Vanilla",
+		hint: "Vanilla JavaScript template"
+	},
+	vue: {
+		label: "Vue",
+		hint: "Vue.js template"
+	},
+	react: {
+		label: "React",
+		hint: "React template"
+	},
+	solid: {
+		label: "Solid",
+		hint: "SolidJS template"
+	},
+	svelte: {
+		label: "Svelte",
+		hint: "Svelte template"
+	}
+};
+async function setupWxt(config) {
+	const { packageManager, projectDir } = config;
+	try {
+		log.info("Setting up WXT...");
+		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: "react"
+		});
+		if (isCancel(template)) return exitCancelled("Operation cancelled");
+		const wxtInitCommand = getPackageExecutionCommand(packageManager, `wxt@latest init extension --template ${template} --pm ${packageManager}`);
+		const appsDir = path.join(projectDir, "apps");
+		await fs.ensureDir(appsDir);
+		const s = spinner();
+		s.start("Running WXT init command...");
+		await execa(wxtInitCommand, {
+			cwd: appsDir,
+			env: { CI: "true" },
+			shell: true
+		});
+		const extensionDir = path.join(projectDir, "apps", "extension");
+		const packageJsonPath = path.join(extensionDir, "package.json");
+		if (await fs.pathExists(packageJsonPath)) {
+			const packageJson = await fs.readJson(packageJsonPath);
+			packageJson.name = "extension";
+			if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port 5555`;
+			await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+		}
+		s.stop("WXT setup complete!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up WXT"));
+		if (error instanceof Error) console.error(pc.red(error.message));
+	}
+}
+
 //#endregion
 //#region src/utils/ts-morph.ts
-const tsProject = new Project({
+const tsProject$1 = new Project({
 	useInMemoryFileSystem: false,
 	skipAddingFilesFromTsConfig: true,
 	manipulationSettings: {
@@ -2367,7 +2511,7 @@ function ensureArrayProperty(obj, name) {
 //#endregion
 //#region src/helpers/addons/vite-pwa-setup.ts
 async function addPwaToViteConfig(viteConfigPath, projectName) {
-	const sourceFile = tsProject.addSourceFileAtPathIfExists(viteConfigPath);
+	const sourceFile = tsProject$1.addSourceFileAtPathIfExists(viteConfigPath);
 	if (!sourceFile) throw new Error("vite config not found");
 	if (!sourceFile.getImportDeclarations().some((imp) => imp.getModuleSpecifierValue() === "vite-plugin-pwa")) sourceFile.insertImportDeclaration(0, {
 		namedImports: ["VitePWA"],
@@ -2392,7 +2536,7 @@ async function addPwaToViteConfig(viteConfigPath, projectName) {
   pwaAssets: { disabled: false, config: true },
   devOptions: { enabled: true },
 })`);
-	await tsProject.save();
+	await tsProject$1.save();
 }
 
 //#endregion
@@ -2437,6 +2581,8 @@ ${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
 	if (addons.includes("starlight")) await setupStarlight(config);
 	if (addons.includes("ruler")) await setupRuler(config);
 	if (addons.includes("fumadocs")) await setupFumadocs(config);
+	if (addons.includes("opentui")) await setupTui(config);
+	if (addons.includes("wxt")) await setupWxt(config);
 }
 function getWebAppDir(projectDir, frontends) {
 	if (frontends.some((f) => [
@@ -2623,7 +2769,7 @@ handlebars.registerHelper("includes", (array, value) => Array.isArray(array) &&
 
 //#endregion
 //#region src/helpers/deployment/alchemy/env-dts-setup.ts
-const tsProject$1 = new Project({
+const tsProject = new Project({
 	useInMemoryFileSystem: false,
 	skipAddingFilesFromTsConfig: true
 });
@@ -2642,7 +2788,7 @@ function determineImportPath(envDtsPath, projectDir, config) {
 async function setupEnvDtsImport(envDtsPath, projectDir, config) {
 	if (!await fs.pathExists(envDtsPath)) return;
 	const importPath = determineImportPath(envDtsPath, projectDir, config);
-	const sourceFile = tsProject$1.addSourceFileAtPath(envDtsPath);
+	const sourceFile = tsProject.addSourceFileAtPath(envDtsPath);
 	if (!sourceFile.getImportDeclarations().some((imp) => imp.getModuleSpecifierValue() === importPath && imp.getNamedImports().some((named) => named.getName() === "server"))) sourceFile.insertImportDeclaration(0, {
 		moduleSpecifier: importPath,
 		namedImports: [{
@@ -3071,10 +3217,6 @@ async function setupExamplesTemplate(projectDir, context) {
 			if (hasReactWeb) {
 				const exampleWebSrc = path.join(exampleBaseDir, "web/react");
 				if (await fs.pathExists(exampleWebSrc)) {
-					if (example === "ai") {
-						const exampleWebBaseSrc = path.join(exampleWebSrc, "base");
-						if (await fs.pathExists(exampleWebBaseSrc)) await processAndCopyFiles("**/*", exampleWebBaseSrc, webAppDir, context, false);
-					}
 					const reactFramework = context.frontend.find((f) => [
 						"next",
 						"react-router",
@@ -3836,62 +3978,84 @@ async function updatePackageJsonsWithCatalogs(packagesInfo, catalog) {
 //#endregion
 //#region src/helpers/addons/examples-setup.ts
 async function setupExamples(config) {
-	const { examples, frontend, backend, projectDir, orm, database } = config;
-	if (backend === "convex" || !examples || examples.length === 0 || examples[0] === "none") return;
+	const { examples, backend } = config;
+	if (!examples || examples.length === 0 || examples[0] === "none") return;
+	if (examples.includes("todo") && backend !== "convex" && backend !== "none") await setupTodoDependencies(config);
+	if (examples.includes("ai")) await setupAIDependencies(config);
+}
+async function setupTodoDependencies(config) {
+	const { projectDir, orm, database, backend } = config;
 	const apiDir = path.join(projectDir, "packages/api");
-	if (await fs.pathExists(apiDir) && backend !== "none") {
-		if (orm === "drizzle") {
-			const dependencies = ["drizzle-orm"];
-			if (database === "postgres") dependencies.push("@types/pg");
-			await addPackageDependency({
-				dependencies,
-				projectDir: apiDir
-			});
-		} else if (orm === "prisma") await addPackageDependency({
-			dependencies: ["@prisma/client"],
-			projectDir: apiDir
-		});
-		else if (orm === "mongoose") await addPackageDependency({
-			dependencies: ["mongoose"],
+	if (!await fs.pathExists(apiDir) || backend === "none") return;
+	if (orm === "drizzle") {
+		const dependencies = ["drizzle-orm"];
+		if (database === "postgres") dependencies.push("@types/pg");
+		await addPackageDependency({
+			dependencies,
 			projectDir: apiDir
 		});
-	}
-	if (examples.includes("ai")) {
-		const webClientDir = path.join(projectDir, "apps/web");
-		const nativeClientDir = path.join(projectDir, "apps/native");
-		const apiDir$1 = path.join(projectDir, "packages/api");
-		const webClientDirExists = await fs.pathExists(webClientDir);
-		const nativeClientDirExists = await fs.pathExists(nativeClientDir);
-		const apiDirExists = await fs.pathExists(apiDir$1);
-		const hasNuxt = frontend.includes("nuxt");
-		const hasSvelte = frontend.includes("svelte");
-		const hasReactWeb = frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("next") || frontend.includes("tanstack-start");
-		const hasNext = frontend.includes("next");
-		const hasReactNative = frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles");
-		if (webClientDirExists) {
-			const dependencies = ["ai"];
+	} else if (orm === "prisma") await addPackageDependency({
+		dependencies: ["@prisma/client"],
+		projectDir: apiDir
+	});
+	else if (orm === "mongoose") await addPackageDependency({
+		dependencies: ["mongoose"],
+		projectDir: apiDir
+	});
+}
+async function setupAIDependencies(config) {
+	const { frontend, backend, projectDir } = config;
+	const webClientDir = path.join(projectDir, "apps/web");
+	const nativeClientDir = path.join(projectDir, "apps/native");
+	const serverDir = path.join(projectDir, "apps/server");
+	const convexBackendDir = path.join(projectDir, "packages/backend");
+	const webClientDirExists = await fs.pathExists(webClientDir);
+	const nativeClientDirExists = await fs.pathExists(nativeClientDir);
+	const serverDirExists = await fs.pathExists(serverDir);
+	const convexBackendDirExists = await fs.pathExists(convexBackendDir);
+	const hasReactWeb = frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("next") || frontend.includes("tanstack-start");
+	const hasNuxt = frontend.includes("nuxt");
+	const hasSvelte = frontend.includes("svelte");
+	const hasReactNative = frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles");
+	if (backend === "convex" && convexBackendDirExists) await addPackageDependency({
+		dependencies: [
+			"@convex-dev/agent",
+			"ai",
+			"@ai-sdk/google"
+		],
+		projectDir: convexBackendDir
+	});
+	else if (backend === "self" && webClientDirExists) await addPackageDependency({
+		dependencies: ["ai", "@ai-sdk/google"],
+		projectDir: webClientDir
+	});
+	else if (serverDirExists && backend !== "none") await addPackageDependency({
+		dependencies: ["ai", "@ai-sdk/google"],
+		projectDir: serverDir
+	});
+	if (webClientDirExists) {
+		const dependencies = [];
+		if (backend === "convex") {
+			if (hasReactWeb) dependencies.push("@convex-dev/agent", "streamdown");
+		} else {
+			dependencies.push("ai");
 			if (hasNuxt) dependencies.push("@ai-sdk/vue");
 			else if (hasSvelte) dependencies.push("@ai-sdk/svelte");
 			else if (hasReactWeb) dependencies.push("@ai-sdk/react", "streamdown");
-			if (hasNext) dependencies.push("shiki");
-			await addPackageDependency({
-				dependencies,
-				projectDir: webClientDir
-			});
 		}
-		if (nativeClientDirExists && hasReactNative) await addPackageDependency({
-			dependencies: ["ai", "@ai-sdk/react"],
-			projectDir: nativeClientDir
-		});
-		if (apiDirExists && backend !== "none") await addPackageDependency({
-			dependencies: ["ai", "@ai-sdk/google"],
-			projectDir: apiDir$1
-		});
-		if (backend === "self" && webClientDirExists) await addPackageDependency({
-			dependencies: ["ai", "@ai-sdk/google"],
+		if (dependencies.length > 0) await addPackageDependency({
+			dependencies,
 			projectDir: webClientDir
 		});
 	}
+	if (nativeClientDirExists && hasReactNative) if (backend === "convex") await addPackageDependency({
+		dependencies: ["@convex-dev/agent"],
+		projectDir: nativeClientDir
+	});
+	else await addPackageDependency({
+		dependencies: ["ai", "@ai-sdk/react"],
+		projectDir: nativeClientDir
+	});
 }
 
 //#endregion
@@ -4089,7 +4253,7 @@ async function setupApi(config) {
 //#endregion
 //#region src/helpers/core/backend-setup.ts
 async function setupBackendDependencies(config) {
-	const { backend, runtime, api, auth, examples, projectDir } = config;
+	const { backend, runtime, api, auth, projectDir } = config;
 	if (backend === "convex") {
 		await addPackageDependency({
 			dependencies: ["convex"],
@@ -4117,7 +4281,6 @@ async function setupBackendDependencies(config) {
 		else if (framework === "elysia") dependencies.push("@elysiajs/trpc");
 	} else if (api === "orpc") dependencies.push("@orpc/server", "@orpc/openapi", "@orpc/zod");
 	if (auth === "better-auth") dependencies.push("better-auth");
-	if (examples.includes("ai")) dependencies.push("ai", "@ai-sdk/google");
 	if (runtime === "node") devDependencies.push("tsx", "@types/node");
 	else if (runtime === "bun") devDependencies.push("@types/bun");
 	if (dependencies.length > 0 || devDependencies.length > 0) await addPackageDependency({
@@ -4131,7 +4294,7 @@ async function setupBackendDependencies(config) {
 //#region src/utils/better-auth-plugin-setup.ts
 async function setupBetterAuthPlugins(projectDir, config) {
 	const authIndexPath = `${projectDir}/packages/auth/src/index.ts`;
-	const authIndexFile = tsProject.addSourceFileAtPath(authIndexPath);
+	const authIndexFile = tsProject$1.addSourceFileAtPath(authIndexPath);
 	if (!authIndexFile) return;
 	const pluginsToAdd = [];
 	const importsToAdd = [];
@@ -4204,12 +4367,12 @@ async function setupAuth(config) {
 				if (convexBackendDirExists) {
 					await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.3.34" },
+						customDependencies: { "better-auth": "1.4.7" },
 						projectDir: convexBackendDir
 					});
 					if (hasNativeForBA) await addPackageDependency({
 						dependencies: ["@better-auth/expo"],
-						customDependencies: { "@better-auth/expo": "1.3.34" },
+						customDependencies: { "@better-auth/expo": "1.4.7" },
 						projectDir: convexBackendDir
 					});
 				}
@@ -4219,17 +4382,17 @@ async function setupAuth(config) {
 					const hasViteReactOther = frontend.some((f) => ["tanstack-router", "react-router"].includes(f));
 					if (hasNextJs) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.3.34" },
+						customDependencies: { "better-auth": "1.4.7" },
 						projectDir: clientDir
 					});
 					else if (hasTanStackStart) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.3.34" },
+						customDependencies: { "better-auth": "1.4.7" },
 						projectDir: clientDir
 					});
 					else if (hasViteReactOther) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.3.34" },
+						customDependencies: { "better-auth": "1.4.7" },
 						projectDir: clientDir
 					});
 				}
@@ -4243,8 +4406,8 @@ async function setupAuth(config) {
 						"@convex-dev/better-auth"
 					],
 					customDependencies: {
-						"better-auth": "1.3.34",
-						"@better-auth/expo": "1.3.34"
+						"better-auth": "1.4.7",
+						"@better-auth/expo": "1.4.7"
 					},
 					projectDir: nativeDir
 				});
@@ -4479,20 +4642,32 @@ async function setupEnvironmentVariables(config) {
 		}
 	}
 	if (backend === "convex") {
-		if (auth === "better-auth") {
-			const convexBackendDir = path.join(projectDir, "packages/backend");
-			if (await fs.pathExists(convexBackendDir)) {
-				const envLocalPath = path.join(convexBackendDir, ".env.local");
+		const convexBackendDir = path.join(projectDir, "packages/backend");
+		if (await fs.pathExists(convexBackendDir)) {
+			const envLocalPath = path.join(convexBackendDir, ".env.local");
+			let commentBlocks = "";
+			if (examples?.includes("ai")) commentBlocks += `# Set Google AI API key for AI agent
+# npx convex env set GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key
+
+`;
+			if (auth === "better-auth") commentBlocks += `# Set Convex environment variables
+# npx convex env set BETTER_AUTH_SECRET=$(openssl rand -base64 32)
+${hasWebFrontend$1 ? "# npx convex env set SITE_URL http://localhost:3001\n" : ""}`;
+			if (commentBlocks) {
+				let existingContent = "";
+				if (await fs.pathExists(envLocalPath)) existingContent = await fs.readFile(envLocalPath, "utf8");
+				await fs.writeFile(envLocalPath, commentBlocks + existingContent);
+			}
+			const convexBackendVars = [];
+			if (examples?.includes("ai")) convexBackendVars.push({
+				key: "GOOGLE_GENERATIVE_AI_API_KEY",
+				value: "",
+				condition: true,
+				comment: "Google AI API key for AI agent"
+			});
+			if (auth === "better-auth") {
 				const hasNative = frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles");
 				const hasWeb = hasWebFrontend$1;
-				if (!await fs.pathExists(envLocalPath) || !(await fs.readFile(envLocalPath, "utf8")).includes("npx convex env set")) {
-					const convexCommands = `# Set Convex environment variables
-# npx convex env set BETTER_AUTH_SECRET=$(openssl rand -base64 32)
-${hasWeb ? "# npx convex env set SITE_URL http://localhost:3001\n" : ""}
-`;
-					await fs.appendFile(envLocalPath, convexCommands);
-				}
-				const convexBackendVars = [];
 				if (hasNative) convexBackendVars.push({
 					key: "EXPO_PUBLIC_CONVEX_SITE_URL",
 					value: "",
@@ -4507,10 +4682,11 @@ ${hasWeb ? "# npx convex env set SITE_URL http://localhost:3001\n" : ""}
 				}, {
 					key: "SITE_URL",
 					value: "http://localhost:3001",
-					condition: true
+					condition: true,
+					comment: "Web app URL for authentication"
 				});
-				await addEnvVariablesToFile(envLocalPath, convexBackendVars);
 			}
+			if (convexBackendVars.length > 0) await addEnvVariablesToFile(envLocalPath, convexBackendVars);
 		}
 		return;
 	}
@@ -6148,7 +6324,7 @@ async function displayPostInstallInstructions(config) {
 	const tauriInstructions = addons?.includes("tauri") ? getTauriInstructions(runCmd) : "";
 	const huskyInstructions = hasHusky ? getHuskyInstructions(runCmd) : "";
 	const lintingInstructions = hasLinting ? getLintingInstructions(runCmd) : "";
-	const nativeInstructions = (frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles")) && backend !== "none" ? getNativeInstructions(isConvex, isBackendSelf, frontend || []) : "";
+	const nativeInstructions = (frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles")) && backend !== "none" ? getNativeInstructions(isConvex, isBackendSelf, frontend || [], runCmd) : "";
 	const pwaInstructions = addons?.includes("pwa") && frontend?.includes("react-router") ? getPwaInstructions() : "";
 	const starlightInstructions = addons?.includes("starlight") ? getStarlightInstructions(runCmd) : "";
 	const clerkInstructions = isConvex && config.auth === "clerk" ? getClerkInstructions() : "";
@@ -6214,13 +6390,14 @@ async function displayPostInstallInstructions(config) {
 	output += pc.cyan("https://github.com/AmanVarshney01/create-better-t-stack");
 	consola$1.box(output);
 }
-function getNativeInstructions(isConvex, isBackendSelf, _frontend) {
+function getNativeInstructions(isConvex, isBackendSelf, frontend, runCmd) {
 	const envVar = isConvex ? "EXPO_PUBLIC_CONVEX_URL" : "EXPO_PUBLIC_SERVER_URL";
 	const exampleUrl = isConvex ? "https://<YOUR_CONVEX_URL>" : isBackendSelf ? "http://<YOUR_LOCAL_IP>:3001" : "http://<YOUR_LOCAL_IP>:3000";
 	const envFileName = ".env";
 	const ipNote = isConvex ? "your Convex deployment URL (find after running 'dev:setup')" : "your local IP address";
 	let instructions = `${pc.yellow("NOTE:")} For Expo connectivity issues, update\n   apps/native/${envFileName} with ${ipNote}:\n   ${`${envVar}=${exampleUrl}`}\n`;
 	if (isConvex) instructions += `\n${pc.yellow("IMPORTANT:")} When using local development with Convex and native apps,\n   ensure you use your local IP address instead of localhost or 127.0.0.1\n   for proper connectivity.\n`;
+	if (frontend.includes("native-unistyles")) instructions += `\n${pc.yellow("NOTE:")} Unistyles requires a development build.\n   cd apps/native and run ${runCmd} android or ${runCmd} ios\n`;
 	return instructions;
 }
 function getHuskyInstructions(runCmd) {
@@ -6594,8 +6771,8 @@ async function createProject(options, cliInput) {
 		if (!isConvex) {
 			if (needsServerSetup) await setupRuntime(options);
 			await setupDatabase(options, cliInput);
-			if (options.examples.length > 0 && options.examples[0] !== "none") await setupExamples(options);
 		}
+		if (options.examples.length > 0 && options.examples[0] !== "none") await setupExamples(options);
 		if (options.addons.length > 0 && options.addons[0] !== "none") await setupAddons(options);
 		if (options.auth && options.auth !== "none") await setupAuth(options);
 		if (options.payments && options.payments !== "none") await setupPayments(options);