create-better-t-stack 2.45.5 → 2.46.0

package/dist/{src-Cun9EO6e.js → src-NOw0j6Z9.js}

@@ -36,6 +36,7 @@ const DEFAULT_CONFIG_BASE = {
 	database: "sqlite",
 	orm: "drizzle",
 	auth: "better-auth",
+	payments: "none",
 	addons: ["turborepo"],
 	examples: [],
 	git: true,
@@ -59,8 +60,8 @@ function getDefaultConfig() {
 }
 const DEFAULT_CONFIG = getDefaultConfig();
 const dependencyVersionMap = {
-	"better-auth": "^1.3.9",
-	"@better-auth/expo": "^1.3.9",
+	"better-auth": "^1.3.10",
+	"@better-auth/expo": "^1.3.10",
 	"@clerk/nextjs": "^6.31.5",
 	"@clerk/clerk-react": "^5.45.0",
 	"@clerk/tanstack-react-start": "^0.23.1",
@@ -131,9 +132,9 @@ const dependencyVersionMap = {
 	"@tanstack/vue-query": "^5.83.0",
 	"@tanstack/react-query-devtools": "^5.85.5",
 	"@tanstack/react-query": "^5.85.5",
-	"@tanstack/solid-query": "^5.75.0",
-	"@tanstack/solid-query-devtools": "^5.75.0",
-	"@tanstack/solid-router-devtools": "^1.131.25",
+	"@tanstack/solid-query": "^5.87.4",
+	"@tanstack/solid-query-devtools": "^5.87.4",
+	"@tanstack/solid-router-devtools": "^1.131.44",
 	wrangler: "^4.23.0",
 	"@cloudflare/vite-plugin": "^1.9.0",
 	"@opennextjs/cloudflare": "^1.6.5",
@@ -142,7 +143,9 @@ const dependencyVersionMap = {
 	"@cloudflare/workers-types": "^4.20250822.0",
 	alchemy: "^0.65.1",
 	nitropack: "^2.12.4",
-	dotenv: "^17.2.1"
+	dotenv: "^17.2.1",
+	"@polar-sh/better-auth": "^1.1.3",
+	"@polar-sh/sdk": "^0.34.16"
 };
 const ADDON_COMPATIBILITY = {
 	pwa: [
@@ -256,6 +259,7 @@ const AuthSchema = z.enum([
 	"clerk",
 	"none"
 ]).describe("Authentication provider");
+const PaymentsSchema = z.enum(["polar", "none"]).describe("Payments provider");
 const ProjectNameSchema = z.string().min(1, "Project name cannot be empty").max(255, "Project name must be less than 255 characters").refine((name) => name === "." || !name.startsWith("."), "Project name cannot start with a dot (except for '.')").refine((name) => name === "." || !name.startsWith("-"), "Project name cannot start with a dash").refine((name) => {
 	const invalidChars = [
 		"<",
@@ -286,28 +290,16 @@ const DirectoryConflictSchema = z.enum([
 ]).describe("How to handle existing directory conflicts");
 
 //#endregion
-//#region src/utils/addon-compatibility.ts
-function validateAddonCompatibility(addon, frontend) {
-	const compatibleFrontends = ADDON_COMPATIBILITY[addon];
-	if (compatibleFrontends.length === 0) return { isCompatible: true };
-	const hasCompatibleFrontend = frontend.some((f) => compatibleFrontends.includes(f));
-	if (!hasCompatibleFrontend) {
-		const frontendList = compatibleFrontends.join(", ");
-		return {
-			isCompatible: false,
-			reason: `${addon} addon requires one of these frontends: ${frontendList}`
-		};
-	}
-	return { isCompatible: true };
-}
-function getCompatibleAddons(allAddons, frontend, existingAddons = []) {
-	return allAddons.filter((addon) => {
-		if (existingAddons.includes(addon)) return false;
-		if (addon === "none") return false;
-		const { isCompatible } = validateAddonCompatibility(addon, frontend);
-		return isCompatible;
-	});
-}
+//#region src/utils/compatibility.ts
+const WEB_FRAMEWORKS = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid"
+];
 
 //#endregion
 //#region src/utils/errors.ts
@@ -331,6 +323,121 @@ function handleError(error, fallbackMessage) {
 	process.exit(1);
 }
 
+//#endregion
+//#region src/utils/compatibility-rules.ts
+function isWebFrontend(value) {
+	return WEB_FRAMEWORKS.includes(value);
+}
+function splitFrontends(values = []) {
+	const web = values.filter((f) => isWebFrontend(f));
+	const native = values.filter((f) => f === "native-nativewind" || f === "native-unistyles");
+	return {
+		web,
+		native
+	};
+}
+function ensureSingleWebAndNative(frontends) {
+	const { web, native } = splitFrontends(frontends);
+	if (web.length > 1) exitWithError("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid");
+	if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-nativewind, native-unistyles");
+}
+function validateWorkersCompatibility(providedFlags, options, config) {
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono backend (--backend hono). Current backend: ${config.backend}. Please use '--backend hono' or choose a different runtime.`);
+	if (providedFlags.has("backend") && config.backend && config.backend !== "hono" && config.runtime === "workers") exitWithError(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono backend. Please use '--backend hono' or choose a different runtime.`);
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with MongoDB database. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with Docker setup. 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 (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") exitWithError("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
+	if (providedFlags.has("dbSetup") && options.dbSetup === "docker" && config.runtime === "workers") exitWithError("Docker setup (--db-setup docker) 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.");
+}
+function validateApiFrontendCompatibility(api, frontends = []) {
+	const includesNuxt = frontends.includes("nuxt");
+	const includesSvelte = frontends.includes("svelte");
+	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, 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 = []) {
+	const includesNuxt = frontends.includes("nuxt");
+	const includesSvelte = frontends.includes("svelte");
+	const includesSolid = frontends.includes("solid");
+	const base = [
+		"trpc",
+		"orpc",
+		"none"
+	];
+	if (includesNuxt || includesSvelte || includesSolid) return ["orpc", "none"];
+	return base;
+}
+function isExampleTodoAllowed(backend, database) {
+	return !(backend !== "convex" && backend !== "none" && database === "none");
+}
+function isExampleAIAllowed(_backend, frontends = []) {
+	const includesSolid = frontends.includes("solid");
+	if (includesSolid) return false;
+	return true;
+}
+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'.");
+}
+function validateServerDeployRequiresBackend(serverDeploy, backend) {
+	if (serverDeploy && serverDeploy !== "none" && (!backend || backend === "none")) exitWithError("'--server-deploy' requires a backend. Please select a backend or set '--server-deploy none'.");
+}
+function validateAddonCompatibility(addon, frontend, _auth) {
+	const compatibleFrontends = ADDON_COMPATIBILITY[addon];
+	if (compatibleFrontends.length > 0) {
+		const hasCompatibleFrontend = frontend.some((f) => compatibleFrontends.includes(f));
+		if (!hasCompatibleFrontend) {
+			const frontendList = compatibleFrontends.join(", ");
+			return {
+				isCompatible: false,
+				reason: `${addon} addon requires one of these frontends: ${frontendList}`
+			};
+		}
+	}
+	return { isCompatible: true };
+}
+function getCompatibleAddons(allAddons, frontend, existingAddons = [], auth) {
+	return allAddons.filter((addon) => {
+		if (existingAddons.includes(addon)) return false;
+		if (addon === "none") return false;
+		const { isCompatible } = validateAddonCompatibility(addon, frontend, auth);
+		return isCompatible;
+	});
+}
+function validateAddonsAgainstFrontends(addons = [], frontends = [], auth) {
+	for (const addon of addons) {
+		if (addon === "none") continue;
+		const { isCompatible, reason } = validateAddonCompatibility(addon, frontends, auth);
+		if (!isCompatible) exitWithError(`Incompatible addon/frontend combination: ${reason}`);
+	}
+}
+function validatePaymentsCompatibility(payments, auth, backend, frontends = []) {
+	if (!payments || payments === "none") return;
+	if (payments === "polar") {
+		if (!auth || auth === "none" || auth !== "better-auth") exitWithError("Polar payments requires Better Auth. Please use '--auth better-auth' or choose a different payments provider.");
+		if (backend === "convex") exitWithError("Polar payments is not compatible with Convex backend. Please use a different backend or choose a different payments provider.");
+		const { web } = splitFrontends(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, 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") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
+}
+
 //#endregion
 //#region src/prompts/addons.ts
 function getAddonDisplay(addon) {
@@ -401,7 +508,7 @@ const ADDON_GROUPS = {
 		"husky"
 	]
 };
-async function getAddonsChoice(addons, frontends) {
+async function getAddonsChoice(addons, frontends, auth) {
 	if (addons !== void 0) return addons;
 	const allAddons = AddonsSchema.options.filter((addon) => addon !== "none");
 	const groupedOptions = {
@@ -411,7 +518,7 @@ async function getAddonsChoice(addons, frontends) {
 	};
 	const frontendsArray = frontends || [];
 	for (const addon of allAddons) {
-		const { isCompatible } = validateAddonCompatibility(addon, frontendsArray);
+		const { isCompatible } = validateAddonCompatibility(addon, frontendsArray, auth);
 		if (!isCompatible) continue;
 		const { label, hint } = getAddonDisplay(addon);
 		const option = {
@@ -437,14 +544,14 @@ async function getAddonsChoice(addons, frontends) {
 	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
-async function getAddonsToAdd(frontend, existingAddons = []) {
+async function getAddonsToAdd(frontend, existingAddons = [], auth) {
 	const groupedOptions = {
 		Documentation: [],
 		Linting: [],
 		Other: []
 	};
 	const frontendArray = frontend || [];
-	const compatibleAddons = getCompatibleAddons(AddonsSchema.options.filter((addon) => addon !== "none"), frontendArray, existingAddons);
+	const compatibleAddons = getCompatibleAddons(AddonsSchema.options.filter((addon) => addon !== "none"), frontendArray, existingAddons, auth);
 	for (const addon of compatibleAddons) {
 		const { label, hint } = getAddonDisplay(addon);
 		const option = {
@@ -470,102 +577,6 @@ async function getAddonsToAdd(frontend, existingAddons = []) {
 	return response;
 }
 
-//#endregion
-//#region src/utils/compatibility.ts
-const WEB_FRAMEWORKS = [
-	"tanstack-router",
-	"react-router",
-	"tanstack-start",
-	"next",
-	"nuxt",
-	"svelte",
-	"solid"
-];
-
-//#endregion
-//#region src/utils/compatibility-rules.ts
-function isWebFrontend(value) {
-	return WEB_FRAMEWORKS.includes(value);
-}
-function splitFrontends(values = []) {
-	const web = values.filter((f) => isWebFrontend(f));
-	const native = values.filter((f) => f === "native-nativewind" || f === "native-unistyles");
-	return {
-		web,
-		native
-	};
-}
-function ensureSingleWebAndNative(frontends) {
-	const { web, native } = splitFrontends(frontends);
-	if (web.length > 1) exitWithError("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid");
-	if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-nativewind, native-unistyles");
-}
-function validateWorkersCompatibility(providedFlags, options, config) {
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono backend (--backend hono). Current backend: ${config.backend}. Please use '--backend hono' or choose a different runtime.`);
-	if (providedFlags.has("backend") && config.backend && config.backend !== "hono" && config.runtime === "workers") exitWithError(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono backend. Please use '--backend hono' or choose a different runtime.`);
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with MongoDB database. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with Docker setup. 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 (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") exitWithError("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
-	if (providedFlags.has("dbSetup") && options.dbSetup === "docker" && config.runtime === "workers") exitWithError("Docker setup (--db-setup docker) 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.");
-}
-function validateApiFrontendCompatibility(api, frontends = []) {
-	const includesNuxt = frontends.includes("nuxt");
-	const includesSvelte = frontends.includes("svelte");
-	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, 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 = []) {
-	const includesNuxt = frontends.includes("nuxt");
-	const includesSvelte = frontends.includes("svelte");
-	const includesSolid = frontends.includes("solid");
-	const base = [
-		"trpc",
-		"orpc",
-		"none"
-	];
-	if (includesNuxt || includesSvelte || includesSolid) return ["orpc", "none"];
-	return base;
-}
-function isExampleTodoAllowed(backend, database) {
-	return !(backend !== "convex" && backend !== "none" && database === "none");
-}
-function isExampleAIAllowed(_backend, frontends = []) {
-	const includesSolid = frontends.includes("solid");
-	if (includesSolid) return false;
-	return true;
-}
-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'.");
-}
-function validateServerDeployRequiresBackend(serverDeploy, backend) {
-	if (serverDeploy && serverDeploy !== "none" && (!backend || backend === "none")) exitWithError("'--server-deploy' requires a backend. Please select a backend or set '--server-deploy none'.");
-}
-function validateAddonsAgainstFrontends(addons = [], frontends = []) {
-	for (const addon of addons) {
-		if (addon === "none") continue;
-		const { isCompatible, reason } = validateAddonCompatibility(addon, frontends);
-		if (!isCompatible) exitWithError(`Incompatible addon/frontend combination: ${reason}`);
-	}
-}
-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") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
-}
-
 //#endregion
 //#region src/prompts/api.ts
 async function getApiChoice(Api, frontend, backend) {
@@ -1037,6 +1048,30 @@ async function getPackageManagerChoice(packageManager) {
 	return response;
 }
 
+//#endregion
+//#region src/prompts/payments.ts
+async function getPaymentsChoice(payments, auth, backend, frontends) {
+	if (payments !== void 0) return payments;
+	const isPolarCompatible = auth === "better-auth" && backend !== "convex" && (frontends?.length === 0 || splitFrontends(frontends).web.length > 0);
+	if (!isPolarCompatible) return "none";
+	const options = [{
+		value: "polar",
+		label: "Polar",
+		hint: "Turn your software into a business. 6 lines of code."
+	}, {
+		value: "none",
+		label: "None",
+		hint: "No payments integration"
+	}];
+	const response = await select({
+		message: "Select payments provider",
+		options,
+		initialValue: DEFAULT_CONFIG.payments
+	});
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
+	return response;
+}
+
 //#endregion
 //#region src/prompts/runtime.ts
 async function getRuntimeChoice(runtime, backend) {
@@ -1226,7 +1261,8 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		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, results.frontend),
-		addons: ({ results }) => getAddonsChoice(flags.addons, results.frontend),
+		payments: ({ results }) => getPaymentsChoice(flags.payments, results.auth, results.backend, results.frontend),
+		addons: ({ results }) => getAddonsChoice(flags.addons, results.frontend, results.auth),
 		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),
 		webDeploy: ({ results }) => getDeploymentChoice(flags.webDeploy, results.runtime, results.backend, results.frontend),
@@ -1245,6 +1281,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		database: result.database,
 		orm: result.orm,
 		auth: result.auth,
+		payments: result.payments,
 		addons: result.addons,
 		examples: result.examples,
 		git: result.git,
@@ -1388,6 +1425,7 @@ function displayConfig(config) {
 	if (config.database !== void 0) configDisplay.push(`${pc.blue("Database:")} ${String(config.database)}`);
 	if (config.orm !== void 0) configDisplay.push(`${pc.blue("ORM:")} ${String(config.orm)}`);
 	if (config.auth !== void 0) configDisplay.push(`${pc.blue("Auth:")} ${String(config.auth)}`);
+	if (config.payments !== void 0) configDisplay.push(`${pc.blue("Payments:")} ${String(config.payments)}`);
 	if (config.addons !== void 0) {
 		const addons = Array.isArray(config.addons) ? config.addons : [config.addons];
 		const addonsText = addons.length > 0 && addons[0] !== void 0 ? addons.join(", ") : "none";
@@ -1426,6 +1464,7 @@ function generateReproducibleCommand(config) {
 	flags.push(`--orm ${config.orm}`);
 	flags.push(`--api ${config.api}`);
 	flags.push(`--auth ${config.auth}`);
+	flags.push(`--payments ${config.payments}`);
 	if (config.addons && config.addons.length > 0) flags.push(`--addons ${config.addons.join(" ")}`);
 	else flags.push("--addons none");
 	if (config.examples && config.examples.length > 0) flags.push(`--examples ${config.examples.join(" ")}`);
@@ -1595,6 +1634,7 @@ function processFlags(options, projectName) {
 	if (options.database) config.database = options.database;
 	if (options.orm) config.orm = options.orm;
 	if (options.auth !== void 0) config.auth = options.auth;
+	if (options.payments !== void 0) config.payments = options.payments;
 	if (options.git !== void 0) config.git = options.git;
 	if (options.install !== void 0) config.install = options.install;
 	if (options.runtime) config.runtime = options.runtime;
@@ -1751,7 +1791,7 @@ function validateFullConfig(config, providedFlags, options) {
 	validateWorkersCompatibility(providedFlags, options, config);
 	if (config.runtime === "workers" && config.serverDeploy === "none") exitWithError("Cloudflare Workers runtime requires a server deployment. Please choose 'wrangler' or 'alchemy' for --server-deploy.");
 	if (config.addons && config.addons.length > 0) {
-		validateAddonsAgainstFrontends(config.addons, config.frontend);
+		validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
 		config.addons = [...new Set(config.addons)];
 	}
 	validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? []);
@@ -1761,7 +1801,8 @@ function validateConfigForProgrammaticUse(config) {
 		validateDatabaseOrmAuth(config);
 		if (config.frontend && config.frontend.length > 0) ensureSingleWebAndNative(config.frontend);
 		validateApiFrontendCompatibility(config.api, config.frontend);
-		if (config.addons && config.addons.length > 0) validateAddonsAgainstFrontends(config.addons, config.frontend);
+		validatePaymentsCompatibility(config.payments, 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.database, config.frontend ?? []);
 	} catch (error) {
 		if (error instanceof Error) throw error;
@@ -1859,6 +1900,7 @@ async function writeBtsConfig(projectConfig) {
 		addons: projectConfig.addons,
 		examples: projectConfig.examples,
 		auth: projectConfig.auth,
+		payments: projectConfig.payments,
 		packageManager: projectConfig.packageManager,
 		dbSetup: projectConfig.dbSetup,
 		api: projectConfig.api,
@@ -2483,6 +2525,7 @@ async function detectProjectConfig(projectDir) {
 			addons: btsConfig.addons,
 			examples: btsConfig.examples,
 			auth: btsConfig.auth,
+			payments: btsConfig.payments,
 			packageManager: btsConfig.packageManager,
 			dbSetup: btsConfig.dbSetup,
 			api: btsConfig.api,
@@ -2863,6 +2906,49 @@ async function setupAuthTemplate(projectDir, context) {
 		}
 	}
 }
+async function setupPaymentsTemplate(projectDir, context) {
+	if (!context.payments || context.payments === "none") return;
+	const serverAppDir = path.join(projectDir, "apps/server");
+	const webAppDir = path.join(projectDir, "apps/web");
+	const serverAppDirExists = await fs.pathExists(serverAppDir);
+	const webAppDirExists = await fs.pathExists(webAppDir);
+	if (serverAppDirExists && context.backend !== "convex") {
+		const paymentsServerSrc = path.join(PKG_ROOT, `templates/payments/${context.payments}/server/base`);
+		if (await fs.pathExists(paymentsServerSrc)) await processAndCopyFiles("**/*", paymentsServerSrc, serverAppDir, context);
+	}
+	const hasReactWeb = context.frontend.some((f) => [
+		"tanstack-router",
+		"react-router",
+		"tanstack-start",
+		"next"
+	].includes(f));
+	const hasNuxtWeb = context.frontend.includes("nuxt");
+	const hasSvelteWeb = context.frontend.includes("svelte");
+	const hasSolidWeb = context.frontend.includes("solid");
+	if (webAppDirExists && (hasReactWeb || hasNuxtWeb || hasSvelteWeb || hasSolidWeb)) {
+		if (hasReactWeb) {
+			const reactFramework = context.frontend.find((f) => [
+				"tanstack-router",
+				"react-router",
+				"tanstack-start",
+				"next"
+			].includes(f));
+			if (reactFramework) {
+				const paymentsWebSrc = path.join(PKG_ROOT, `templates/payments/${context.payments}/web/react/${reactFramework}`);
+				if (await fs.pathExists(paymentsWebSrc)) await processAndCopyFiles("**/*", paymentsWebSrc, webAppDir, context);
+			}
+		} else if (hasNuxtWeb) {
+			const paymentsWebNuxtSrc = path.join(PKG_ROOT, `templates/payments/${context.payments}/web/nuxt`);
+			if (await fs.pathExists(paymentsWebNuxtSrc)) await processAndCopyFiles("**/*", paymentsWebNuxtSrc, webAppDir, context);
+		} else if (hasSvelteWeb) {
+			const paymentsWebSvelteSrc = path.join(PKG_ROOT, `templates/payments/${context.payments}/web/svelte`);
+			if (await fs.pathExists(paymentsWebSvelteSrc)) await processAndCopyFiles("**/*", paymentsWebSvelteSrc, webAppDir, context);
+		} else if (hasSolidWeb) {
+			const paymentsWebSolidSrc = path.join(PKG_ROOT, `templates/payments/${context.payments}/web/solid`);
+			if (await fs.pathExists(paymentsWebSolidSrc)) await processAndCopyFiles("**/*", paymentsWebSolidSrc, webAppDir, context);
+		}
+	}
+}
 async function setupAddonsTemplate(projectDir, context) {
 	if (!context.addons || context.addons.length === 0) return;
 	for (const addon of context.addons) {
@@ -3057,6 +3143,7 @@ async function addAddonsToProject(input) {
 			addons: input.addons,
 			examples: detectedConfig.examples || [],
 			auth: detectedConfig.auth || "none",
+			payments: detectedConfig.payments || "none",
 			git: false,
 			packageManager: input.packageManager || detectedConfig.packageManager || "npm",
 			install: input.install || false,
@@ -3843,6 +3930,7 @@ async function addDeploymentToProject(input) {
 			addons: detectedConfig.addons || [],
 			examples: detectedConfig.examples || [],
 			auth: detectedConfig.auth || "none",
+			payments: detectedConfig.payments || "none",
 			git: false,
 			packageManager: input.packageManager || detectedConfig.packageManager || "npm",
 			install: input.install || false,
@@ -4384,6 +4472,16 @@ async function setupEnvironmentVariables(config) {
 			key: "GOOGLE_GENERATIVE_AI_API_KEY",
 			value: "",
 			condition: examples?.includes("ai") || false
+		},
+		{
+			key: "POLAR_ACCESS_TOKEN",
+			value: "",
+			condition: config.payments === "polar"
+		},
+		{
+			key: "POLAR_SUCCESS_URL",
+			value: `${corsOrigin}/success?checkout_id={CHECKOUT_ID}`,
+			condition: config.payments === "polar"
 		}
 	];
 	await addEnvVariablesToFile(envPath, serverVars);
@@ -5944,6 +6042,39 @@ async function initializeGit(projectDir, useGit) {
 	await $({ cwd: projectDir })`git commit -m ${"initial commit"}`;
 }
 
+//#endregion
+//#region src/helpers/core/payments-setup.ts
+async function setupPayments(config) {
+	const { payments, projectDir, frontend } = config;
+	if (!payments || payments === "none") return;
+	const serverDir = path.join(projectDir, "apps/server");
+	const clientDir = path.join(projectDir, "apps/web");
+	const serverDirExists = await fs.pathExists(serverDir);
+	const clientDirExists = await fs.pathExists(clientDir);
+	if (!serverDirExists) return;
+	if (payments === "polar") {
+		await addPackageDependency({
+			dependencies: ["@polar-sh/better-auth", "@polar-sh/sdk"],
+			projectDir: serverDir
+		});
+		if (clientDirExists) {
+			const hasWebFrontend$1 = frontend.some((f) => [
+				"react-router",
+				"tanstack-router",
+				"tanstack-start",
+				"next",
+				"nuxt",
+				"svelte",
+				"solid"
+			].includes(f));
+			if (hasWebFrontend$1) await addPackageDependency({
+				dependencies: ["@polar-sh/better-auth"],
+				projectDir: clientDir
+			});
+		}
+	}
+}
+
 //#endregion
 //#region src/utils/docker-utils.ts
 async function isDockerInstalled() {
@@ -6011,6 +6142,7 @@ async function displayPostInstallInstructions(config) {
 	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 polarInstructions = config.payments === "polar" && config.auth === "better-auth" ? getPolarInstructions() : "";
 	const wranglerDeployInstructions = getWranglerDeployInstructions(runCmd, webDeploy, serverDeploy);
 	const alchemyDeployInstructions = getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy);
 	const hasWeb = frontend?.some((f) => [
@@ -6063,6 +6195,7 @@ async function displayPostInstallInstructions(config) {
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
 	if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
 	if (clerkInstructions) output += `\n${clerkInstructions.trim()}\n`;
+	if (polarInstructions) output += `\n${polarInstructions.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`;
@@ -6151,6 +6284,9 @@ function getWranglerDeployInstructions(runCmd, webDeploy, serverDeploy) {
 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 getPolarInstructions() {
+	return `${pc.bold("Polar Payments Setup:")}\n${pc.cyan("•")} Get access token & product ID from ${pc.underline("https://sandbox.polar.sh/")}\n${pc.cyan("•")} Set POLAR_ACCESS_TOKEN in apps/server/.env`;
+}
 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`}`);
@@ -6355,6 +6491,7 @@ async function createProject(options, cliInput) {
 			await setupDockerComposeTemplates(projectDir, options);
 		}
 		await setupAuthTemplate(projectDir, options);
+		if (options.payments && options.payments !== "none") await setupPaymentsTemplate(projectDir, options);
 		if (options.examples.length > 0 && options.examples[0] !== "none") await setupExamplesTemplate(projectDir, options);
 		await setupAddonsTemplate(projectDir, options);
 		await setupDeploymentTemplates(projectDir, options);
@@ -6367,6 +6504,7 @@ async function createProject(options, cliInput) {
 		}
 		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);
 		await handleExtras(projectDir, options);
 		await setupEnvironmentVariables(options);
 		await updatePackageConfigurations(projectDir, options);
@@ -6445,6 +6583,7 @@ async function createProjectHandler(input) {
 				addons: [],
 				examples: [],
 				auth: "none",
+				payments: "none",
 				git: false,
 				packageManager: "npm",
 				install: false,
@@ -6552,7 +6691,7 @@ async function addAddonsHandler(input) {
 		const detectedConfig = await detectProjectConfig(projectDir);
 		if (!detectedConfig) exitWithError("Could not detect project configuration. Please ensure this is a valid Better-T-Stack project.");
 		if (!input.addons || input.addons.length === 0) {
-			const addonsPrompt = await getAddonsToAdd(detectedConfig.frontend || [], detectedConfig.addons || []);
+			const addonsPrompt = await getAddonsToAdd(detectedConfig.frontend || [], detectedConfig.addons || [], detectedConfig.auth);
 			if (addonsPrompt.length > 0) input.addons = addonsPrompt;
 		}
 		if (!input.webDeploy) {
@@ -6691,6 +6830,7 @@ const router = t.router({
 		database: DatabaseSchema.optional(),
 		orm: ORMSchema.optional(),
 		auth: AuthSchema.optional(),
+		payments: PaymentsSchema.optional(),
 		frontend: z.array(FrontendSchema).optional(),
 		addons: z.array(AddonsSchema).optional(),
 		examples: z.array(ExamplesSchema).optional(),

package/package.json

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