create-better-t-stack 2.37.0-canary.28c5b8e0 → 2.37.0-canary.6846bd90

package/dist/cli.js

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

package/dist/index.js

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

package/dist/{src-CzVr9ZoP.js → src-ByxWjVSi.js}

@@ -504,7 +504,6 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 }
 function coerceBackendPresets(config) {
 	if (config.backend === "convex") {
-		if (config.auth !== "clerk") config.auth = "none";
 		config.database = "none";
 		config.orm = "none";
 		config.api = "none";
@@ -552,8 +551,16 @@ function validateApiFrontendCompatibility(api, frontends = []) {
 	const includesSolid = frontends.includes("solid");
 	if ((includesNuxt || includesSvelte || includesSolid) && api === "trpc") exitWithError(`tRPC API is not supported with '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : "solid"}' frontend. Please use --api orpc or --api none or remove '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : "solid"}' from --frontend.`);
 }
-function isFrontendAllowedWithBackend(frontend, backend) {
+function isFrontendAllowedWithBackend(frontend, backend, auth) {
 	if (backend === "convex" && frontend === "solid") return false;
+	if (auth === "clerk" && backend === "convex") {
+		const incompatibleFrontends = [
+			"nuxt",
+			"svelte",
+			"solid"
+		];
+		if (incompatibleFrontends.includes(frontend)) return false;
+	}
 	return true;
 }
 function allowedApisForFrontends(frontends = []) {
@@ -639,14 +646,21 @@ async function getApiChoice(Api, frontend, backend) {
 
 //#endregion
 //#region src/prompts/auth.ts
-async function getAuthChoice(auth, hasDatabase, backend) {
+async function getAuthChoice(auth, hasDatabase, backend, frontend) {
 	if (auth !== void 0) return auth;
 	if (backend === "convex") {
+		const unsupportedFrontends = frontend?.filter((f) => [
+			"nuxt",
+			"svelte",
+			"solid"
+		].includes(f));
+		if (unsupportedFrontends && unsupportedFrontends.length > 0) return "none";
 		const response$1 = await select({
 			message: "Select authentication provider",
 			options: [{
 				value: "clerk",
-				label: "Clerk"
+				label: "Clerk",
+				hint: "More than auth, Complete User Management"
 			}, {
 				value: "none",
 				label: "None"
@@ -661,7 +675,8 @@ async function getAuthChoice(auth, hasDatabase, backend) {
 		message: "Select authentication provider",
 		options: [{
 			value: "better-auth",
-			label: "Better-Auth"
+			label: "Better-Auth",
+			hint: "comprehensive auth framework for TypeScript"
 		}, {
 			value: "none",
 			label: "None"
@@ -887,7 +902,7 @@ async function getExamplesChoice(examples, database, frontends, backend, api) {
 
 //#endregion
 //#region src/prompts/frontend.ts
-async function getFrontendChoice(frontendOptions, backend) {
+async function getFrontendChoice(frontendOptions, backend, auth) {
 	if (frontendOptions !== void 0) return frontendOptions;
 	const frontendTypes = await multiselect({
 		message: "Select project type",
@@ -943,7 +958,7 @@ async function getFrontendChoice(frontendOptions, backend) {
 				hint: "SSR, Server Functions, API Routes and more with TanStack Router"
 			}
 		];
-		const webOptions = allWebOptions.filter((option) => isFrontendAllowedWithBackend(option.value, backend));
+		const webOptions = allWebOptions.filter((option) => isFrontendAllowedWithBackend(option.value, backend, auth));
 		const webFramework = await select({
 			message: "Choose web",
 			options: webOptions,
@@ -1244,13 +1259,13 @@ async function getDeploymentToAdd(frontend, existingDeployment) {
 //#region src/prompts/config-prompts.ts
 async function gatherConfig(flags, projectName, projectDir, relativePath) {
 	const result = await group({
-		frontend: () => getFrontendChoice(flags.frontend, flags.backend),
+		frontend: () => getFrontendChoice(flags.frontend, flags.backend, flags.auth),
 		backend: ({ results }) => getBackendFrameworkChoice(flags.backend, results.frontend),
 		runtime: ({ results }) => getRuntimeChoice(flags.runtime, results.backend),
 		database: ({ results }) => getDatabaseChoice(flags.database, results.backend, results.runtime),
 		orm: ({ results }) => getORMChoice(flags.orm, results.database !== "none", results.database, results.backend, results.runtime),
 		api: ({ results }) => getApiChoice(flags.api, results.frontend, results.backend),
-		auth: ({ results }) => getAuthChoice(flags.auth, results.database !== "none", results.backend),
+		auth: ({ results }) => getAuthChoice(flags.auth, results.database !== "none", results.backend, results.frontend),
 		addons: ({ results }) => getAddonsChoice(flags.addons, results.frontend),
 		examples: ({ results }) => getExamplesChoice(flags.examples, results.database, results.frontend, results.backend, results.api),
 		dbSetup: ({ results }) => getDBSetupChoice(results.database ?? "none", flags.dbSetup, results.orm, results.backend, results.runtime),
@@ -1724,6 +1739,15 @@ function validateDatabaseSetup(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 (backend === "convex" && config.auth === "better-auth" && providedFlags.has("auth")) exitWithError("Better-Auth is not compatible with the Convex backend. Please use '--auth clerk' or '--auth none'.");
 	if (providedFlags.has("backend") && backend && backend !== "convex" && backend !== "none") {
 		if (providedFlags.has("runtime") && options.runtime === "none") exitWithError("'--runtime none' is only supported with '--backend convex' or '--backend none'. Please choose 'bun', 'node', or remove the --runtime flag.");
 	}
@@ -2962,7 +2986,7 @@ async function addAddonsToProject(input) {
 			frontend: detectedConfig.frontend || [],
 			addons: input.addons,
 			examples: detectedConfig.examples || [],
-			auth: detectedConfig.auth || false,
+			auth: detectedConfig.auth || "none",
 			git: false,
 			packageManager: input.packageManager || detectedConfig.packageManager || "npm",
 			install: input.install || false,
@@ -3734,7 +3758,7 @@ async function addDeploymentToProject(input) {
 			frontend: detectedConfig.frontend || [],
 			addons: detectedConfig.addons || [],
 			examples: detectedConfig.examples || [],
-			auth: detectedConfig.auth || false,
+			auth: detectedConfig.auth || "none",
 			git: false,
 			packageManager: input.packageManager || detectedConfig.packageManager || "npm",
 			install: input.install || false,
@@ -5349,7 +5373,7 @@ This project uses Convex as a backend. You'll need to set up Convex before runni
 ${packageManagerRunCmd} dev:setup
 \`\`\`
 
-Follow the prompts to create a new Convex project and connect it to your application.` : generateDatabaseSetup(database, auth, packageManagerRunCmd, orm, options.dbSetup, options.serverDeploy)}
+Follow the prompts to create a new Convex project and connect it to your application.${auth === "clerk" ? " See [Convex + Clerk guide](https://docs.convex.dev/auth/clerk) for auth setup." : ""}` : generateDatabaseSetup(database, auth, packageManagerRunCmd, orm, options.dbSetup, options.serverDeploy)}
 
 Then, run the development server:
 
@@ -5366,7 +5390,7 @@ ${generateDeploymentCommands(packageManagerRunCmd, webDeploy, serverDeploy)}
 ## Project Structure
 
 \`\`\`
-${generateProjectStructure(projectName, frontend, backend, addons, isConvex, api)}
+${generateProjectStructure(projectName, frontend, backend, addons, isConvex, api, auth)}
 \`\`\`
 
 ## Available Scripts
@@ -5416,7 +5440,7 @@ function generateRunningInstructions(frontend, backend, webPort, hasNative, isCo
 	else if (!isBackendNone) instructions.push("The API is running at [http://localhost:3000](http://localhost:3000).");
 	return instructions.join("\n");
 }
-function generateProjectStructure(projectName, frontend, backend, addons, isConvex, api) {
+function generateProjectStructure(projectName, frontend, backend, addons, isConvex, api, auth) {
 	const structure = [`${projectName}/`, "├── apps/"];
 	const hasFrontendNone = frontend.length === 0 || frontend.includes("none");
 	const isBackendNone = backend === "none";
@@ -5446,6 +5470,7 @@ function generateProjectStructure(projectName, frontend, backend, addons, isConv
 	if (isConvex) {
 		structure.push("├── packages/");
 		structure.push("│   └── backend/     # Convex backend functions and schema");
+		if (auth === "clerk") structure.push("│       ├── convex/    # Convex functions and schema", "│       └── .env.local # Convex environment variables");
 	} else if (!isBackendNone) {
 		const backendName = backend[0].toUpperCase() + backend.slice(1);
 		const apiName = api !== "none" ? api.toUpperCase() : "";
@@ -5497,7 +5522,7 @@ function generateFeaturesList(database, auth, addons, orm, runtime, frontend, ba
 		const dbName = database === "sqlite" ? "SQLite/Turso" : database === "postgres" ? "PostgreSQL" : database === "mysql" ? "MySQL" : database === "mongodb" ? "MongoDB" : "Database";
 		addonsList.push(`- **${ormName}** - TypeScript-first ORM`, `- **${dbName}** - Database engine`);
 	}
-	if (auth !== "none" && !isConvex) {
+	if (auth !== "none") {
 		const authLabel = auth === "clerk" ? "Clerk" : "Better-Auth";
 		addonsList.push(`- **Authentication** - ${authLabel}`);
 	}
@@ -5691,6 +5716,7 @@ async function displayPostInstallInstructions(config) {
 	const nativeInstructions = frontend?.includes("native-nativewind") || frontend?.includes("native-unistyles") ? getNativeInstructions(isConvex) : "";
 	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 wranglerDeployInstructions = getWranglerDeployInstructions(runCmd, webDeploy, serverDeploy);
 	const alchemyDeployInstructions = getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy);
 	const hasWeb = frontend?.some((f) => [
@@ -5714,6 +5740,12 @@ async function displayPostInstallInstructions(config) {
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
 	if (isConvex) {
 		output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev:setup\n${pc.dim("   (this will guide you through Convex project setup)")}\n`;
+		if (config.auth === "clerk") {
+			output += `${pc.cyan(`${stepCounter++}.`)} ${pc.bold("Clerk Setup:")}\n${pc.dim("   Follow the Convex + Clerk guide to configure authentication:")}\n${pc.cyan("   ")}${pc.underline("https://docs.convex.dev/auth/clerk")}\n\n`;
+			output += `${pc.cyan(`${stepCounter++}.`)} ${pc.bold("Required Environment Variables:")}\n`;
+			output += `${pc.dim("   •")} Set CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard\n`;
+			output += `${pc.dim("   •")} Set CLERK_PUBLISHABLE_KEY in apps/*/.env\n`;
+		}
 		output += `${pc.cyan(`${stepCounter++}.`)} Copy environment variables from\n${pc.white("   packages/backend/.env.local")} to ${pc.white("apps/*/.env")}\n`;
 		output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n\n`;
 	} else {
@@ -5738,6 +5770,7 @@ async function displayPostInstallInstructions(config) {
 	if (wranglerDeployInstructions) output += `\n${wranglerDeployInstructions.trim()}\n`;
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
 	if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
+	if (clerkInstructions) output += `\n${clerkInstructions.trim()}\n`;
 	if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
 	if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
 	output += `\n${pc.bold("Update all dependencies:\n")}${pc.cyan(tazeCommand)}\n\n`;
@@ -5813,6 +5846,9 @@ function getWranglerDeployInstructions(runCmd, webDeploy, serverDeploy) {
 	if (serverDeploy === "wrangler") instructions.push(`${pc.bold("Deploy server to Cloudflare Workers:")}\n${pc.cyan("•")} Deploy: ${`cd apps/server && ${runCmd} run deploy`}`);
 	return instructions.length ? `\n${instructions.join("\n")}` : "";
 }
+function getClerkInstructions() {
+	return `${pc.bold("Clerk Authentication Setup:")}\n${pc.cyan("1.")} Sign up for Clerk at ${pc.underline("https://clerk.com/sign-up")}\n${pc.cyan("2.")} Create a new application in Clerk Dashboard\n${pc.cyan("3.")} Create a JWT template named ${pc.bold("'convex'")} (exact name required)\n${pc.cyan("4.")} Copy your Clerk Frontend API URL (Issuer URL)\n${pc.cyan("5.")} Set environment variables:\n${pc.dim("   •")} CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard\n${pc.dim("   •")} CLERK_PUBLISHABLE_KEY in apps/*/.env\n${pc.cyan("6.")} Follow the complete guide: ${pc.underline("https://docs.convex.dev/auth/clerk")}\n${pc.yellow("NOTE:")} Use Convex's <Authenticated> components instead of Clerk's <SignedIn>`;
+}
 function getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy) {
 	const instructions = [];
 	if (webDeploy === "alchemy" && serverDeploy !== "alchemy") instructions.push(`${pc.bold("Deploy web with Alchemy:")}\n${pc.cyan("•")} Dev: ${`cd apps/web && ${runCmd} dev`}\n${pc.cyan("•")} Deploy: ${`cd apps/web && ${runCmd} deploy`}\n${pc.cyan("•")} Destroy: ${`cd apps/web && ${runCmd} destroy`}`);
@@ -6142,7 +6178,7 @@ async function createProjectHandler(input) {
 		};
 		coerceBackendPresets(config);
 		validateConfigCompatibility(config, providedFlags, cliInput);
-		if (config.backend === "convex") log.info("Due to '--backend convex' flag, the following options have been automatically set: auth=none, database=none, orm=none, api=none, runtime=none, dbSetup=none, examples=todo");
+		if (config.backend === "convex") log.info(`Due to '--backend convex' flag, the following options have been automatically set: database=none, orm=none, api=none, runtime=none, dbSetup=none, examples=todo`);
 		else if (config.backend === "none") log.info("Due to '--backend none', the following options have been automatically set: --auth none, --database=none, --orm=none, --api=none, --runtime=none, --db-setup=none, --examples=none");
 		log.info(pc.yellow("Using default/flag options (config prompts skipped):"));
 		log.message(displayConfig(config));

package/package.json

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