create-better-t-stack 3.8.3-pr730.1784e47 → 3.9.0

package/README.md

@@ -90,7 +90,7 @@ You can disable telemetry by setting the `BTS_TELEMETRY_DISABLED` environment va
 
 ```bash
 # Disable telemetry for a single run
-BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack my-app
+BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack
 
 # Disable telemetry globally in your shell profile (.bashrc, .zshrc, etc.)
 export BTS_TELEMETRY_DISABLED=1
@@ -101,85 +101,85 @@ export BTS_TELEMETRY_DISABLED=1
 Create a project with default configuration:
 
 ```bash
-npx create-better-t-stack my-app --yes
+npx create-better-t-stack --yes
 ```
 
 Create a project with specific options:
 
 ```bash
-npx create-better-t-stack my-app --database postgres --orm drizzle --auth --addons pwa biome
+npx create-better-t-stack --database postgres --orm drizzle --auth --addons pwa biome
 ```
 
 Create a project with Elysia backend and Node.js runtime:
 
 ```bash
-npx create-better-t-stack my-app --backend elysia --runtime node
+npx create-better-t-stack --backend elysia --runtime node
 ```
 
 Create a project with multiple frontend options (one web + one native):
 
 ```bash
-npx create-better-t-stack my-app --frontend tanstack-router native-bare
+npx create-better-t-stack --frontend tanstack-router native-bare
 ```
 
 Create a project with examples:
 
 ```bash
-npx create-better-t-stack my-app --examples todo ai
+npx create-better-t-stack --examples todo ai
 ```
 
 Create a project with Turso database setup:
 
 ```bash
-npx create-better-t-stack my-app --database sqlite --orm drizzle --db-setup turso
+npx create-better-t-stack --database sqlite --orm drizzle --db-setup turso
 ```
 
 Create a project with Supabase PostgreSQL setup:
 
 ```bash
-npx create-better-t-stack my-app --database postgres --orm drizzle --db-setup supabase --auth
+npx create-better-t-stack --database postgres --orm drizzle --db-setup supabase --auth
 ```
 
 Create a project with Convex backend:
 
 ```bash
-npx create-better-t-stack my-app --backend convex --frontend tanstack-router
+npx create-better-t-stack --backend convex --frontend tanstack-router
 ```
 
 Create a project with documentation site:
 
 ```bash
-npx create-better-t-stack my-app --addons starlight
+npx create-better-t-stack --addons starlight
 ```
 
 Create a minimal TypeScript project with no backend:
 
 ```bash
-npx create-better-t-stack my-app --backend none --frontend tanstack-router
+npx create-better-t-stack --backend none --frontend tanstack-router
 ```
 
 Create a backend-only project with no frontend:
 
 ```bash
-npx create-better-t-stack my-app --frontend none --backend hono --database postgres --orm drizzle
+npx create-better-t-stack --frontend none --backend hono --database postgres --orm drizzle
 ```
 
 Create a simple frontend-only project:
 
 ```bash
-npx create-better-t-stack my-app --backend none --frontend next --addons none --examples none
+npx create-better-t-stack --backend none --frontend next --addons none --examples none
 ```
 
 Create a Cloudflare Workers project:
 
 ```bash
-npx create-better-t-stack my-app --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1
+npx create-better-t-stack --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1
 ```
 
 Create a minimal API-only project:
 
 ```bash
