create-better-t-stack 3.9.0 → 3.11.0-pr749.5d055e3

package/README.md

@@ -38,7 +38,7 @@ Follow the prompts to configure your project or use the `--yes` flag for default
 | **Runtime**              | • Bun<br>• Node.js<br>• Cloudflare Workers<br>• None                                                                                                                                                                                                       |
 | **Database**             | • SQLite<br>• PostgreSQL<br>• MySQL<br>• MongoDB<br>• None                                                                                                                                                                                                 |
 | **ORM**                  | • Drizzle (TypeScript-first)<br>• Prisma (feature-rich)<br>• Mongoose (for MongoDB)<br>• None                                                                                                                                                              |
-| **Database Setup**       | • Turso (SQLite)<br>• Cloudflare D1 (SQLite)<br>• Neon (PostgreSQL)<br>• Supabase (PostgreSQL)<br>• Prisma Postgres<br>• MongoDB Atlas<br>• None (manual setup)                                                                    |
+| **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)                                                                           |
@@ -77,6 +77,7 @@ Options:
 ## Telemetry
 
 This CLI collects anonymous usage data to help improve the tool. The data collected includes:
+
 - Configuration options selected
 - CLI version
 - Node.js version

package/bin/create-better-t-stack

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+
+/**
+ * Bin stub for create-better-t-stack.
+ * Finds and runs the platform-specific compiled binary.
+ *
+ * The binary is installed as an optional dependency:
+ *   @better-t-stack/cli-{platform}-{arch}
+ *
+ * This stub searches node_modules for the matching binary package.
+ */
+
+import { spawnSync } from "node:child_process";
+import { existsSync, realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { platform as osPlatform, arch as osArch } from "node:os";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+function run(target) {
+    const result = spawnSync(target, process.argv.slice(2), {
+        stdio: "inherit",
+    });
+    if (result.error) {
+        console.error(result.error.message);
+        process.exit(1);
+    }
+    const code = typeof result.status === "number" ? result.status : 0;
+    process.exit(code);
+}
+
+// Allow override via environment variable
+const envPath = process.env.CREATE_BETTER_T_STACK_BIN_PATH;
+if (envPath) {
+    run(envPath);
+}
+
+const scriptPath = realpathSync(__filename);
+const scriptDir = dirname(scriptPath);
+
+const platformMap = {
+    darwin: "darwin",
+    linux: "linux",
+    win32: "windows",
+};
+
+const archMap = {
+    x64: "x64",
+    arm64: "arm64",
+};
+
+let platform = platformMap[osPlatform()];
+if (!platform) {
+    platform = osPlatform();
+}
+
+let arch = archMap[osArch()];
+if (!arch) {
+    arch = osArch();
+}
+
+// Scoped package name: @better-t-stack/cli-{platform}-{arch}
+const scopedPackage = "@better-t-stack/cli-" + platform + "-" + arch;
+const binary = platform === "windows" ? "create-better-t-stack.exe" : "create-better-t-stack";
+
+function findBinary(startDir) {
+    let current = startDir;
+    for (; ;) {
+        const modules = join(current, "node_modules");
+        if (existsSync(modules)) {
+            // Check for scoped package: node_modules/@better-t-stack/cli-{platform}-{arch}
+            const scopedPath = join(modules, "@better-t-stack", "cli-" + platform + "-" + arch);
+            const candidate = join(scopedPath, "bin", binary);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return;
+        }
+        current = parent;
+    }
+}
+
+const resolved = findBinary(scriptDir);
+
+if (!resolved) {
+    console.error(
+        'No binary found for your platform (' + platform + '-' + arch + ').\n' +
+        'You can try manually installing the "' + scopedPackage + '" package.',
+    );
+    process.exit(1);
+}
+
+run(resolved);

package/package.json

@@ -1,95 +1,91 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.9.0",
+  "version": "3.11.0-pr749.5d055e3",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
-  "type": "module",
-  "license": "MIT",
-  "author": "Aman Varshney",
-  "bin": {
-    "create-better-t-stack": "dist/cli.mjs"
-  },
-  "files": [
-    "templates",
-    "dist"
-  ],
   "keywords": [
+    "better-auth",
     "better-t-stack",
-    "typescript",
+    "biome",
     "boilerplate",
-    "starter",
     "cli",
-    "turborepo",
-    "trpc",
-    "better-auth",
-    "monorepo",
-    "fullstack",
-    "type-safety",
-    "react",
-    "react-native",
+    "drizzle",
+    "elysia",
     "expo",
+    "fullstack",
     "hono",
-    "elysia",
-    "drizzle",
+    "monorepo",
     "prisma",
-    "tanstack",
-    "tailwind",
-    "shadcn",
     "pwa",
+    "react",
+    "react-native",
+    "shadcn",
+    "starter",
+    "tailwind",
+    "tanstack",
     "tauri",
-    "biome"
+    "trpc",
+    "turborepo",
+    "type-safety",
+    "typescript"
   ],
+  "homepage": "https://better-t-stack.dev/",
+  "license": "MIT",
+  "author": "Aman Varshney",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AmanVarshney01/create-better-t-stack.git",
     "directory": "apps/cli"
   },
