create-better-t-stack 3.25.5 → 3.26.0

package/README.md

@@ -32,14 +32,14 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | Category                 | Options                                                                                                                                                                                                                                                                                                                                                      |
 | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | **TypeScript**           | End-to-end type safety across all parts of your application                                                                                                                                                                                                                                                                                                  |
-| **Frontend**             | • React with TanStack Router<br>• React with React Router<br>• React with TanStack Start (SSR)<br>• Next.js<br>• SvelteKit<br>• Nuxt (Vue)<br>• SolidJS<br>• React Native with NativeWind (via Expo)<br>• React Native with Unistyles (via Expo)<br>• None                                                                                                   |
-| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Next.js API routes<br>• Convex<br>• Fastify<br>• None                                                                                                                                                                                                                                                                   |
+| **Frontend**             | • React with TanStack Router<br>• React with React Router<br>• React with TanStack Start (SSR)<br>• Next.js<br>• SvelteKit<br>• Nuxt (Vue)<br>• SolidJS<br>• Astro<br>• React Native bare Expo<br>• React Native with NativeWind (via Expo)<br>• React Native with Unistyles (via Expo)<br>• None                                                            |
+| **Backend**              | • Hono<br>• Express<br>• Elysia<br>• Fastify<br>• Self (fullstack inside the web app)<br>• Convex<br>• None                                                                                                                                                                                                                                                  |
 | **API Layer**            | • tRPC (type-safe APIs)<br>• oRPC (OpenAPI-compatible type-safe APIs)<br>• None                                                                                                                                                                                                                                                                              |
 | **Runtime**              | • Bun<br>• Node.js<br>• Cloudflare Workers<br>• None                                                                                                                                                                                                                                                                                                         |
 | **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• None                                                                                                                                                                                                                                                                                                   |
 | **ORM**                  | • Drizzle (TypeScript-first)<br>• Prisma (feature-rich)<br>• Mongoose (for MongoDB)<br>• None                                                                                                                                                                                                                                                                |
 | **Database Setup**       | • Turso (SQLite)<br>• Cloudflare D1 (SQLite)<br>• Neon (PostgreSQL)<br>• Supabase (PostgreSQL)<br>• Prisma Postgres<br>• MongoDB Atlas<br>• None (manual setup)                                                                                                                                                                                              |
-| **Authentication**       | Better-Auth (email/password, with more options coming soon)                                                                                                                                                                                                                                                                                                  |
+| **Authentication**       | • Better Auth<br>• Clerk                                                                                                                                                                                                                                                                                                                                     |
 | **Styling**              | Tailwind CSS with a shared shadcn/ui package for React web apps                                                                                                                                                                                                                                                                                              |
 | **Addons**               | • PWA support<br>• Tauri (desktop applications)<br>• Electrobun (lightweight desktop shell)<br>• Starlight and Fumadocs (documentation sites)<br>• Biome, Oxlint, Ultracite (linting and formatting)<br>• Lefthook, Husky (Git hooks)<br>• MCP, Skills (agent tooling)<br>• OpenTUI, WXT (platform extensions)<br>• Turborepo or Nx (monorepo orchestration) |
 | **Examples**             | • Todo app<br>• AI Chat interface (using Vercel AI SDK)                                                                                                                                                                                                                                                                                                      |

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { _ as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as getLatestCLIVersion } from "./src-p8a66ui5.mjs";
+import { _ as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as getLatestCLIVersion } from "./src-BVuxTUEs.mjs";
 import z from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/index.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { C as ProjectCreationError, S as DirectoryConflictError, T as ValidationError, a as TEMPLATE_COUNT, b as CompatibilityError, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as UserCancelledError, x as DatabaseSetupError, y as CLIError } from "./src-p8a66ui5.mjs";
+import { C as ProjectCreationError, S as DirectoryConflictError, T as ValidationError, a as TEMPLATE_COUNT, b as CompatibilityError, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as UserCancelledError, x as DatabaseSetupError, y as CLIError } from "./src-BVuxTUEs.mjs";
 export { CLIError, CompatibilityError, DatabaseSetupError, DirectoryConflictError, EMBEDDED_TEMPLATES, GeneratorError, ProjectCreationError, Result, SchemaNameSchema, TEMPLATE_COUNT, UserCancelledError, ValidationError, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generate, getSchemaResult, router, sponsors };