-npx create-better-t-stack my-app --frontend none --backend hono --api trpc --database none --addons none
+npx create-better-t-stack --frontend none --backend hono --api trpc --database none --addons none
 ```
 
 ## Compatibility Notes

package/dist/cli.mjs

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as router, i as init, n as createBtsCli, o as sponsors, r as docs, t as builder } from "./src-GZpht_dQ.mjs";
+import { a as router, i as init, n as createBtsCli, o as sponsors, r as docs, t as builder } from "./src-DLvUK0Qf.mjs";
 
 export { builder, createBtsCli, docs, init, router, sponsors };

package/dist/{src-GZpht_dQ.mjs → src-DLvUK0Qf.mjs}

@@ -15,7 +15,7 @@ import { $, execa } from "execa";
 import { IndentationText, Node, Project, QuoteKind, SyntaxKind } from "ts-morph";
 import { glob } from "tinyglobby";
 import handlebars from "handlebars";
-import { Biome } from "@biomejs/js-api/nodejs";
+import { format } from "oxfmt";
 import yaml from "yaml";
 import os$1 from "node:os";
 
@@ -96,6 +96,7 @@ const dependencyVersionMap = {
 	"@tauri-apps/cli": "^2.4.0",
 	"@biomejs/biome": "^2.2.0",
 	oxlint: "^1.32.0",
+	oxfmt: "^0.19.0",
 	husky: "^9.1.7",
 	"lint-staged": "^16.1.2",
 	tsx: "^4.19.2",
@@ -136,7 +137,7 @@ const dependencyVersionMap = {
 	"convex-svelte": "^0.0.12",
 	"convex-nuxt": "0.1.5",
 	"convex-vue": "^0.1.5",
-	"@convex-dev/better-auth": "^0.10.4",
+	"@convex-dev/better-auth": "^0.9.7",
 	"@tanstack/svelte-query": "^5.85.3",
 	"@tanstack/svelte-query-devtools": "^5.85.3",
 	"@tanstack/vue-query-devtools": "^5.90.2",
@@ -363,7 +364,7 @@ function getAddonDisplay(addon) {
 			break;
 		case "oxlint":
 			label = "Oxlint";
-			hint = "Rust-powered linter";
+			hint = "Oxlint + Oxfmt (linting & formatting)";
 			break;
 		case "ultracite":
 			label = "Ultracite";
@@ -1233,7 +1234,7 @@ const getLatestCLIVersion = () => {
 */
 function isTelemetryEnabled() {
 	const BTS_TELEMETRY_DISABLED = process.env.BTS_TELEMETRY_DISABLED;
-	const BTS_TELEMETRY = "0";
+	const BTS_TELEMETRY = "1";
 	if (BTS_TELEMETRY_DISABLED !== void 0) return BTS_TELEMETRY_DISABLED !== "1";
 	if (BTS_TELEMETRY !== void 0) return BTS_TELEMETRY === "1";
 	return true;
@@ -1241,7 +1242,16 @@ function isTelemetryEnabled() {
 
 //#endregion
 //#region src/utils/analytics.ts
-async function sendConvexEvent(payload) {}
+const CONVEX_INGEST_URL = "https://striped-seahorse-863.convex.site/api/analytics/ingest";
+async function sendConvexEvent(payload) {
+	try {
+		await fetch(CONVEX_INGEST_URL, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(payload)
+		});
+	} catch {}
+}
 async function trackProjectCreation(config, disableAnalytics = false) {
 	if (!isTelemetryEnabled() || disableAnalytics) return;
 	const { projectName: _projectName, projectDir: _projectDir, relativePath: _relativePath, ...safeConfig } = config;
@@ -2022,6 +2032,38 @@ async function setupFumadocs(config) {
 	}
 }
 
+//#endregion
+//#region src/helpers/addons/oxlint-setup.ts
+async function setupOxlint(projectDir, packageManager) {
+	await addPackageDependency({
+		devDependencies: ["oxlint", "oxfmt"],
+		projectDir
+	});
+	const packageJsonPath = path.join(projectDir, "package.json");
+	if (await fs.pathExists(packageJsonPath)) {
+		const packageJson = await fs.readJson(packageJsonPath);
+		packageJson.scripts = {
+			...packageJson.scripts,
+			check: "oxlint && oxfmt --write"
+		};
+		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+	}
+	const s = spinner();
+	const oxlintInitCommand = getPackageExecutionCommand(packageManager, "oxlint@latest --init");
+	s.start("Initializing oxlint and oxfmt...");
+	await execa(oxlintInitCommand, {
+		cwd: projectDir,
+		env: { CI: "true" },
+		shell: true
+	});
+	await execa(getPackageExecutionCommand(packageManager, "oxfmt@latest --init"), {
+		cwd: projectDir,
+		env: { CI: "true" },
+		shell: true
+	});
+	s.stop("oxlint and oxfmt initialized successfully!");
+}
+
 //#endregion
 //#region src/helpers/addons/ruler-setup.ts
 async function setupRuler(config) {
@@ -2391,7 +2433,7 @@ ${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
 			await setupHusky(projectDir, linter);
 		}
 	}
-	if (addons.includes("oxlint")) await setupOxlint(projectDir, packageManager);
+	if (hasOxlint) await setupOxlint(projectDir, packageManager);
 	if (addons.includes("starlight")) await setupStarlight(config);
 	if (addons.includes("ruler")) await setupRuler(config);
 	if (addons.includes("fumadocs")) await setupFumadocs(config);
@@ -2433,7 +2475,7 @@ async function setupHusky(projectDir, linter) {
 			...packageJson.scripts,
 			prepare: "husky"
 		};
-		if (linter === "oxlint") packageJson["lint-staged"] = { "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "oxlint" };
+		if (linter === "oxlint") packageJson["lint-staged"] = { "*": ["oxlint", "oxfmt --write"] };
 		else if (linter === "biome") packageJson["lint-staged"] = { "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": ["biome check --write ."] };
 		else packageJson["lint-staged"] = { "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "" };
 		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
@@ -2464,30 +2506,6 @@ async function setupPwa(projectDir, frontends) {
 	const viteConfigTs = path.join(clientPackageDir, "vite.config.ts");
 	if (await fs.pathExists(viteConfigTs)) await addPwaToViteConfig(viteConfigTs, path.basename(projectDir));
 }
-async function setupOxlint(projectDir, packageManager) {
-	await addPackageDependency({
-		devDependencies: ["oxlint"],
-		projectDir
-	});
-	const packageJsonPath = path.join(projectDir, "package.json");
-	if (await fs.pathExists(packageJsonPath)) {
-		const packageJson = await fs.readJson(packageJsonPath);
-		packageJson.scripts = {
-			...packageJson.scripts,
-			check: "oxlint"
-		};
-		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
-	}
-	const oxlintInitCommand = getPackageExecutionCommand(packageManager, "oxlint@latest --init");
-	const s = spinner();
-	s.start("Initializing oxlint...");
-	await execa(oxlintInitCommand, {
-		cwd: projectDir,
-		env: { CI: "true" },
-		shell: true
-	});
-	s.stop("oxlint initialized successfully!");
-}
 
 //#endregion
 //#region src/helpers/core/detect-project-config.ts
@@ -2543,61 +2561,16 @@ async function installDependencies({ projectDir, packageManager }) {
 }
 
 //#endregion
-//#region src/utils/biome-formatter.ts
-function initializeBiome() {
-	try {
-		const biome = new Biome();
-		const projectKey = biome.openProject("./").projectKey;
-		biome.applyConfiguration(projectKey, {
-			formatter: {
-				enabled: true,
-				indentStyle: "tab",
-				indentWidth: 2,
-				lineWidth: 80
-			},
-			linter: { enabled: false },
-			javascript: { formatter: { enabled: true } },
-			json: { formatter: { enabled: true } }
-		});
-		return {
-			biome,
-			projectKey
-		};
-	} catch {
-		return null;
-	}
-}
-function isSupportedFile(filePath) {
-	const ext = path.extname(filePath).toLowerCase();
-	return [
-		".js",
-		".jsx",
-		".ts",
-		".tsx",
-		".json",
-		".jsonc"
-	].includes(ext);
-}
-function shouldSkipFile(filePath) {
-	const basename = path.basename(filePath);
-	return [
-		".hbs",
-		"package-lock.json",
-		"yarn.lock",
-		"pnpm-lock.yaml",
-		"bun.lock",
-		".d.ts"
-	].some((pattern) => basename.includes(pattern));
-}
-function formatFileWithBiome(filePath, content) {
-	if (!isSupportedFile(filePath) || shouldSkipFile(filePath)) return null;
+//#region src/utils/file-formatter.ts
+const formatOptions = {
+	experimentalSortPackageJson: true,
+	experimentalSortImports: { order: "asc" }
+};
+async function formatFile(filePath, content) {
 	try {
-		const biomeResult = initializeBiome();
-		if (!biomeResult) return null;
-		const { biome, projectKey } = biomeResult;
-		const result = biome.formatContent(projectKey, content, { filePath: path.basename(filePath) });
-		if (result.diagnostics && result.diagnostics.length > 0) consola.debug(`Biome formatting diagnostics for ${filePath}:`, result.diagnostics);
-		return result.content;
+		const result = await format(path.basename(filePath), content, formatOptions);
+		if (result.errors && result.errors.length > 0) return null;
+		return result.code;
 	} catch {
 		return null;
 	}
@@ -2627,7 +2600,7 @@ async function processTemplate(srcPath, destPath, context) {
 			content = handlebars.compile(templateContent)(context);
 		} else content = await fs.readFile(srcPath, "utf-8");
 		try {
-			const formattedContent = await formatFileWithBiome(destPath, content);
+			const formattedContent = await formatFile(destPath, content);
 			if (formattedContent) content = formattedContent;
 		} catch (formatError) {
 			consola.debug(`Failed to format ${destPath}:`, formatError);
@@ -4231,12 +4204,12 @@ async function setupAuth(config) {
 				if (convexBackendDirExists) {
 					await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.4.7" },
+						customDependencies: { "better-auth": "1.3.34" },
 						projectDir: convexBackendDir
 					});
 					if (hasNativeForBA) await addPackageDependency({
 						dependencies: ["@better-auth/expo"],
-						customDependencies: { "@better-auth/expo": "1.4.7" },
+						customDependencies: { "@better-auth/expo": "1.3.34" },
 						projectDir: convexBackendDir
 					});
 				}
@@ -4246,17 +4219,17 @@ async function setupAuth(config) {
 					const hasViteReactOther = frontend.some((f) => ["tanstack-router", "react-router"].includes(f));
 					if (hasNextJs) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.4.7" },
+						customDependencies: { "better-auth": "1.3.34" },
 						projectDir: clientDir
 					});
 					else if (hasTanStackStart) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.4.7" },
+						customDependencies: { "better-auth": "1.3.34" },
 						projectDir: clientDir
 					});
 					else if (hasViteReactOther) await addPackageDependency({
 						dependencies: ["better-auth", "@convex-dev/better-auth"],
-						customDependencies: { "better-auth": "1.4.7" },
+						customDependencies: { "better-auth": "1.3.34" },
 						projectDir: clientDir
 					});
 				}
@@ -4270,8 +4243,8 @@ async function setupAuth(config) {
 						"@convex-dev/better-auth"
 					],
 					customDependencies: {
-						"better-auth": "1.4.7",
-						"@better-auth/expo": "1.4.7"
+						"better-auth": "1.3.34",
+						"@better-auth/expo": "1.3.34"
 					},
 					projectDir: nativeDir
 				});
@@ -5940,6 +5913,7 @@ function generateFeaturesList(database, auth, addons, orm, runtime, frontend, ba
 	for (const addon of addons) if (addon === "pwa") addonsList.push("- **PWA** - Progressive Web App support");
 	else if (addon === "tauri") addonsList.push("- **Tauri** - Build native desktop applications");
 	else if (addon === "biome") addonsList.push("- **Biome** - Linting and formatting");
+	else if (addon === "oxlint") addonsList.push("- **Oxlint** - Oxlint + Oxfmt (linting & formatting)");
 	else if (addon === "husky") addonsList.push("- **Husky** - Git hooks for code quality");
 	else if (addon === "starlight") addonsList.push("- **Starlight** - Documentation site with Astro");
 	else if (addon === "turborepo") addonsList.push("- **Turborepo** - Optimized monorepo build system");
@@ -6015,6 +5989,8 @@ function generateScriptsList(packageManagerRunCmd, database, orm, _auth, hasNati
 	}
 	if (addons.includes("biome")) scripts += `
 - \`${packageManagerRunCmd} check\`: Run Biome formatting and linting`;