+  "bin": {
+    "create-better-t-stack": "./bin/create-better-t-stack"
+  },
+  "files": [
+    "bin",
+    "templates",
+    "scripts/postinstall.mjs"
+  ],
+  "type": "module",
   "publishConfig": {
     "access": "public"
   },
-  "homepage": "https://better-t-stack.dev/",
   "scripts": {
-    "build": "tsdown --publint",
-    "dev": "tsdown --watch",
+    "build": "bun run scripts/build.ts",
+    "build:local": "bun run scripts/build.ts --single",
+    "dev": "bun run src/cli.ts",
     "check-types": "tsc --noEmit",
-    "test": "bun run build && bun test",
-    "test:watch": "bun run build && bun test --watch",
-    "test:coverage": "bun run build && bun test --coverage",
-    "test:ci": "bun run build && AGENT=1 bun test --bail=5",
-    "prepublishOnly": "npm run build"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
-    },
-    "./cli": {
-      "import": "./dist/cli.mjs"
-    }
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "test:ci": "AGENT=1 bun test --bail=5",
+    "prepublishOnly": "echo 'Build binaries separately before publishing'",
+    "postinstall": "node ./scripts/postinstall.mjs || true"
   },
   "dependencies": {
-    "@better-t-stack/types": "^3.9.0",
+    "@better-t-stack/types": "3.11.0-pr749.5d055e3",
     "@clack/prompts": "^1.0.0-alpha.8",
-    "@orpc/server": "^1.12.2",
+    "commander": "^14.0.2",
     "consola": "^3.4.2",
-    "execa": "^9.6.1",
-    "fs-extra": "^11.3.2",
+    "fs-extra": "^11.3.3",
     "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",
     "ts-morph": "^27.0.2",
     "yaml": "^2.8.2",
-    "zod": "^4.1.13"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.17",
+    "@types/bun": "^1.3.5",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.10.2",
-    "publint": "^0.3.16",
-    "tsdown": "^0.17.2",
+    "@types/node": "^25.0.3",
     "typescript": "^5.9.3"
+  },
+  "optionalDependencies": {
+    "@better-t-stack/cli-darwin-arm64": "3.11.0",
+    "@better-t-stack/cli-darwin-x64": "3.11.0",
+    "@better-t-stack/cli-linux-arm64": "3.11.0",
+    "@better-t-stack/cli-linux-x64": "3.11.0",
+    "@better-t-stack/cli-windows-x64": "3.11.0"
   }
 }

