create-better-fullstack 1.3.17 → 1.4.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { s as createBtsCli } from "./src-BYQLJiGD.mjs";
+import { s as createBtsCli } from "./src-p54ND5wJ.mjs";
 
 //#region src/cli.ts
 createBtsCli().run();

package/dist/index.d.mts

@@ -252,6 +252,7 @@ declare const router: {
     examples: z.ZodOptional<z.ZodArray<z.ZodEnum<{
       none: "none";
       ai: "ai";
+      "chat-sdk": "chat-sdk";
     }>>>;
     git: z.ZodOptional<z.ZodBoolean>;
     packageManager: z.ZodOptional<z.ZodEnum<{
@@ -452,7 +453,7 @@ declare const router: {
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
       addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "mcp" | "skills" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook")[];
-      examples: ("ai" | "none")[];
+      examples: ("ai" | "none" | "chat-sdk")[];
       auth: "none" | "better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;
@@ -531,7 +532,7 @@ declare const router: {
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
       addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "mcp" | "skills" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook")[];
-      examples: ("ai" | "none")[];
+      examples: ("ai" | "none" | "chat-sdk")[];
       auth: "none" | "better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;

package/dist/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as builder, c as createVirtual, d as history, f as router, i as add, l as docs, n as TEMPLATE_COUNT, o as create, p as sponsors, r as VirtualFileSystem, s as createBtsCli, t as EMBEDDED_TEMPLATES, u as generateVirtualProject } from "./src-BYQLJiGD.mjs";
+import { a as builder, c as createVirtual, d as history, f as router, i as add, l as docs, n as TEMPLATE_COUNT, o as create, p as sponsors, r as VirtualFileSystem, s as createBtsCli, t as EMBEDDED_TEMPLATES, u as generateVirtualProject } from "./src-p54ND5wJ.mjs";
 
 export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, history, router, sponsors };

package/dist/{src-BYQLJiGD.mjs → src-p54ND5wJ.mjs}

@@ -18,8 +18,8 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import { ConfirmPrompt, GroupMultiSelectPrompt, MultiSelectPrompt, SelectPrompt, isCancel as isCancel$1 } from "@clack/core";
 import * as JSONC from "jsonc-parser";
 import { $, execa } from "execa";
-import { format } from "oxfmt";
 import os$1 from "node:os";
+import { format } from "oxfmt";
 
 //#region src/utils/get-package-manager.ts
 const getUserPkgManager = () => {
@@ -929,7 +929,7 @@ const WORKERS_COMPATIBLE_BACKENDS = [
 ];
 function validateWorkersCompatibility(providedFlags, options, config) {
 	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend)) incompatibilityError({
-		message: "Cloudflare Workers runtime requires a compatible backend.",
+		message: "In Better-Fullstack, Cloudflare Workers runtime is currently supported only with compatible backends (Hono, Nitro, or Fets).",
 		provided: {
 			runtime: "workers",
 			backend: config.backend
@@ -942,7 +942,7 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 		]
 	});
 	if (providedFlags.has("backend") && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend) && config.runtime === "workers") incompatibilityError({
-		message: `Backend '${config.backend}' is not compatible with Workers runtime.`,
+		message: `In Better-Fullstack, backend '${config.backend}' is currently not available with Cloudflare Workers runtime.`,
 		provided: {
 			backend: config.backend,
 			runtime: "workers"
@@ -950,7 +950,7 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 		suggestions: ["Use --backend hono, --backend nitro, or --backend fets", "Choose a different runtime (node, bun)"]
 	});
 	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") incompatibilityError({
-		message: "Cloudflare Workers runtime is not compatible with MongoDB.",
+		message: "In Better-Fullstack, Cloudflare Workers runtime is currently not available with MongoDB.",
 		provided: {
 			runtime: "workers",
 			database: "mongodb"
@@ -958,7 +958,7 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 		suggestions: ["Use a different database (postgres, sqlite, mysql)", "Choose a different runtime (node, bun)"]
 	});
 	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") incompatibilityError({
-		message: "Cloudflare Workers runtime is not compatible with Docker setup.",
+		message: "In Better-Fullstack, Cloudflare Workers runtime is currently not available with Docker database setup.",
 		provided: {
 			runtime: "workers",
 			"db-setup": "docker"
@@ -966,7 +966,7 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 		suggestions: ["Use --db-setup d1 for SQLite", "Choose a different runtime (node, bun)"]
 	});
 	if (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") incompatibilityError({
-		message: "MongoDB is not compatible with Cloudflare Workers runtime.",
+		message: "In Better-Fullstack, MongoDB is currently not available with Cloudflare Workers runtime.",
 		provided: {
 			database: "mongodb",
 			runtime: "workers"
@@ -1062,6 +1062,9 @@ function isFrontendAllowedWithBackend(frontend, backend, auth) {
 			"solid"
 		].includes(frontend)) return false;
 	}
