create-better-t-stack 3.14.1 → 3.15.0

package/README.md

@@ -41,7 +41,7 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | **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)                                                                                                                                                                                                |
 | **Styling**              | Tailwind CSS with shadcn/ui components                                                                                                                                                                                                                     |
-| **Addons**               | • PWA support<br>• Tauri (desktop applications)<br>• Starlight (documentation site)<br>• Biome (linting and formatting)<br>• Husky (Git hooks)<br>• Turborepo (optimized builds)                                                                           |
+| **Addons**               | • PWA support<br>• Tauri (desktop applications)<br>• Starlight (documentation site)<br>• Biome (linting and formatting)<br>• Lefthook, Husky (Git hooks)<br>• Turborepo (optimized builds)                                                                 |
 | **Examples**             | • Todo app<br>• AI Chat interface (using Vercel AI SDK)                                                                                                                                                                                                    |
 | **Developer Experience** | • Automatic Git initialization<br>• Package manager choice (npm, pnpm, bun)<br>• Automatic dependency installation                                                                                                                                         |
 
@@ -58,7 +58,7 @@ Options:
   --auth                          Include authentication
   --no-auth                       Exclude authentication
   --frontend <types...>           Frontend types (tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, native-bare, native-uniwind, native-unistyles, none)
-  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, fumadocs, ultracite, oxlint, none)
+  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, lefthook, husky, turborepo, fumadocs, ultracite, oxlint, none)
   --examples <types...>           Examples to include (todo, ai, none)
   --git                           Initialize git repository
   --no-git                        Skip git initialization
@@ -193,7 +193,7 @@ npx create-better-t-stack --frontend none --backend hono --api trpc --database n
 - **ORM 'none'**: Can be used when you want to handle database operations manually or use a different ORM.
 - **Runtime 'none'**: Only available with Convex backend or when backend is 'none'.
 - **Cloudflare Workers runtime**: Only compatible with Hono backend, Drizzle ORM (or no ORM), and SQLite database (with D1 setup). Not compatible with MongoDB.