package/dist/{src-p8a66ui5.mjs → src-BVuxTUEs.mjs}

@@ -782,7 +782,7 @@ function validateApiFrontendCompatibility(api, frontends = []) {
 }
 function isFrontendAllowedWithBackend(frontend, backend, auth) {
 	if (backend === "convex" && (frontend === "solid" || frontend === "astro")) return false;
-	if (auth === "clerk" && backend === "convex") {
+	if (auth === "clerk") {
 		if ([
 			"nuxt",
 			"svelte",
@@ -3218,60 +3218,53 @@ async function getApiChoice(Api, frontend, backend) {
 async function getAuthChoice(auth, backend, frontend) {
 	if (auth !== void 0) return auth;
 	if (backend === "none") return "none";
+	const supportedBetterAuthFrontends = frontend?.some((f) => [
+		"tanstack-router",
+		"tanstack-start",
+		"next",
+		"nuxt",
+		"svelte",
+		"solid",
+		"native-bare",
+		"native-uniwind",
+		"native-unistyles"
+	].includes(f));
+	const hasClerkCompatibleFrontends = frontend?.some((f) => [
+		"react-router",
+		"tanstack-router",
+		"tanstack-start",
+		"next",
+		"native-bare",
+		"native-uniwind",
+		"native-unistyles"
+	].includes(f));
+	const options = [];
 	if (backend === "convex") {
-		const supportedBetterAuthFrontends = frontend?.some((f) => [
-			"tanstack-router",
-			"tanstack-start",
-			"next",
-			"native-bare",
-			"native-uniwind",
-			"native-unistyles"
-		].includes(f));
-		const hasClerkCompatibleFrontends = frontend?.some((f) => [
-			"react-router",
-			"tanstack-router",
-			"tanstack-start",
-			"next",
-			"native-bare",
-			"native-uniwind",
-			"native-unistyles"
-		].includes(f));
-		const options = [];
 		if (supportedBetterAuthFrontends) options.push({
 			value: "better-auth",
 			label: "Better-Auth",
 			hint: "comprehensive auth framework for TypeScript"
 		});
-		if (hasClerkCompatibleFrontends) options.push({
-			value: "clerk",
-			label: "Clerk",
-			hint: "More than auth, Complete User Management"
-		});
-		if (options.length === 0) return "none";
-		options.push({
-			value: "none",
-			label: "None",
-			hint: "No auth"
-		});
-		const response = await navigableSelect({
-			message: "Select authentication provider",
-			options,
-			initialValue: "none"
-		});
-		if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
-		return response;
-	}
+	} else options.push({
+		value: "better-auth",
+		label: "Better-Auth",
+		hint: "comprehensive auth framework for TypeScript"
+	});
+	if (hasClerkCompatibleFrontends) options.push({
+		value: "clerk",
+		label: "Clerk",
+		hint: "More than auth, Complete User Management"
+	});
+	if (options.length === 0) return "none";
+	options.push({
+		value: "none",
+		label: "None",
+		hint: "No auth"
+	});
 	const response = await navigableSelect({
 		message: "Select authentication provider",
-		options: [{
-			value: "better-auth",
-			label: "Better-Auth",
-			hint: "comprehensive auth framework for TypeScript"
-		}, {
-			value: "none",
-			label: "None"
-		}],
-		initialValue: DEFAULT_CONFIG.auth
+		options,
+		initialValue: options.some((option) => option.value === DEFAULT_CONFIG.auth) ? DEFAULT_CONFIG.auth : "none"
 	});
 	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
@@ -4398,12 +4391,12 @@ function validateSelfBackendConstraints(config, providedFlags) {
 }
 function validateBackendConstraints(config, providedFlags, options) {
 	const { backend } = config;
-	if (config.auth === "clerk" && backend !== "convex") return validationErr("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) {
+	if (config.auth === "clerk" && config.frontend) {
 		const incompatibleFrontends = config.frontend.filter((f) => [
 			"nuxt",
 			"svelte",
-			"solid"
+			"solid",
+			"astro"
 		].includes(f));
 		if (incompatibleFrontends.length > 0) return validationErr(`Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
 	}
@@ -5999,7 +5992,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(frontend || [], backend, api) : "";
 	const polarInstructions = config.payments === "polar" && config.auth === "better-auth" ? getPolarInstructions(backend) : "";
 	const alchemyDeployInstructions = getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy, backend);
 	const hasWeb = frontend?.some((f) => types_exports.desktopWebFrontends.includes(f));
@@ -6140,8 +6133,64 @@ 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 getClerkQuickstartUrl(frontend) {
+	if (frontend.includes("next")) return "https://clerk.com/docs/nextjs/getting-started/quickstart";
+	if (frontend.includes("react-router")) return "https://clerk.com/docs/react-router/getting-started/quickstart";
+	if (frontend.includes("tanstack-start")) return "https://clerk.com/docs/tanstack-react-start/getting-started/quickstart";
+	if (frontend.includes("tanstack-router")) return "https://clerk.com/docs/react/getting-started/quickstart";
+	if (frontend.includes("native-bare") || frontend.includes("native-uniwind") || frontend.includes("native-unistyles")) return "https://clerk.com/docs/expo/getting-started/quickstart";
+	return "https://clerk.com/docs";
+}
+function getClerkInstructionLines(frontend, backend, api) {
+	const lines = [];
+	if (frontend.includes("next")) lines.push("Set NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY in apps/web/.env");
+	if (frontend.some((value) => [
+		"react-router",
+		"tanstack-router",
+		"tanstack-start"
+	].includes(value))) lines.push("Set VITE_CLERK_PUBLISHABLE_KEY in apps/web/.env");
+	if (frontend.some((value) => [
+		"native-bare",
+		"native-uniwind",
+		"native-unistyles"
+	].includes(value))) lines.push("Set EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY in apps/native/.env");
+	if (backend === "convex") return [
+		"Set CLERK_JWT_ISSUER_DOMAIN in Convex Dashboard",
+		...lines,
+		...frontend.some((value) => [
+			"next",
+			"react-router",
+			"tanstack-start"
+		].includes(value)) ? ["Set CLERK_SECRET_KEY in apps/web/.env for Clerk server middleware"] : []
+	];
+	const hasClerkServerFrontend = frontend.some((value) => [
+		"next",
+		"react-router",
+		"tanstack-start"
+	].includes(value));
+	const serverEnvPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
+	const needsServerSideClerkAuth = backend !== "none";
+	const needsClerkBackendPublishableKey = ["express", "fastify"].includes(backend);
+	const needsClerkRequestVerification = api !== "none" && [
+		"self",
+		"hono",
+		"elysia"
+	].includes(backend);
+	if (hasClerkServerFrontend && backend === "self") lines.push("Set CLERK_SECRET_KEY in apps/web/.env for Clerk server middleware and server-side Clerk auth");
+	else {
+		if (hasClerkServerFrontend) lines.push("Set CLERK_SECRET_KEY in apps/web/.env for Clerk server middleware");
+		if (needsServerSideClerkAuth) lines.push(`Set CLERK_SECRET_KEY in ${serverEnvPath} for server-side Clerk auth`);
+	}
+	if (needsClerkRequestVerification) lines.push(`Set CLERK_PUBLISHABLE_KEY in ${serverEnvPath} for server-side Clerk request verification`);
+	if (needsClerkBackendPublishableKey) lines.push(`Set CLERK_PUBLISHABLE_KEY in ${serverEnvPath} for Clerk backend middleware`);
+	return lines;
+}
+function getClerkInstructions(frontend, backend, api) {
+	return [
+		`${pc.bold("Clerk Authentication Setup:")}`,
+		`${pc.cyan("•")} Follow the guide: ${pc.underline(getClerkQuickstartUrl(frontend))}`,
+		...getClerkInstructionLines(frontend, backend, api).map((line) => `${pc.cyan("•")} ${line}`)
+	].join("\n");
 }
 function getBetterAuthConvexInstructions(hasWeb, webPort, packageManager) {
 	const cmd = packageManager === "npm" ? "npx" : packageManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.25.5",
+  "version": "3.26.0",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "keywords": [
     "better-auth",
@@ -70,8 +70,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-t-stack/template-generator": "^3.25.5",
-    "@better-t-stack/types": "^3.25.5",
+    "@better-t-stack/template-generator": "^3.26.0",
+    "@better-t-stack/types": "^3.26.0",
     "@clack/core": "^1.1.0",
     "@clack/prompts": "^1.1.0",
     "@modelcontextprotocol/sdk": "1.27.1",