+	if (auth === "clerk" && backend === "self") {
+		if (!["next", "tanstack-start"].includes(frontend)) return false;
+	}
 	if (auth === "nextauth") {
 		if (frontend !== "next") return false;
 		if (backend !== "self") return false;
@@ -1072,29 +1075,57 @@ function isFrontendAllowedWithBackend(frontend, backend, auth) {
 	}
 	return true;
 }
+function validateClerkCompatibility(auth, backend, frontends = []) {
+	if (auth !== "clerk") return;
+	if (backend === "convex") {
+		const incompatibleFrontends = frontends.filter((f) => [
+			"nuxt",
+			"svelte",
+			"solid"
+		].includes(f));
+		if (incompatibleFrontends.length > 0) exitWithError(`In Better-Fullstack, Clerk + Convex is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
+		return;
+	}
+	if (backend === "self") {
+		if (frontends.some((f) => [
+			"native-bare",
+			"native-uniwind",
+			"native-unistyles"
+		].includes(f))) exitWithError("In Better-Fullstack, Clerk with the 'self' backend is currently supported only for web-only Next.js or TanStack Start projects (no native companion app). Please remove the native frontend or choose a different auth provider.");
+		const hasNextJs = frontends.includes("next");
+		const hasTanStackStart = frontends.includes("tanstack-start");
+		if (!hasNextJs && !hasTanStackStart) {
+			if (frontends.includes("astro")) exitWithError("In Better-Fullstack, Clerk is not yet supported for Astro fullstack projects. Please use '--frontend next' or '--frontend tanstack-start' with '--backend self', or choose a different auth provider.");
+			if (frontends.includes("nuxt")) exitWithError("In Better-Fullstack, Clerk is not yet supported for Nuxt fullstack projects. Please use '--frontend next' or '--frontend tanstack-start' with '--backend self', or choose a different auth provider.");
+			exitWithError("In Better-Fullstack, Clerk with the 'self' backend currently requires the Next.js or TanStack Start frontend. Please use '--frontend next' or '--frontend tanstack-start', or choose a different auth provider.");
+		}
+		return;
+	}
+	exitWithError("In Better-Fullstack, Clerk authentication is currently supported with the Convex backend, or with the 'self' backend when using Next.js or TanStack Start. Please choose a supported backend/frontend combination or a different auth provider.");
+}
 function validateNextAuthCompatibility(auth, backend, frontends = []) {
 	if (auth !== "nextauth") return;
 	const hasNextJs = frontends.includes("next");
-	if (backend !== "self") exitWithError("Auth.js (NextAuth) is only supported with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
-	if (!hasNextJs) exitWithError("Auth.js (NextAuth) requires Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
+	if (backend !== "self") exitWithError("In Better-Fullstack, Auth.js (NextAuth) is currently supported only with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
+	if (!hasNextJs) exitWithError("In Better-Fullstack, Auth.js (NextAuth) currently requires the Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
 }
 function validateStackAuthCompatibility(auth, backend, frontends = []) {
 	if (auth !== "stack-auth") return;
 	const hasNextJs = frontends.includes("next");
-	if (backend !== "self") exitWithError("Stack Auth is only supported with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
-	if (!hasNextJs) exitWithError("Stack Auth requires Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
+	if (backend !== "self") exitWithError("In Better-Fullstack, Stack Auth is currently supported only with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
+	if (!hasNextJs) exitWithError("In Better-Fullstack, Stack Auth currently requires the Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
 }
 function validateSupabaseAuthCompatibility(auth, backend, frontends = []) {
 	if (auth !== "supabase-auth") return;
 	const hasNextJs = frontends.includes("next");
-	if (backend !== "self") exitWithError("Supabase Auth is only supported with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
-	if (!hasNextJs) exitWithError("Supabase Auth requires Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
+	if (backend !== "self") exitWithError("In Better-Fullstack, Supabase Auth is currently supported only with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
+	if (!hasNextJs) exitWithError("In Better-Fullstack, Supabase Auth currently requires the Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
 }
 function validateAuth0Compatibility(auth, backend, frontends = []) {
 	if (auth !== "auth0") return;
 	const hasNextJs = frontends.includes("next");
-	if (backend !== "self") exitWithError("Auth0 is only supported with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
-	if (!hasNextJs) exitWithError("Auth0 requires Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
+	if (backend !== "self") exitWithError("In Better-Fullstack, Auth0 is currently supported only with the 'self' backend (fullstack Next.js). Please use '--backend self' or choose a different auth provider.");
+	if (!hasNextJs) exitWithError("In Better-Fullstack, Auth0 currently requires the Next.js frontend. Please use '--frontend next' or choose a different auth provider.");
 }
 function allowedApisForFrontends(frontends = [], astroIntegration) {
 	const includesNuxt = frontends.includes("nuxt");
@@ -1129,6 +1160,24 @@ function isExampleAIAllowed(backend, frontends = []) {
 	}
 	return true;
 }
+function hasExampleChatSdkSelfFrontend(frontends = []) {
+	return frontends.some((f) => [
+		"next",
+		"tanstack-start",
+		"nuxt"
+	].includes(f));
+}
+function isExampleChatSdkAllowed(backend, frontends = [], runtime) {
+	if (!backend || backend === "none" || backend === "convex") return false;
+	if (backend === "self") return hasExampleChatSdkSelfFrontend(frontends);
+	if (backend === "hono") return runtime === "node";
+	return false;
+}
+function requiresChatSdkVercelAI(backend, frontends = [], runtime) {
+	if (backend === "self" && frontends.includes("nuxt")) return true;
+	if (backend === "hono" && runtime === "node") return true;
+	return false;
+}
 function validateWebDeployRequiresWebFrontend(webDeploy, hasWebFrontendFlag) {
 	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) exitWithError("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
 }
@@ -1168,7 +1217,7 @@ function validatePaymentsCompatibility(payments, auth, _backend, frontends = [])
 		if (web.length === 0 && frontends.length > 0) exitWithError("Polar payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.");
 	}
 }
-function validateExamplesCompatibility(examples, backend, frontend) {
+function validateExamplesCompatibility(examples, backend, frontend, runtime, ai) {
 	const examplesArr = examples ?? [];
 	if (examplesArr.length === 0 || examplesArr.includes("none")) return;
 	if (examplesArr.includes("ai") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
@@ -1178,6 +1227,17 @@ function validateExamplesCompatibility(examples, backend, frontend) {
 		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.");
 	}
+	if (examplesArr.includes("chat-sdk")) {
+		const frontendArr = frontend ?? [];
+		if (!isExampleChatSdkAllowed(backend, frontendArr, runtime)) {
+			if (backend === "none") exitWithError("The 'chat-sdk' example requires a backend.");
+			if (backend === "convex") exitWithError("The 'chat-sdk' example is not supported with the Convex backend in v1. Use self backend (Next.js, TanStack Start, Nuxt) or Hono with Node runtime.");
+			if (backend === "self") exitWithError("The 'chat-sdk' example with self backend only supports Next.js, TanStack Start, or Nuxt frontends in v1.");
+			if (backend === "hono" && runtime !== "node") exitWithError("The 'chat-sdk' example with Hono requires '--runtime node' in v1 (Bun/Workers not supported yet).");
+			exitWithError("The 'chat-sdk' example is only supported with self backend (Next.js, TanStack Start, Nuxt) or Hono with Node runtime in v1.");
+		}
+		if (requiresChatSdkVercelAI(backend, frontendArr, runtime) && ai && ai !== "vercel-ai") exitWithError("The 'chat-sdk' example requires '--ai vercel-ai' for the selected stack in v1 (Nuxt Discord and Hono GitHub profiles).");
+	}
 }
 /**
 * Validates that a UI library is compatible with the selected frontend(s)
@@ -2408,7 +2468,8 @@ const SKILL_SOURCES = {
 	"prisma/skills": { label: "Prisma" },
 	"elysiajs/skills": { label: "ElysiaJS" },
 	"waynesutton/convexskills": { label: "Convex" },
-	"msmps/opentui-skill": { label: "OpenTUI Platform" }
+	"msmps/opentui-skill": { label: "OpenTUI Platform" },
+	"haydenbleasel/ultracite": { label: "Ultracite" }
 };
 const AVAILABLE_AGENTS = [
 	{
@@ -2540,6 +2601,7 @@ function getRecommendedSourceKeys(config) {
 	if (backend === "elysia") sources.push("elysiajs/skills");
 	if (backend === "convex") sources.push("waynesutton/convexskills");
 	if (addons.includes("opentui")) sources.push("msmps/opentui-skill");
+	if (addons.includes("ultracite")) sources.push("haydenbleasel/ultracite");
 	return sources;
 }
 const CURATED_SKILLS_BY_SOURCE = {
@@ -2597,7 +2659,8 @@ const CURATED_SKILLS_BY_SOURCE = {
 		"convex-migrations",
 		"convex-security-check"
 	],
-	"msmps/opentui-skill": () => ["opentui"]
+	"msmps/opentui-skill": () => ["opentui"],
+	"haydenbleasel/ultracite": () => ["ultracite"]
 };
 function getCuratedSkillNamesForSourceKey(sourceKey, config) {
 	return CURATED_SKILLS_BY_SOURCE[sourceKey](config);
@@ -3567,16 +3630,26 @@ async function getAuthChoice(auth, backend, frontend) {
 		if (isCancel$1(response$1)) return exitCancelled("Operation cancelled");
 		return response$1;
 	}
-	const supportsNextJsAuth = frontend?.includes("next") && backend === "self";
+	const hasNextJs = frontend?.includes("next");
+	const hasTanStackStart = frontend?.includes("tanstack-start");
+	const isSelfBackend = backend === "self";
+	const supportsNextJsAuth = hasNextJs && isSelfBackend;
+	const hasNativeFrontend$2 = frontend?.some((f) => [
+		"native-bare",
+		"native-uniwind",
+		"native-unistyles"
+	].includes(f));
+	const supportsClerkSelf = isSelfBackend && !hasNativeFrontend$2 && Boolean(hasNextJs || hasTanStackStart);
 	const options = [{
 		value: "better-auth",
 		label: "Better-Auth",
 		hint: "comprehensive auth framework for TypeScript"
-	}, {
+	}];
+	if (supportsClerkSelf) options.push({
 		value: "clerk",
 		label: "Clerk",
 		hint: "More than auth, Complete User Management"
-	}];
+	});
 	if (supportsNextJsAuth) {
 		options.push({
 			value: "nextauth",
@@ -4080,7 +4153,7 @@ async function getEmailChoice(email, backend) {
 
 //#endregion
 //#region src/prompts/examples.ts
-async function getExamplesChoice(examples, frontends, backend) {
+async function getExamplesChoice(examples, frontends, backend, runtime) {
 	if (examples !== void 0) return examples;
 	if (backend === "none") return [];
 	let response = [];
@@ -4090,6 +4163,11 @@ async function getExamplesChoice(examples, frontends, backend) {
 		label: "AI Chat",
 		hint: "A simple AI chat interface using AI SDK"
 	});
+	if (isExampleChatSdkAllowed(backend, frontends ?? [], runtime)) options.push({
+		value: "chat-sdk",
+		label: "Chat SDK Bots",
+		hint: "Framework-specific Chat SDK bot example (Slack/Discord/GitHub depending on stack)"
+	});
 	if (options.length === 0) return [];
 	response = await navigableMultiselect({
 		message: "Include examples",
@@ -5625,7 +5703,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		},
 		examples: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve([]);
-			return getExamplesChoice(flags.examples, results.frontend, results.backend);
+			return getExamplesChoice(flags.examples, results.frontend, results.backend, results.runtime);
 		},
 		dbSetup: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve("none");
@@ -5641,6 +5719,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		},
 		ai: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve("none");
+			if (flags.ai === void 0 && results.examples?.includes("chat-sdk") && requiresChatSdkVercelAI(results.backend, results.frontend, results.runtime)) return Promise.resolve("vercel-ai");
 			return getAIChoice(flags.ai);
 		},
 		validation: ({ results }) => {
@@ -6514,7 +6593,7 @@ function validateDatabaseOrmAuth(cfg, flags) {
 		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
 	});
 	if (has("database") && has("orm") && db === "mongodb" && orm && orm !== "mongoose" && orm !== "prisma" && orm !== "none") incompatibilityError({
-		message: "MongoDB only works with Mongoose or Prisma ORM.",
+		message: "In Better-Fullstack, MongoDB is currently supported only with Mongoose or Prisma ORM.",
 		provided: {
 			database: "mongodb",
 			orm
@@ -6597,7 +6676,7 @@ function validateDatabaseSetup(config, providedFlags) {
 			runtime: "workers",
 			errorMessage: "Cloudflare D1 setup requires SQLite database and Cloudflare Workers runtime."
 		},
-		docker: { errorMessage: "Docker setup is not compatible with SQLite database or Cloudflare Workers runtime." },
+		docker: { errorMessage: "In Better-Fullstack, Docker setup is currently not available with SQLite database or Cloudflare Workers runtime." },
 		none: { errorMessage: "" }
 	};
 	if (dbSetup && dbSetup !== "none") {
@@ -6607,8 +6686,8 @@ function validateDatabaseSetup(config, providedFlags) {
 		} 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.");
-			if (runtime === "workers") exitWithError("Docker setup is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
+			if (database === "sqlite") exitWithError("In Better-Fullstack, Docker setup is currently not available 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.");
+			if (runtime === "workers") exitWithError("In Better-Fullstack, Docker setup is currently not available with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
 		}
 	}
 }
@@ -6727,15 +6806,6 @@ function validateAdonisJSConstraints(config, providedFlags) {
 }
 function validateBackendConstraints(config, providedFlags, options) {
 	const { backend } = config;
-	if (config.auth === "clerk" && backend !== "convex") exitWithError("Clerk authentication is only supported with the Convex backend. Please use '--backend convex' or choose a different auth provider.");
-	if (backend === "convex" && config.auth === "clerk" && config.frontend) {
-		const incompatibleFrontends = config.frontend.filter((f) => [
-			"nuxt",
-			"svelte",
-			"solid"
-		].includes(f));
-		if (incompatibleFrontends.length > 0) exitWithError(`Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
-	}
 	if (providedFlags.has("backend") && backend && backend !== "convex" && backend !== "none" && backend !== "self" && backend !== "encore") {
 		if (providedFlags.has("runtime") && options.runtime === "none") exitWithError("'--runtime none' is only supported with '--backend convex', '--backend none', '--backend self', or '--backend encore'. Please choose 'bun', 'node', or remove the --runtime flag.");
 	}
@@ -6774,8 +6844,9 @@ function validateFullConfig(config, providedFlags, options) {
 		validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
 		config.addons = [...new Set(config.addons)];
 	}
-	validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? []);
+	validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? [], config.runtime, config.ai);
 	validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend ?? []);