+	if (addons.includes("oxlint")) scripts += `
+- \`${packageManagerRunCmd} check\`: Run Oxlint and Oxfmt`;
 	if (addons.includes("pwa")) scripts += `
 - \`cd apps/web && ${packageManagerRunCmd} generate-pwa-assets\`: Generate PWA assets`;
 	if (addons.includes("tauri")) scripts += `
@@ -6166,10 +6142,12 @@ async function displayPostInstallInstructions(config) {
 	const isBackendSelf = backend === "self";
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager === "pnpm" ? "pnpm run" : "bun run";
 	const cdCmd = `cd ${relativePath}`;
-	const hasHuskyOrBiome = addons?.includes("husky") || addons?.includes("biome");
+	const hasHusky = addons?.includes("husky");
+	const hasLinting = addons?.includes("biome") || addons?.includes("oxlint");
 	const databaseInstructions = !isConvex && database !== "none" ? await getDatabaseInstructions(database, orm, runCmd, runtime, dbSetup, serverDeploy, backend) : "";
 	const tauriInstructions = addons?.includes("tauri") ? getTauriInstructions(runCmd) : "";
-	const lintingInstructions = hasHuskyOrBiome ? getLintingInstructions(runCmd) : "";
+	const huskyInstructions = hasHusky ? getHuskyInstructions(runCmd) : "";
+	const lintingInstructions = hasLinting ? getLintingInstructions(runCmd) : "";
 	const nativeInstructions = (frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles")) && backend !== "none" ? getNativeInstructions(isConvex, isBackendSelf, frontend || []) : "";
 	const pwaInstructions = addons?.includes("pwa") && frontend?.includes("react-router") ? getPwaInstructions() : "";
 	const starlightInstructions = addons?.includes("starlight") ? getStarlightInstructions(runCmd) : "";
@@ -6223,6 +6201,7 @@ async function displayPostInstallInstructions(config) {
 	if (nativeInstructions) output += `\n${nativeInstructions.trim()}\n`;
 	if (databaseInstructions) output += `\n${databaseInstructions.trim()}\n`;
 	if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;
+	if (huskyInstructions) output += `\n${huskyInstructions.trim()}\n`;
 	if (lintingInstructions) output += `\n${lintingInstructions.trim()}\n`;
 	if (pwaInstructions) output += `\n${pwaInstructions.trim()}\n`;
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
@@ -6244,6 +6223,9 @@ function getNativeInstructions(isConvex, isBackendSelf, _frontend) {
 	if (isConvex) instructions += `\n${pc.yellow("IMPORTANT:")} When using local development with Convex and native apps,\n   ensure you use your local IP address instead of localhost or 127.0.0.1\n   for proper connectivity.\n`;
 	return instructions;
 }
+function getHuskyInstructions(runCmd) {
+	return `${pc.bold("Git hooks with Husky:")}\n${pc.cyan("•")} Initialize hooks: ${`${runCmd} prepare`}\n`;
+}
 function getLintingInstructions(runCmd) {
 	return `${pc.bold("Linting and formatting:")}\n${pc.cyan("•")} Format and lint fix: ${`${runCmd} check`}\n`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.8.3-pr730.1784e47",
+  "version": "3.9.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",
@@ -67,9 +67,7 @@
     }
   },
   "dependencies": {
-    "@better-t-stack/types": "3.8.3-pr730.1784e47",
-    "@biomejs/js-api": "^4.0.0",
-    "@biomejs/wasm-nodejs": "^2.3.8",
+    "@better-t-stack/types": "^3.9.0",
     "@clack/prompts": "^1.0.0-alpha.8",
     "@orpc/server": "^1.12.2",
     "consola": "^3.4.2",
@@ -78,6 +76,7 @@
     "gradient-string": "^3.0.0",
     "handlebars": "^4.7.8",
     "jsonc-parser": "^3.3.1",
+    "oxfmt": "^0.19.0",
     "picocolors": "^1.1.1",
     "tinyglobby": "^0.2.15",
     "trpc-cli": "^0.12.1",

package/templates/auth/better-auth/convex/backend/convex/auth.config.ts.hbs

@@ -1,6 +1,8 @@
-import { getAuthConfigProvider } from "@convex-dev/better-auth/auth-config";
-import type { AuthConfig } from "convex/server";
-
 export default {
-  providers: [getAuthConfigProvider()],
-} satisfies AuthConfig;
+    providers: [
+        {
+            domain: process.env.CONVEX_SITE_URL,
+            applicationID: "convex",
+        },
+    ],
+};

package/templates/auth/better-auth/convex/web/react/tanstack-start/src/lib/auth-server.ts.hbs

@@ -1,12 +1,6 @@
-import { convexBetterAuthReactStart } from "@convex-dev/better-auth/react-start";
+import { createAuth } from "@{{projectName}}/backend/convex/auth";
+import { setupFetchClient } from "@convex-dev/better-auth/react-start";
+import { getCookie } from "@tanstack/react-start/server";
 
-export const {
-  handler,
-  getToken,
-  fetchAuthQuery,
-  fetchAuthMutation,
-  fetchAuthAction,
-} = convexBetterAuthReactStart({
-  convexUrl: process.env.VITE_CONVEX_URL!,
-  convexSiteUrl: process.env.VITE_CONVEX_SITE_URL!,
-});
+export const { fetchQuery, fetchMutation, fetchAction } =
+	await setupFetchClient(createAuth, getCookie);

package/templates/auth/better-auth/fullstack/tanstack-start/src/routes/api/auth/$.ts.hbs

@@ -1,11 +1,15 @@
-import { createFileRoute } from "@tanstack/react-router";
-import { handler } from "@/lib/auth-server";
+import { auth } from '@{{projectName}}/auth'
+import { createFileRoute } from '@tanstack/react-router'
 
-export const Route = createFileRoute("/api/auth/$")({
+export const Route = createFileRoute('/api/auth/$')({
   server: {
     handlers: {
-      GET: ({ request }) => handler(request),
-      POST: ({ request }) => handler(request),
+      GET: ({ request }) => {
+        return auth.handler(request)
+      },
+      POST: ({ request }) => {
+        return auth.handler(request)
+      },
     },
   },
-});
+})

package/templates/auth/better-auth/web/react/base/src/lib/auth-client.ts.hbs

@@ -1,4 +1,3 @@
-import type { auth } from "@{{projectName}}/auth";
 import { createAuthClient } from "better-auth/react";
 {{#if (eq payments "polar")}}
 import { polarClient } from "@polar-sh/better-auth";