create-better-t-stack 3.19.4 → 3.19.5

package/dist/cli.mjs

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

package/dist/index.mjs

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

package/dist/{src-mMd-eO_p.mjs → src-C8vduSK8.mjs}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 import { t as __reExport } from "./chunk-CHc3S52W.mjs";
-import { autocompleteMultiselect, cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
 import { Result, Result as Result$1, TaggedError } from "better-result";
-import pc from "picocolors";
 import { createCli } from "trpc-cli";
 import z from "zod";
-import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, GeneratorError, GeneratorError as GeneratorError$1, TEMPLATE_COUNT, VirtualFileSystem, VirtualFileSystem as VirtualFileSystem$1, dependencyVersionMap, generate, generate as generate$1, generateReproducibleCommand, processAddonTemplates, processAddonsDeps } from "@better-t-stack/template-generator";
-import { writeTree } from "@better-t-stack/template-generator/fs-writer";
+import { autocompleteMultiselect, cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
+import pc from "picocolors";
+import envPaths from "env-paths";
 import fs from "fs-extra";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, GeneratorError, GeneratorError as GeneratorError$1, TEMPLATE_COUNT, VirtualFileSystem, VirtualFileSystem as VirtualFileSystem$1, dependencyVersionMap, generate, generate as generate$1, generateReproducibleCommand, processAddonTemplates, processAddonsDeps } from "@better-t-stack/template-generator";
 import consola, { consola as consola$1 } from "consola";
+import gradient from "gradient-string";
+import { $, execa } from "execa";
+import { writeTree } from "@better-t-stack/template-generator/fs-writer";
 import { ConfirmPrompt, GroupMultiSelectPrompt, MultiSelectPrompt, SelectPrompt, isCancel as isCancel$1 } from "@clack/core";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { applyEdits, modify, parse } from "jsonc-parser";
-import gradient from "gradient-string";
-import { $, execa } from "execa";
-import envPaths from "env-paths";
 import { format } from "oxfmt";
 import os$1 from "node:os";
 
@@ -94,25 +94,6 @@ const ADDON_COMPATIBILITY = {
 	none: []
 };
 