-- **Addons 'none'**: Skips all addons (PWA, Tauri, Starlight, Biome, Husky, Turborepo).
+- **Addons 'none'**: Skips all addons (PWA, Tauri, Starlight, Biome, Lefthook,Husky, Turborepo).
 - **Examples 'none'**: Skips all example implementations (todo, AI chat).
 - **SvelteKit, Nuxt, and SolidJS** frontends are only compatible with oRPC API layer
 - **PWA support** requires React with TanStack Router, React Router, or SolidJS

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -62,6 +62,7 @@ declare const router: {
       tauri: "tauri";
       starlight: "starlight";
       biome: "biome";
+      lefthook: "lefthook";
       husky: "husky";
       ruler: "ruler";
       turborepo: "turborepo";
@@ -142,7 +143,7 @@ declare const router: {
       backend: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self";
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid")[];
-      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
+      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
       examples: ("none" | "todo" | "ai")[];
       auth: "none" | "better-auth" | "clerk";
       payments: "none" | "polar";
@@ -180,7 +181,7 @@ declare const router: {
       backend: "none" | "hono" | "express" | "fastify" | "elysia" | "convex" | "self";
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid")[];
-      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
+      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt")[];
       examples: ("none" | "todo" | "ai")[];
       auth: "none" | "better-auth" | "clerk";
       payments: "none" | "polar";

package/dist/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as create, c as docs, d as sponsors, i as builder, l as generateVirtualProject, n as TEMPLATE_COUNT, o as createBtsCli, r as VirtualFileSystem, s as createVirtual, t as EMBEDDED_TEMPLATES, u as router } from "./src-CSz9J82Z.mjs";
+import { a as create, c as docs, d as sponsors, i as builder, l as generateVirtualProject, n as TEMPLATE_COUNT, o as createBtsCli, r as VirtualFileSystem, s as createVirtual, t as EMBEDDED_TEMPLATES, u as router } from "./src-CGRVv8L3.mjs";
 
 export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };

package/dist/{src-CSz9J82Z.mjs → src-CGRVv8L3.mjs}

@@ -79,6 +79,7 @@ const ADDON_COMPATIBILITY = {
 	],
 	biome: [],
 	husky: [],
+	lefthook: [],
 	turborepo: [],
 	starlight: [],
 	ultracite: [],
@@ -584,6 +585,10 @@ function getAddonDisplay(addon) {
 			label = "Ruler";
 			hint = "Centralize your AI rules";
 			break;
+		case "lefthook":
+			label = "Lefthook";
+			hint = "Fast and powerful Git hooks manager";
+			break;
 		case "husky":
 			label = "Husky";
 			hint = "Modern native Git hooks made easy";
@@ -619,7 +624,8 @@ const ADDON_GROUPS = {
 		"biome",
 		"oxlint",
 		"ultracite",
-		"husky"
+		"husky",
+		"lefthook"
 	],
 	Documentation: ["starlight", "fumadocs"],
 	Extensions: [
@@ -2553,11 +2559,15 @@ const AGENTS = {
 	crush: { label: "Crush" },
 	qwen: { label: "Qwen" },
 	"amazon-q-cli": { label: "Amazon Q CLI" },
-	firebender: { label: "Firebender" }
+	firebender: { label: "Firebender" },
+	"cursor-cli": { label: "Cursor CLI" },
+	"mistral-vibe": { label: "Mistral Vibe" },
+	vercel: { label: "Vercel" }
 };
 const HOOKS = {
 	cursor: { label: "Cursor" },
-	windsurf: { label: "Windsurf" }
+	windsurf: { label: "Windsurf" },
+	claude: { label: "Claude" }
 };
 function getFrameworksFromFrontend(frontend) {
 	const frameworkMap = {
@@ -2576,7 +2586,7 @@ function getFrameworksFromFrontend(frontend) {
 	for (const f of frontend) if (f !== "none" && frameworkMap[f]) frameworks.add(frameworkMap[f]);
 	return Array.from(frameworks);
 }
-async function setupUltracite(config, hasHusky) {
+async function setupUltracite(config, gitHooks) {
 	const { packageManager, projectDir, frontend } = config;
 	try {
 		log.info("Setting up Ultracite...");
@@ -2632,7 +2642,11 @@ async function setupUltracite(config, hasHusky) {
 		if (editors.length > 0) ultraciteArgs.push("--editors", ...editors);
 		if (agents.length > 0) ultraciteArgs.push("--agents", ...agents);
 		if (hooks.length > 0) ultraciteArgs.push("--hooks", ...hooks);
-		if (hasHusky) ultraciteArgs.push("--integrations", "husky", "lint-staged");
+		if (gitHooks.length > 0) {
+			const integrations = [...gitHooks];
+			if (gitHooks.includes("husky")) integrations.push("lint-staged");
+			ultraciteArgs.push("--integrations", ...integrations);
+		}
 		const args = getPackageExecutionArgs(packageManager, `ultracite@latest ${ultraciteArgs.join(" ")} --skip-install`);
 		const s = spinner();
 		s.start("Running Ultracite init command...");
@@ -2722,22 +2736,28 @@ async function setupAddons(config) {
 	const hasUltracite = addons.includes("ultracite");
 	const hasBiome = addons.includes("biome");
 	const hasHusky = addons.includes("husky");
+	const hasLefthook = addons.includes("lefthook");
 	const hasOxlint = addons.includes("oxlint");
-	if (!hasUltracite) {
+	if (hasUltracite) {
+		const gitHooks = [];
+		if (hasHusky) gitHooks.push("husky");
+		if (hasLefthook) gitHooks.push("lefthook");
+		await setupUltracite(config, gitHooks);
+	} else {
 		if (hasBiome) await setupBiome(projectDir);
 		if (hasOxlint) await setupOxlint(projectDir, config.packageManager);
-		if (hasHusky) {
+		if (hasHusky || hasLefthook) {
 			let linter;
 			if (hasOxlint) linter = "oxlint";
 			else if (hasBiome) linter = "biome";
-			await setupHusky(projectDir, linter);
+			if (hasHusky) await setupHusky(projectDir, linter);
+			if (hasLefthook) await setupLefthook(projectDir);
 		}
 	}
 	if (addons.includes("starlight")) await setupStarlight(config);
 	if (addons.includes("fumadocs")) await setupFumadocs(config);
 	if (addons.includes("opentui")) await setupTui(config);
 	if (addons.includes("wxt")) await setupWxt(config);
-	if (hasUltracite) await setupUltracite(config, hasHusky);
 	if (addons.includes("ruler")) await setupRuler(config);
 }
 async function setupBiome(projectDir) {
@@ -2773,6 +2793,12 @@ async function setupHusky(projectDir, linter) {
 		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	}
 }
+async function setupLefthook(projectDir) {
+	await addPackageDependency({
+		devDependencies: ["lefthook"],
+		projectDir
+	});
+}
 
 //#endregion
 //#region src/utils/env-utils.ts
@@ -3851,11 +3877,13 @@ async function displayPostInstallInstructions(config) {
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager === "pnpm" ? "pnpm run" : "bun run";
 	const cdCmd = `cd ${relativePath}`;
 	const hasHusky = addons?.includes("husky");
-	const hasLinting = addons?.includes("biome") || addons?.includes("oxlint");
+	const hasLefthook = addons?.includes("lefthook");
+	const hasGitHooksOrLinting = addons?.includes("husky") || addons?.includes("biome") || addons?.includes("lefthook") || 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 huskyInstructions = hasHusky ? getHuskyInstructions(runCmd) : "";
-	const lintingInstructions = hasLinting ? getLintingInstructions(runCmd) : "";
+	const lefthookInstructions = hasLefthook ? getLefthookInstructions(packageManager) : "";
+	const lintingInstructions = hasGitHooksOrLinting ? getLintingInstructions(runCmd) : "";
 	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) : "";
@@ -3910,6 +3938,7 @@ async function displayPostInstallInstructions(config) {
 	if (databaseInstructions) output += `\n${databaseInstructions.trim()}\n`;
 	if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;
 	if (huskyInstructions) output += `\n${huskyInstructions.trim()}\n`;
+	if (lefthookInstructions) output += `\n${lefthookInstructions.trim()}\n`;
 	if (lintingInstructions) output += `\n${lintingInstructions.trim()}\n`;
 	if (pwaInstructions) output += `\n${pwaInstructions.trim()}\n`;
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
@@ -3938,6 +3967,10 @@ function getHuskyInstructions(runCmd) {
 function getLintingInstructions(runCmd) {
 	return `${pc.bold("Linting and formatting:")}\n${pc.cyan("•")} Format and lint fix: ${`${runCmd} check`}\n`;
 }
+function getLefthookInstructions(packageManager) {
+	const cmd = packageManager === "npm" ? "npx" : packageManager;
+	return `${pc.bold("Git hooks with Lefthook:")}\n${pc.cyan("•")} Install hooks: ${cmd} lefthook install\n`;
+}
 async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup, serverDeploy, _backend) {
 	const instructions = [];
 	if (dbSetup === "docker") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.14.1",
+  "version": "3.15.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.14.1",
-    "@better-t-stack/types": "^3.14.1",
+    "@better-t-stack/template-generator": "^3.15.0",
+    "@better-t-stack/types": "^3.15.0",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.0.0-alpha.8",
     "@orpc/server": "^1.13.0",