+	validateClerkCompatibility(config.auth, config.backend, config.frontend ?? []);
 	validateNextAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 	validateStackAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 	validateSupabaseAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
@@ -6790,12 +6861,13 @@ function validateConfigForProgrammaticUse(config) {
 		if (config.frontend && config.frontend.length > 0) ensureSingleWebAndNative(config.frontend);
 		validateApiFrontendCompatibility(config.api, config.frontend, config.astroIntegration);
 		validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend);
+		validateClerkCompatibility(config.auth, config.backend, config.frontend ?? []);
 		validateNextAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 		validateStackAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 		validateSupabaseAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 		validateAuth0Compatibility(config.auth, config.backend, config.frontend ?? []);
 		if (config.addons && config.addons.length > 0) validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-		validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? []);
+		validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? [], config.runtime, config.ai);
 		validateUILibraryFrontendCompatibility(config.uiLibrary, config.frontend ?? [], config.astroIntegration);
 		validateUILibraryCSSFrameworkCompatibility(config.uiLibrary, config.cssFramework);
 		validatePeerDependencies(config);
@@ -8117,7 +8189,7 @@ async function displayPostInstallInstructions(config) {
 	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() : "";
+	const clerkInstructions = config.auth === "clerk" ? getClerkInstructions(config.backend, config.frontend ?? []) : "";
 	const polarInstructions = config.payments === "polar" && config.auth === "better-auth" ? getPolarInstructions(backend) : "";
 	const alchemyDeployInstructions = getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy, backend);
 	const hasWeb = frontend?.some((f) => WEB_FRAMEWORKS.includes(f));