-//#endregion
-//#region src/types.ts
-var types_exports = {};
-import * as import__better_t_stack_types from "@better-t-stack/types";
-__reExport(types_exports, import__better_t_stack_types);
-
-//#endregion
-//#region src/utils/compatibility.ts
-const WEB_FRAMEWORKS = [
-	"tanstack-router",
-	"react-router",
-	"tanstack-start",
-	"next",
-	"nuxt",
-	"svelte",
-	"solid",
-	"astro"
-];
-
 //#endregion
 //#region src/utils/errors.ts
 /**
@@ -202,6 +183,344 @@ function displayError(error) {
 	else consola.error(pc.red(error.message));
 }
 
+//#endregion
+//#region src/utils/get-latest-cli-version.ts
+function getLatestCLIVersionResult() {
+	const packageJsonPath = path.join(PKG_ROOT, "package.json");
+	return Result.try({
+		try: () => {
+			return fs.readJSONSync(packageJsonPath).version;
+		},
+		catch: (e) => new CLIError({
+			message: `Failed to read CLI version from package.json: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+function getLatestCLIVersion() {
+	return getLatestCLIVersionResult().unwrapOr("1.0.0");
+}
+
+//#endregion
+//#region src/utils/project-history.ts
+const paths = envPaths("better-t-stack", { suffix: "" });
+const HISTORY_FILE = "history.json";
+var HistoryError = class extends TaggedError("HistoryError")() {};
+function getHistoryDir() {
+	return paths.data;
+}
+function getHistoryPath() {
+	return path.join(paths.data, HISTORY_FILE);
+}
+function generateId() {
+	return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+function emptyHistory() {
+	return {
+		version: 1,
+		entries: []
+	};
+}
+async function ensureHistoryDir() {
+	return Result.tryPromise({
+		try: async () => {
+			await fs.ensureDir(getHistoryDir());
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to create history directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+async function readHistory() {
+	const historyPath = getHistoryPath();
+	const existsResult = await Result.tryPromise({
+		try: async () => await fs.pathExists(historyPath),
+		catch: (e) => new HistoryError({
+			message: `Failed to check history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (existsResult.isErr()) return existsResult;
+	if (!existsResult.value) return Result.ok(emptyHistory());
+	const readResult = await Result.tryPromise({
+		try: async () => await fs.readJson(historyPath),
+		catch: (e) => new HistoryError({
+			message: `Failed to read history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (readResult.isErr()) return Result.ok(emptyHistory());
+	return Result.ok(readResult.value);
+}
+async function writeHistory(history) {
+	const ensureDirResult = await ensureHistoryDir();
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	return Result.tryPromise({
+		try: async () => {
+			await fs.writeJson(getHistoryPath(), history, { spaces: 2 });
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to write history file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+async function addToHistory(config, reproducibleCommand) {
+	const historyResult = await readHistory();
+	if (historyResult.isErr()) return historyResult;
+	const history = historyResult.value;
+	const entry = {
+		id: generateId(),
+		projectName: config.projectName,
+		projectDir: config.projectDir,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		stack: {
+			frontend: config.frontend,
+			backend: config.backend,
+			database: config.database,
+			orm: config.orm,
+			runtime: config.runtime,
+			auth: config.auth,
+			payments: config.payments,
+			api: config.api,
+			addons: config.addons,
+			examples: config.examples,
+			dbSetup: config.dbSetup,
+			packageManager: config.packageManager
+		},
+		cliVersion: getLatestCLIVersion(),
+		reproducibleCommand
+	};
+	history.entries.unshift(entry);
+	if (history.entries.length > 100) history.entries = history.entries.slice(0, 100);
+	return await writeHistory(history);
+}
+async function getHistory(limit = 10) {
+	const historyResult = await readHistory();
+	if (historyResult.isErr()) return historyResult;
+	return Result.ok(historyResult.value.entries.slice(0, limit));
+}
+async function clearHistory() {
+	const historyPath = getHistoryPath();
+	return Result.tryPromise({
+		try: async () => {
+			if (await fs.pathExists(historyPath)) await fs.remove(historyPath);
+		},
+		catch: (e) => new HistoryError({
+			message: `Failed to clear history: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+}
+
+//#endregion
+//#region src/utils/render-title.ts
+const TITLE_TEXT = `
+ ██████╗ ███████╗████████╗████████╗███████╗██████╗
+ ██╔══██╗██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗
+ ██████╔╝█████╗     ██║      ██║   █████╗  ██████╔╝
+ ██╔══██╗██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗
+ ██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║
+ ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝
+
+ ████████╗    ███████╗████████╗ █████╗  ██████╗██╗  ██╗
+ ╚══██╔══╝    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
+    ██║       ███████╗   ██║   ███████║██║     █████╔╝
+    ██║       ╚════██║   ██║   ██╔══██║██║     ██╔═██╗
+    ██║       ███████║   ██║   ██║  ██║╚██████╗██║  ██╗
+    ╚═╝       ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
+ `;
+const catppuccinTheme = {
+	pink: "#F5C2E7",
+	mauve: "#CBA6F7",
+	red: "#F38BA8",
+	maroon: "#E78284",
+	peach: "#FAB387",
+	yellow: "#F9E2AF",
+	green: "#A6E3A1",
+	teal: "#94E2D5",
+	sky: "#89DCEB",
+	sapphire: "#74C7EC",
+	lavender: "#B4BEFE"
+};
+const renderTitle = () => {
+	const terminalWidth = process.stdout.columns || 80;
+	const titleLines = TITLE_TEXT.split("\n");
+	if (terminalWidth < Math.max(...titleLines.map((line) => line.length))) console.log(gradient(Object.values(catppuccinTheme)).multiline(`Better T Stack`));
+	else console.log(gradient(Object.values(catppuccinTheme)).multiline(TITLE_TEXT));
+};
+
+//#endregion
+//#region src/commands/history.ts
+function formatStackSummary(entry) {
+	const parts = [];
+	if (entry.stack.frontend.length > 0 && !entry.stack.frontend.includes("none")) parts.push(entry.stack.frontend.join(", "));
+	if (entry.stack.backend && entry.stack.backend !== "none") parts.push(entry.stack.backend);
+	if (entry.stack.database && entry.stack.database !== "none") parts.push(entry.stack.database);
+	if (entry.stack.orm && entry.stack.orm !== "none") parts.push(entry.stack.orm);
+	return parts.length > 0 ? parts.join(" + ") : "minimal";
+}
+function formatDate(isoString) {
+	return new Date(isoString).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "short",
+		day: "numeric",
+		hour: "2-digit",
+		minute: "2-digit"
+	});
+}
+async function historyHandler(input) {
+	if (input.clear) {
+		const clearResult = await clearHistory();
+		if (clearResult.isErr()) {
+			log.warn(pc.yellow(clearResult.error.message));
+			return;
+		}
+		log.success(pc.green("Project history cleared."));
+		return;
+	}
+	const historyResult = await getHistory(input.limit);
+	if (historyResult.isErr()) {
+		log.warn(pc.yellow(historyResult.error.message));
+		return;
+	}
+	const entries = historyResult.value;
+	if (entries.length === 0) {
+		log.info(pc.dim("No projects in history yet."));
+		log.info(pc.dim("Create a project with: create-better-t-stack my-app"));
+		return;
+	}
+	if (input.json) {
+		console.log(JSON.stringify(entries, null, 2));
+		return;
+	}
+	renderTitle();
+	intro(pc.magenta(`Project History (${entries.length} entries)`));
+	for (const [index, entry] of entries.entries()) {
+		const num = pc.dim(`${index + 1}.`);
+		const name = pc.cyan(pc.bold(entry.projectName));
+		const stack = pc.dim(formatStackSummary(entry));
+		log.message(`${num} ${name}`);
+		log.message(`   ${pc.dim("Created:")} ${formatDate(entry.createdAt)}`);
+		log.message(`   ${pc.dim("Path:")} ${entry.projectDir}`);
+		log.message(`   ${pc.dim("Stack:")} ${stack}`);
+		log.message(`   ${pc.dim("Command:")} ${pc.dim(entry.reproducibleCommand)}`);
+		log.message("");
+	}
+}
+
+//#endregion
+//#region src/utils/open-url.ts
+async function openUrl(url) {
+	const platform = process.platform;
+	if (platform === "darwin") {
+		await $({ stdio: "ignore" })`open ${url}`;
+		return;
+	}
+	if (platform === "win32") {
+		const escapedUrl = url.replace(/&/g, "^&");
+		await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
+		return;
+	}
+	await $({ stdio: "ignore" })`xdg-open ${url}`;
+}
+
+//#endregion
+//#region src/utils/sponsors.ts
+const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
+async function fetchSponsors(url = SPONSORS_JSON_URL) {
+	const s = spinner();
+	s.start("Fetching sponsors…");
+	const response = await fetch(url);
+	if (!response.ok) {
+		s.stop(pc.red(`Failed to fetch sponsors: ${response.statusText}`));
+		throw new Error(`Failed to fetch sponsors: ${response.statusText}`);
+	}
+	const sponsors = await response.json();
+	s.stop("Sponsors fetched successfully!");
+	return sponsors;
+}
+function displaySponsors(sponsors) {
+	const { total_sponsors } = sponsors.summary;
+	if (total_sponsors === 0) {
+		log.info("No sponsors found. You can be the first one! ✨");
+		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
+		return;
+	}
+	displaySponsorsBox(sponsors);
+	if (total_sponsors - sponsors.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors.specialSponsors.length} more amazing sponsors.\n`));
+	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
+}
+function displaySponsorsBox(sponsors) {
+	if (sponsors.specialSponsors.length === 0) return;
+	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
+	sponsors.specialSponsors.forEach((sponsor, idx) => {
+		const displayName = sponsor.name ?? sponsor.githubId;
+		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
+		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
+		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
+		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
+		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
+		if (idx < sponsors.specialSponsors.length - 1) output += "\n";
+	});
+	consola$1.box(output);
+}
+
+//#endregion
+//#region src/commands/meta.ts
+const DOCS_URL = "https://better-t-stack.dev/docs";
+const BUILDER_URL = "https://better-t-stack.dev/new";
+async function openExternalUrl(url, successMessage) {
+	if ((await Result.tryPromise({
+		try: () => openUrl(url),
+		catch: () => null
+	})).isOk()) log.success(pc.blue(successMessage));
+	else log.message(`Please visit ${url}`);
+}
+async function showSponsorsCommand() {
+	const result = await Result.tryPromise({
+		try: async () => {
+			renderTitle();
+			intro(pc.magenta("Better-T-Stack Sponsors"));
+			displaySponsors(await fetchSponsors());
+		},
+		catch: (error) => new CLIError({
+			message: error instanceof Error ? error.message : "Failed to display sponsors",
+			cause: error
+		})
+	});
+	if (result.isErr()) {
+		displayError(result.error);
+		process.exit(1);
+	}
+}
+async function openDocsCommand() {
+	await openExternalUrl(DOCS_URL, "Opened docs in your default browser.");
+}
+async function openBuilderCommand() {
+	await openExternalUrl(BUILDER_URL, "Opened builder in your default browser.");
+}
+
+//#endregion
+//#region src/types.ts
+var types_exports = {};
+import * as import__better_t_stack_types from "@better-t-stack/types";
+__reExport(types_exports, import__better_t_stack_types);
+
+//#endregion
+//#region src/utils/compatibility.ts
+const WEB_FRAMEWORKS = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid",
+	"astro"
+];
+
 //#endregion
 //#region src/utils/compatibility-rules.ts
 function validationErr$1(message) {
@@ -845,43 +1164,6 @@ async function updateBtsConfig(projectDir, updates) {
 	} catch {}
 }
 
-//#endregion
-//#region src/utils/render-title.ts
-const TITLE_TEXT = `
- ██████╗ ███████╗████████╗████████╗███████╗██████╗
- ██╔══██╗██╔════╝╚══██╔══╝╚══██╔══╝██╔════╝██╔══██╗
- ██████╔╝█████╗     ██║      ██║   █████╗  ██████╔╝
- ██╔══██╗██╔══╝     ██║      ██║   ██╔══╝  ██╔══██╗
- ██████╔╝███████╗   ██║      ██║   ███████╗██║  ██║
- ╚═════╝ ╚══════╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═╝
-
- ████████╗    ███████╗████████╗ █████╗  ██████╗██╗  ██╗
- ╚══██╔══╝    ██╔════╝╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝
-    ██║       ███████╗   ██║   ███████║██║     █████╔╝
-    ██║       ╚════██║   ██║   ██╔══██║██║     ██╔═██╗
-    ██║       ███████║   ██║   ██║  ██║╚██████╗██║  ██╗
-    ╚═╝       ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝
- `;
-const catppuccinTheme = {
-	pink: "#F5C2E7",
-	mauve: "#CBA6F7",
-	red: "#F38BA8",
-	maroon: "#E78284",
-	peach: "#FAB387",
-	yellow: "#F9E2AF",
-	green: "#A6E3A1",
-	teal: "#94E2D5",
-	sky: "#89DCEB",
-	sapphire: "#74C7EC",
-	lavender: "#B4BEFE"
-};
-const renderTitle = () => {
-	const terminalWidth = process.stdout.columns || 80;
-	const titleLines = TITLE_TEXT.split("\n");
-	if (terminalWidth < Math.max(...titleLines.map((line) => line.length))) console.log(gradient(Object.values(catppuccinTheme)).multiline(`Better T Stack`));
-	else console.log(gradient(Object.values(catppuccinTheme)).multiline(TITLE_TEXT));
-};
-
 //#endregion
 //#region src/utils/add-package-deps.ts
 const addPackageDependency = async (opts) => {
@@ -3041,24 +3323,6 @@ async function getProjectName(initialName) {
 	return projectPath;
 }
 
-//#endregion
-//#region src/utils/get-latest-cli-version.ts
-function getLatestCLIVersionResult() {
-	const packageJsonPath = path.join(PKG_ROOT, "package.json");
-	return Result.try({
-		try: () => {
-			return fs.readJSONSync(packageJsonPath).version;
-		},
-		catch: (e) => new CLIError({
-			message: `Failed to read CLI version from package.json: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-function getLatestCLIVersion() {
-	return getLatestCLIVersionResult().unwrapOr("1.0.0");
-}
-
 //#endregion
 //#region src/utils/telemetry.ts
 /**
@@ -3233,119 +3497,6 @@ async function setupProjectDirectory(finalPathInput, shouldClearDirectory) {
 	};
 }
 
-//#endregion
-//#region src/utils/project-history.ts
-const paths = envPaths("better-t-stack", { suffix: "" });
-const HISTORY_FILE = "history.json";
-var HistoryError = class extends TaggedError("HistoryError")() {};
-function getHistoryDir() {
-	return paths.data;
-}
-function getHistoryPath() {
-	return path.join(paths.data, HISTORY_FILE);
-}
-function generateId() {
-	return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-}
-function emptyHistory() {
-	return {
-		version: 1,
-		entries: []
-	};
-}
-async function ensureHistoryDir() {
-	return Result.tryPromise({
-		try: async () => {
-			await fs.ensureDir(getHistoryDir());
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to create history directory: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-async function readHistory() {
-	const historyPath = getHistoryPath();
-	const existsResult = await Result.tryPromise({
-		try: async () => await fs.pathExists(historyPath),
-		catch: (e) => new HistoryError({
-			message: `Failed to check history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-	if (existsResult.isErr()) return existsResult;
-	if (!existsResult.value) return Result.ok(emptyHistory());
-	const readResult = await Result.tryPromise({
-		try: async () => await fs.readJson(historyPath),
-		catch: (e) => new HistoryError({
-			message: `Failed to read history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-	if (readResult.isErr()) return Result.ok(emptyHistory());
-	return Result.ok(readResult.value);
-}
-async function writeHistory(history) {
-	const ensureDirResult = await ensureHistoryDir();
-	if (ensureDirResult.isErr()) return ensureDirResult;
-	return Result.tryPromise({
-		try: async () => {
-			await fs.writeJson(getHistoryPath(), history, { spaces: 2 });
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to write history file: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-async function addToHistory(config, reproducibleCommand) {
-	const historyResult = await readHistory();
-	if (historyResult.isErr()) return historyResult;
-	const history = historyResult.value;
-	const entry = {
-		id: generateId(),
-		projectName: config.projectName,
-		projectDir: config.projectDir,
-		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		stack: {
-			frontend: config.frontend,
-			backend: config.backend,
-			database: config.database,
-			orm: config.orm,
-			runtime: config.runtime,
-			auth: config.auth,
-			payments: config.payments,
-			api: config.api,
-			addons: config.addons,
-			examples: config.examples,
-			dbSetup: config.dbSetup,
-			packageManager: config.packageManager
-		},
-		cliVersion: getLatestCLIVersion(),
-		reproducibleCommand
-	};
-	history.entries.unshift(entry);
-	if (history.entries.length > 100) history.entries = history.entries.slice(0, 100);
-	return await writeHistory(history);
-}
-async function getHistory(limit = 10) {
-	const historyResult = await readHistory();
-	if (historyResult.isErr()) return historyResult;
-	return Result.ok(historyResult.value.entries.slice(0, limit));
-}
-async function clearHistory() {
-	const historyPath = getHistoryPath();
-	return Result.tryPromise({
-		try: async () => {
-			if (await fs.pathExists(historyPath)) await fs.remove(historyPath);
-		},
-		catch: (e) => new HistoryError({
-			message: `Failed to clear history: ${e instanceof Error ? e.message : String(e)}`,
-			cause: e
-		})
-	});
-}
-
 //#endregion
 //#region src/utils/project-name-validation.ts
 function validateProjectName(name) {
@@ -5072,11 +5223,12 @@ async function displayPostInstallInstructions(config) {
 		"solid"
 	].includes(f));
 	const hasNative = frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles");
-	const bunWebNativeWarning = packageManager === "bun" && hasNative && hasWeb ? getBunWebNativeWarning() : "";
-	const noOrmWarning = !isConvex && database !== "none" && orm === "none" ? getNoOrmWarning() : "";
 	const hasReactRouter = frontend?.includes("react-router");
 	const hasSvelte = frontend?.includes("svelte");
 	const webPort = hasReactRouter || hasSvelte ? "5173" : "3001";
+	const betterAuthConvexInstructions = isConvex && config.auth === "better-auth" ? getBetterAuthConvexInstructions(hasWeb ?? false, webPort, packageManager) : "";
+	const bunWebNativeWarning = packageManager === "bun" && hasNative && hasWeb ? getBunWebNativeWarning() : "";
+	const noOrmWarning = !isConvex && database !== "none" && orm === "none" ? getNoOrmWarning() : "";
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
@@ -5116,6 +5268,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 (betterAuthConvexInstructions) output += `\n${betterAuthConvexInstructions.trim()}\n`;
 	if (polarInstructions) output += `\n${polarInstructions.trim()}\n`;
 	if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
 	if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
@@ -5199,6 +5352,10 @@ function getBunWebNativeWarning() {
 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 getBetterAuthConvexInstructions(hasWeb, webPort, packageManager) {
+	const cmd = packageManager === "npm" ? "npx" : packageManager;
+	return `${pc.bold("Better Auth + Convex Setup:")}\n${pc.cyan("•")} Set environment variables from ${pc.white("packages/backend")}:\n${pc.white("   cd packages/backend")}\n${pc.white(`   ${cmd} convex env set BETTER_AUTH_SECRET=$(openssl rand -base64 32)`)}\n` + (hasWeb ? `${pc.white(`   ${cmd} convex env set SITE_URL http://localhost:${webPort}`)}\n` : "");
+}
 function getPolarInstructions(backend) {
 	const envPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
 	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 ${envPath}`;
@@ -5560,121 +5717,8 @@ async function handleDirectoryConflictProgrammatically(currentPathInput, strateg
 	}
 }
 
-//#endregion
-//#region src/utils/open-url.ts
-async function openUrl(url) {
-	const platform = process.platform;
-	if ((await Result.tryPromise({
-		try: async () => {
-			if (platform === "darwin") await $({ stdio: "ignore" })`open ${url}`;
-			else if (platform === "win32") {
-				const escapedUrl = url.replace(/&/g, "^&");
-				await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
-			} else await $({ stdio: "ignore" })`xdg-open ${url}`;
-		},
-		catch: () => void 0
-	})).isErr()) log.message(`Please open ${url} in your browser.`);
-}
-
-//#endregion
-//#region src/utils/sponsors.ts
-const SPONSORS_JSON_URL = "https://sponsors.better-t-stack.dev/sponsors.json";
-async function fetchSponsors(url = SPONSORS_JSON_URL) {
-	const s = spinner();
-	s.start("Fetching sponsors…");
-	const response = await fetch(url);
-	if (!response.ok) {
-		s.stop(pc.red(`Failed to fetch sponsors: ${response.statusText}`));
-		throw new Error(`Failed to fetch sponsors: ${response.statusText}`);
-	}
-	const sponsors = await response.json();
-	s.stop("Sponsors fetched successfully!");
-	return sponsors;
-}
-function displaySponsors(sponsors) {
-	const { total_sponsors } = sponsors.summary;
-	if (total_sponsors === 0) {
-		log.info("No sponsors found. You can be the first one! ✨");
-		outro(pc.cyan("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
-		return;
-	}
-	displaySponsorsBox(sponsors);
-	if (total_sponsors - sponsors.specialSponsors.length > 0) log.message(pc.blue(`+${total_sponsors - sponsors.specialSponsors.length} more amazing sponsors.\n`));
-	outro(pc.magenta("Visit https://github.com/sponsors/AmanVarshney01 to become a sponsor."));
-}
-function displaySponsorsBox(sponsors) {
-	if (sponsors.specialSponsors.length === 0) return;
-	let output = `${pc.bold(pc.cyan("-> Special Sponsors"))}\n\n`;
-	sponsors.specialSponsors.forEach((sponsor, idx) => {
-		const displayName = sponsor.name ?? sponsor.githubId;
-		const tier = sponsor.tierName ? ` ${pc.yellow(`(${sponsor.tierName})`)}` : "";
-		output += `${pc.green(`• ${displayName}`)}${tier}\n`;
-		output += `  ${pc.dim("GitHub:")} https://github.com/${sponsor.githubId}\n`;
-		const website = sponsor.websiteUrl ?? sponsor.githubUrl;
-		if (website) output += `  ${pc.dim("Website:")} ${website}\n`;
-		if (idx < sponsors.specialSponsors.length - 1) output += "\n";
-	});
-	consola$1.box(output);
-}
-
 //#endregion
 //#region src/index.ts
-function formatStackSummary(entry) {
-	const parts = [];
-	if (entry.stack.frontend.length > 0 && !entry.stack.frontend.includes("none")) parts.push(entry.stack.frontend.join(", "));
-	if (entry.stack.backend && entry.stack.backend !== "none") parts.push(entry.stack.backend);
-	if (entry.stack.database && entry.stack.database !== "none") parts.push(entry.stack.database);
-	if (entry.stack.orm && entry.stack.orm !== "none") parts.push(entry.stack.orm);
-	return parts.length > 0 ? parts.join(" + ") : "minimal";
-}
-function formatDate(isoString) {
-	return new Date(isoString).toLocaleDateString("en-US", {
-		year: "numeric",
-		month: "short",
-		day: "numeric",
-		hour: "2-digit",
-		minute: "2-digit"
-	});
-}
-async function historyHandler(input) {
-	if (input.clear) {
-		const clearResult = await clearHistory();
-		if (clearResult.isErr()) {
-			log.warn(pc.yellow(clearResult.error.message));
-			return;
-		}
-		log.success(pc.green("Project history cleared."));
-		return;
-	}
-	const historyResult = await getHistory(input.limit);
-	if (historyResult.isErr()) {
-		log.warn(pc.yellow(historyResult.error.message));
-		return;
-	}
-	const entries = historyResult.value;
-	if (entries.length === 0) {
-		log.info(pc.dim("No projects in history yet."));
-		log.info(pc.dim("Create a project with: create-better-t-stack my-app"));
-		return;
-	}
-	if (input.json) {
-		console.log(JSON.stringify(entries, null, 2));
-		return;
-	}
-	renderTitle();
-	intro(pc.magenta(`Project History (${entries.length} entries)`));
-	for (const [index, entry] of entries.entries()) {
-		const num = pc.dim(`${index + 1}.`);
-		const name = pc.cyan(pc.bold(entry.projectName));
-		const stack = pc.dim(formatStackSummary(entry));
-		log.message(`${num} ${name}`);
-		log.message(`   ${pc.dim("Created:")} ${formatDate(entry.createdAt)}`);
-		log.message(`   ${pc.dim("Path:")} ${entry.projectDir}`);
-		log.message(`   ${pc.dim("Stack:")} ${stack}`);
-		log.message(`   ${pc.dim("Command:")} ${pc.dim(entry.reproducibleCommand)}`);
-		log.message("");
-	}
-}
 const router = os.router({
 	create: os.meta({
 		description: "Create a new Better-T-Stack project",
@@ -5713,39 +5757,9 @@ const router = os.router({
 		});
 		if (options.verbose) return result;
 	}),
-	sponsors: os.meta({ description: "Show Better-T-Stack sponsors" }).handler(async () => {
-		const result = await Result.tryPromise({
-			try: async () => {
-				renderTitle();
-				intro(pc.magenta("Better-T-Stack Sponsors"));
-				displaySponsors(await fetchSponsors());
-			},
-			catch: (e) => new CLIError({
-				message: e instanceof Error ? e.message : "Failed to display sponsors",
-				cause: e
-			})
-		});
-		if (result.isErr()) {
-			displayError(result.error);
-			process.exit(1);
-		}
-	}),
-	docs: os.meta({ description: "Open Better-T-Stack documentation" }).handler(async () => {
-		const DOCS_URL = "https://better-t-stack.dev/docs";
-		if ((await Result.tryPromise({
-			try: () => openUrl(DOCS_URL),
-			catch: () => null
-		})).isOk()) log.success(pc.blue("Opened docs in your default browser."));
-		else log.message(`Please visit ${DOCS_URL}`);
-	}),
-	builder: os.meta({ description: "Open the web-based stack builder" }).handler(async () => {
-		const BUILDER_URL = "https://better-t-stack.dev/new";
-		if ((await Result.tryPromise({
-			try: () => openUrl(BUILDER_URL),
-			catch: () => null
-		})).isOk()) log.success(pc.blue("Opened builder in your default browser."));
-		else log.message(`Please visit ${BUILDER_URL}`);
-	}),
+	sponsors: os.meta({ description: "Show Better-T-Stack sponsors" }).handler(showSponsorsCommand),
+	docs: os.meta({ description: "Open Better-T-Stack documentation" }).handler(openDocsCommand),
+	builder: os.meta({ description: "Open the web-based stack builder" }).handler(openBuilderCommand),
 	add: os.meta({ description: "Add addons to an existing Better-T-Stack project" }).input(z.object({
 		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
 		install: z.boolean().optional().default(false).describe("Install dependencies after adding"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.19.4",
+  "version": "3.19.5",
   "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.19.4",
-    "@better-t-stack/types": "^3.19.4",
+    "@better-t-stack/template-generator": "^3.19.5",
+    "@better-t-stack/types": "^3.19.5",
     "@clack/core": "^1.0.0",
     "@clack/prompts": "^1.0.0",
     "@orpc/server": "^1.13.4",