package/scripts/postinstall.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for create-better-t-stack.
+ * Symlinks the platform-specific binary to the bin directory for convenience.
+ *
+ * This runs after npm install to set up the binary.
+ */
+
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+function detectPlatformAndArch() {
+  let platform;
+  switch (os.platform()) {
+    case "darwin":
+      platform = "darwin";
+      break;
+    case "linux":
+      platform = "linux";
+      break;
+    case "win32":
+      platform = "windows";
+      break;
+    default:
+      platform = os.platform();
+      break;
+  }
+
+  let arch;
+  switch (os.arch()) {
+    case "x64":
+      arch = "x64";
+      break;
+    case "arm64":
+      arch = "arm64";
+      break;
+    default:
+      arch = os.arch();
+      break;
+  }
+
+  return { platform, arch };
+}
+
+function findBinary() {
+  const { platform, arch } = detectPlatformAndArch();
+  // Scoped package: @better-t-stack/cli-{platform}-{arch}
+  const packageName = `@better-t-stack/cli-${platform}-${arch}`;
+  const binaryName = platform === "windows" ? "create-better-t-stack.exe" : "create-better-t-stack";
+
+  try {
+    // Use require.resolve to find the package
+    const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    const packageDir = path.dirname(packageJsonPath);
+    const binaryPath = path.join(packageDir, "bin", binaryName);
+
+    if (!fs.existsSync(binaryPath)) {
+      throw new Error(`Binary not found at ${binaryPath}`);
+    }
+
+    return { binaryPath, binaryName };
+  } catch (error) {
+    throw new Error(`Could not find package ${packageName}: ${error.message}`);
+  }
+}
+
+function prepareBinDirectory(binaryName) {
+  const binDir = path.join(__dirname, "..", "bin");
+  const targetPath = path.join(binDir, binaryName);
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  // Remove existing binary/symlink if it exists
+  try {
+    if (fs.existsSync(targetPath) || fs.lstatSync(targetPath).isSymbolicLink()) {
+      fs.unlinkSync(targetPath);
+    }
+  } catch {
+    // File doesn't exist, that's fine
+  }
+
+  return { binDir, targetPath };
+}
+
+function symlinkBinary(sourcePath, binaryName) {
+  const { targetPath } = prepareBinDirectory(binaryName);
+
+  fs.symlinkSync(sourcePath, targetPath);
+  console.log(`create-better-t-stack binary symlinked: ${targetPath} -> ${sourcePath}`);
+
+  // Verify the file exists after operation
+  if (!fs.existsSync(targetPath)) {
+    throw new Error(`Failed to symlink binary to ${targetPath}`);
+  }
+}
+
+async function main() {
+  try {
+    if (os.platform() === "win32") {
+      // On Windows, symlinks require admin privileges
+      // The bin stub will find the binary directly
+      console.log("Windows detected: skipping symlink (bin stub will find binary directly)");
+      return;
+    }
+
+    const { binaryPath, binaryName } = findBinary();
+    symlinkBinary(binaryPath, binaryName);
+  } catch (error) {
+    // Don't fail the install if we can't symlink - the bin stub will still work
+    console.log(`Note: Could not symlink binary (${error.message}). The CLI will still work.`);
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  // Silently continue - postinstall failures shouldn't break the install
+  console.log("Postinstall completed with warnings.");
+}

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

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

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

@@ -2,19 +2,21 @@ import { createClient, type GenericCtx } from "@convex-dev/better-auth";
 {{#if (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles"))}}
 import { convex } from "@convex-dev/better-auth/plugins";
 import { expo } from "@better-auth/expo";
+{{else if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+import { convex, crossDomain } from "@convex-dev/better-auth/plugins";
 {{else}}
 import { convex } from "@convex-dev/better-auth/plugins";
 {{/if}}
-{{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
-import { crossDomain } from "@convex-dev/better-auth/plugins";
-{{/if}}
 import { components } from "./_generated/api";
 import { DataModel } from "./_generated/dataModel";
 import { query } from "./_generated/server";
 import { betterAuth } from "better-auth";
 import { v } from "convex/values";
+import authConfig from "./auth.config";
 
-{{#if (or (includes frontend "tanstack-start") (includes frontend "next") (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+{{#if (or (includes frontend "tanstack-start") (includes frontend "next"))}}
+const siteUrl = process.env.SITE_URL!;
+{{else if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
 const siteUrl = process.env.SITE_URL!;
 {{/if}}
 {{#if (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles"))}}
@@ -23,23 +25,19 @@ const nativeAppUrl = process.env.NATIVE_APP_URL || "mybettertapp://";
 
 export const authComponent = createClient<DataModel>(components.betterAuth);
 
-function createAuth(
-  ctx: GenericCtx<DataModel>,
-  { optionsOnly }: { optionsOnly?: boolean } = { optionsOnly: false }
-) {
+function createAuth(ctx: GenericCtx<DataModel>) {
   return betterAuth({
-    logger: {
-      disabled: optionsOnly,
-    },
     {{#if (and (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles")) (or (includes frontend "tanstack-start") (includes frontend "next")))}}
     baseURL: siteUrl,
     trustedOrigins: [siteUrl, nativeAppUrl],
+    {{else if (and (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles")) (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid")))}}
+    trustedOrigins: [siteUrl, nativeAppUrl],
     {{else if (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles"))}}
     trustedOrigins: [nativeAppUrl],
     {{else if (or (includes frontend "tanstack-start") (includes frontend "next"))}}
     baseURL: siteUrl,
     trustedOrigins: [siteUrl],
-    {{else}}
+    {{else if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
     trustedOrigins: [siteUrl],
     {{/if}}
     database: authComponent.adapter(ctx),
@@ -50,11 +48,13 @@ function createAuth(
     plugins: [
       {{#if (or (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles"))}}
       expo(),
-      {{/if}}
-      {{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+      {{else if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
       crossDomain({ siteUrl }),
       {{/if}}
-      convex(),
+      convex({
+        authConfig,
+        jwksRotateOnTokenGenerationError: true,
+      }),
     ],
   });
 }
@@ -64,7 +64,7 @@ export { createAuth };
 export const getCurrentUser = query({
   args: {},
   returns: v.any(),
-  handler: async function (ctx, args) {
+  handler: async function (ctx) {
     return authComponent.getAuthUser(ctx);
   },
-});
+});

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

@@ -3,10 +3,10 @@ import { authComponent, createAuth } from "./auth";
 
 const http = httpRouter();
 
-{{#if (or (includes frontend "tanstack-start") (includes frontend "next") (includes frontend "native-bare") (includes frontend "native-uniwind") (includes frontend "native-unistyles"))}}
-authComponent.registerRoutes(http, createAuth);
-{{else}}
+{{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
 authComponent.registerRoutes(http, createAuth, { cors: true });
+{{else}}
+authComponent.registerRoutes(http, createAuth);
 {{/if}}
 
-export default http;
+export default http;

package/templates/auth/better-auth/convex/web/react/next/src/app/api/auth/[...all]/route.ts.hbs

@@ -1,3 +1,3 @@
-import { nextJsHandler } from "@convex-dev/better-auth/nextjs";
+import { handler } from "@/lib/auth-server";
 
-export const { GET, POST } = nextJsHandler();
+export const { GET, POST } = handler;

package/templates/auth/better-auth/convex/web/react/next/src/components/user-menu.tsx.hbs

@@ -1,6 +1,7 @@
 import {
 	DropdownMenu,
 	DropdownMenuContent,
+	DropdownMenuGroup,
 	DropdownMenuItem,
 	DropdownMenuLabel,
 	DropdownMenuSeparator,
@@ -18,17 +19,16 @@ export default function UserMenu() {
 
 	return (
 		<DropdownMenu>
-			<DropdownMenuTrigger asChild>
-				<Button variant="outline">{user?.name}</Button>
+			<DropdownMenuTrigger render={<Button variant="outline" />}>
+				{user?.name}
 			</DropdownMenuTrigger>
 			<DropdownMenuContent className="bg-card">
-				<DropdownMenuLabel>My Account</DropdownMenuLabel>
-				<DropdownMenuSeparator />
-				<DropdownMenuItem>{user?.email}</DropdownMenuItem>
-				<DropdownMenuItem asChild>
-					<Button
+				<DropdownMenuGroup>
+					<DropdownMenuLabel>My Account</DropdownMenuLabel>
+					<DropdownMenuSeparator />
+					<DropdownMenuItem>{user?.email}</DropdownMenuItem>
+					<DropdownMenuItem
 						variant="destructive"
-						className="w-full"
 						onClick={() => {
 							authClient.signOut({
 								fetchOptions: {
@@ -40,8 +40,8 @@ export default function UserMenu() {
 						}}
 					>
 						Sign Out
-					</Button>
-				</DropdownMenuItem>
+					</DropdownMenuItem>
+				</DropdownMenuGroup>
 			</DropdownMenuContent>
 		</DropdownMenu>
 	);

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

@@ -1,6 +1,14 @@
-import { createAuth } from "@{{projectName}}/backend/convex/auth";
-import { getToken as getTokenNextjs } from "@convex-dev/better-auth/nextjs";
+import { convexBetterAuthNextJs } from "@convex-dev/better-auth/nextjs";
 
-export const getToken = () => {
-    return getTokenNextjs(createAuth);
-};
+export const {
+  handler,
+  preloadAuthQuery,
+  isAuthenticated,
+  getToken,
+  fetchAuthQuery,
+  fetchAuthMutation,
+  fetchAuthAction,
+} = convexBetterAuthNextJs({
+  convexUrl: process.env.NEXT_PUBLIC_CONVEX_URL!,
+  convexSiteUrl: process.env.NEXT_PUBLIC_CONVEX_SITE_URL!,
+});

package/templates/auth/better-auth/convex/web/react/tanstack-router/src/components/user-menu.tsx.hbs

@@ -1,34 +1,36 @@
+import { useNavigate } from "@tanstack/react-router";
+
 import {
     DropdownMenu,
     DropdownMenuContent,
+    DropdownMenuGroup,
     DropdownMenuItem,
     DropdownMenuLabel,
     DropdownMenuSeparator,
     DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { authClient } from "@/lib/auth-client";
-import { useNavigate } from "@tanstack/react-router";
-import { Button } from "./ui/button";
 import { useQuery } from "convex/react";
 import { api } from "@{{projectName}}/backend/convex/_generated/api";
 
+import { Button } from "./ui/button";
+
 export default function UserMenu() {
     const navigate = useNavigate();
     const user = useQuery(api.auth.getCurrentUser)
 
     return (
         <DropdownMenu>
-            <DropdownMenuTrigger asChild>
-                <Button variant="outline">{user?.name}</Button>
+            <DropdownMenuTrigger render={<Button variant="outline" />}>
+                {user?.name}
             </DropdownMenuTrigger>
             <DropdownMenuContent className="bg-card">
-                <DropdownMenuLabel>My Account</DropdownMenuLabel>
-                <DropdownMenuSeparator />
-                <DropdownMenuItem>{user?.email}</DropdownMenuItem>
-                <DropdownMenuItem asChild>
-                    <Button
+                <DropdownMenuGroup>
+                    <DropdownMenuLabel>My Account</DropdownMenuLabel>
+                    <DropdownMenuSeparator />
+                    <DropdownMenuItem>{user?.email}</DropdownMenuItem>
+                    <DropdownMenuItem
                         variant="destructive"
-                        className="w-full"
                         onClick={() => {
                             authClient.signOut({
                                 fetchOptions: {
@@ -42,8 +44,8 @@ export default function UserMenu() {
                         }}
                     >
                         Sign Out
-                    </Button>
-                </DropdownMenuItem>
+                    </DropdownMenuItem>
+                </DropdownMenuGroup>
             </DropdownMenuContent>
         </DropdownMenu>
     );