@@ -8248,8 +8320,13 @@ function getNoOrmWarning() {
 function getBunWebNativeWarning() {
 	return `\n${pc.yellow("WARNING:")} 'bun' might cause issues with web + native apps in a monorepo.\n   Use 'pnpm' if problems arise.`;
 }
-function getClerkInstructions() {
-	return `${pc.bold("Clerk Authentication Setup:")}\n${pc.cyan("•")} Follow the guide: ${pc.underline("https://docs.convex.dev/auth/clerk")}\n${pc.cyan("•")} Set CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard\n${pc.cyan("•")} Set CLERK_PUBLISHABLE_KEY in apps/*/.env`;
+function getClerkInstructions(backend, frontend) {
+	if (backend === "convex") return `${pc.bold("Clerk Authentication Setup:")}\n${pc.cyan("•")} Follow the guide: ${pc.underline("https://docs.convex.dev/auth/clerk")}\n${pc.cyan("•")} Set CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard\n${pc.cyan("•")} Set CLERK_PUBLISHABLE_KEY in apps/*/.env`;
+	if (backend === "self" && (frontend.includes("next") || frontend.includes("tanstack-start"))) {
+		const publishableKeyVar = frontend.includes("next") ? "NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY" : "VITE_CLERK_PUBLISHABLE_KEY";
+		return `${pc.bold("Clerk Authentication Setup:")}\n${pc.cyan("•")} Create an application in ${pc.underline("https://dashboard.clerk.com/")}\n${pc.cyan("•")} Set ${publishableKeyVar} in ${pc.white("apps/web/.env")}\n${pc.cyan("•")} Set CLERK_SECRET_KEY in ${pc.white("apps/web/.env")}\n${pc.cyan("•")} Clerk middleware and a protected dashboard route are already generated`;
+	}
+	return "";
 }
 function getBetterAuthConvexInstructions(hasWeb, webPort, packageManager) {
 	const cmd = packageManager === "npm" ? "npx" : packageManager;
@@ -8437,7 +8514,7 @@ async function setPackageManagerVersion(projectDir, packageManager) {
 	const pkgJsonPath = path.join(projectDir, "package.json");
 	if (!await fs.pathExists(pkgJsonPath)) return;
 	try {
-		const { stdout } = await $`${packageManager} -v`;
+		const { stdout } = await $({ cwd: os$1.tmpdir() })`${packageManager} -v`;
 		const version = stdout.trim();
 		const pkgJson = await fs.readJson(pkgJsonPath);
 		pkgJson.packageManager = `${packageManager}@${version}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-fullstack",
-  "version": "1.3.17",
+  "version": "1.4.0",
   "description": "A CLI-first toolkit for building Full Stack applications. Skip the configuration. Ship the code.",
   "keywords": [
     "better-auth",
@@ -76,8 +76,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.3.17",
-    "@better-fullstack/types": "^1.3.17",
+    "@better-fullstack/template-generator": "^1.4.0",
+    "@better-fullstack/types": "^1.4.0",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.0.0-alpha.8",
     "@orpc/server": "^1.13.0",