create-better-t-stack 3.7.3-canary.7cbb05fc → 3.7.3-canary.8e4d5716

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.7.3-canary.7cbb05fc",
+  "version": "3.7.3-canary.8e4d5716",
   "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"
+    "create-better-t-stack": "src/cli.ts"
   },
   "files": [
     "templates",
-    "dist"
+    "src"
   ],
   "keywords": [
     "better-t-stack",
@@ -48,48 +48,44 @@
   },
   "homepage": "https://better-t-stack.dev/",
   "scripts": {
-    "build": "tsdown --publint",
-    "dev": "tsdown --watch",
     "check-types": "tsc --noEmit",
     "test": "bun run build && vitest run; rm -rf .smoke || true",
-    "test:ui": "bun run build && vitest --ui",
-    "prepublishOnly": "npm run build"
+    "test:ui": "bun run build && vitest --ui"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
+      "import": "./src/index.ts"
     },
     "./cli": {
-      "import": "./dist/cli.mjs"
+      "import": "./src/cli.ts"
     }
   },
   "dependencies": {
-    "@better-t-stack/types": "3.7.3-canary.7cbb05fc",
-    "@biomejs/js-api": "^4.0.0",
-    "@biomejs/wasm-nodejs": "^2.3.8",
-    "@clack/prompts": "^1.0.0-alpha.8",
-    "@orpc/server": "^1.12.2",
+    "@biomejs/js-api": "^3.0.0",
+    "@biomejs/wasm-nodejs": "^2.2.6",
+    "@clack/prompts": "^1.0.0-alpha.6",
+    "@orpc/server": "^1.10.0",
     "consola": "^3.4.2",
-    "execa": "^9.6.1",
+    "execa": "^9.6.0",
     "fs-extra": "^11.3.2",
     "gradient-string": "^3.0.0",
     "handlebars": "^4.7.8",
     "jsonc-parser": "^3.3.1",
     "picocolors": "^1.1.1",
     "tinyglobby": "^0.2.15",
-    "trpc-cli": "^0.12.1",
+    "trpc-cli": "^0.12.0",
     "ts-morph": "^27.0.2",
-    "yaml": "^2.8.2",
+    "yaml": "^2.8.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {
+    "@create-better-t-stack/types": "1.0.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.10.2",
-    "@vitest/ui": "^4.0.15",
-    "publint": "^0.3.16",
-    "tsdown": "^0.17.2",
+    "@types/node": "^24.9.1",
+    "@vitest/ui": "^3.2.4",
+    "publint": "^0.3.15",
+    "tsdown": "^0.15.9",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "vitest": "^3.2.4"
   }
 }

package/src/cli.ts

@@ -0,0 +1,3 @@
+import { createBtsCli } from "./index";
+
+createBtsCli().run();

package/src/constants.ts

@@ -0,0 +1,188 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { getUserPkgManager } from "./utils/get-package-manager";
+
+const __filename = fileURLToPath(import.meta.url);
+const distPath = path.dirname(__filename);
+export const PKG_ROOT = path.join(distPath, "../");
+
+export const DEFAULT_CONFIG_BASE = {
+  projectName: "my-better-t-app",
+  relativePath: "my-better-t-app",
+  frontend: ["tanstack-router"],
+  database: "sqlite",
+  orm: "drizzle",
+  auth: "better-auth",
+  payments: "none",
+  addons: ["turborepo"],
+  examples: [],
+  git: true,
+  install: true,
+  dbSetup: "none",
+  backend: "hono",
+  runtime: "bun",
+  api: "trpc",
+  webDeploy: "none",
+  serverDeploy: "none",
+} as const;
+
+export function getDefaultConfig() {
+  return {
+    ...DEFAULT_CONFIG_BASE,
+    projectDir: path.resolve(process.cwd(), DEFAULT_CONFIG_BASE.projectName),
+    packageManager: getUserPkgManager(),
+    frontend: [...DEFAULT_CONFIG_BASE.frontend],
+    addons: [...DEFAULT_CONFIG_BASE.addons],
+    examples: [...DEFAULT_CONFIG_BASE.examples],
+  };
+}
+
+export const DEFAULT_CONFIG = getDefaultConfig();
+
+export const dependencyVersionMap = {
+  typescript: "^5",
+
+  "better-auth": "^1.4.5",
+  "@better-auth/expo": "^1.4.5",
+
+  "@clerk/nextjs": "^6.31.5",
+  "@clerk/clerk-react": "^5.45.0",
+  "@clerk/tanstack-react-start": "^0.26.3",
+  "@clerk/clerk-expo": "^2.14.25",
+
+  "drizzle-orm": "^0.45.0",
+  "drizzle-kit": "^0.31.8",
+  "@planetscale/database": "^1.19.0",
+
+  "@libsql/client": "^0.14.0",
+  libsql: "^0.5.22",
+
+  "@neondatabase/serverless": "^1.0.2",
+  pg: "^8.16.3",
+  "@types/pg": "^8.15.6",
+  "@types/ws": "^8.18.1",
+  ws: "^8.18.3",
+
+  mysql2: "^3.14.0",
+
+  "@prisma/client": "^7.0.1",
+  prisma: "^7.0.1",
+  "@prisma/adapter-d1": "^7.0.1",
+  "@prisma/adapter-neon": "^7.0.1",
+  "@prisma/adapter-mariadb": "^7.0.1",
+  "@prisma/adapter-libsql": "^7.0.1",
+  "@prisma/adapter-better-sqlite3": "^7.0.1",
+  "@prisma/adapter-pg": "^7.0.1",
+  "@prisma/adapter-planetscale": "^7.0.1",
+
+  mongoose: "^8.14.0",
+
+  "vite-plugin-pwa": "^1.0.1",
+  "@vite-pwa/assets-generator": "^1.0.0",
+
+  "@tauri-apps/cli": "^2.4.0",
+
+  "@biomejs/biome": "^2.2.0",
+  oxlint: "^1.12.0",
+
+  husky: "^9.1.7",
+  "lint-staged": "^16.1.2",
+
+  tsx: "^4.19.2",
+  "@types/node": "^22.13.11",
+
+  "@types/bun": "^1.3.4",
+
+  "@elysiajs/node": "^1.3.1",
+
+  "@elysiajs/cors": "^1.3.3",
+  "@elysiajs/trpc": "^1.1.0",
+  elysia: "^1.3.21",
+
+  "@hono/node-server": "^1.14.4",
+  "@hono/trpc-server": "^0.4.0",
+  hono: "^4.8.2",
+
+  cors: "^2.8.5",
+  express: "^5.1.0",
+  "@types/express": "^5.0.1",
+  "@types/cors": "^2.8.17",
+
+  fastify: "^5.3.3",
+  "@fastify/cors": "^11.0.1",
+
+  turbo: "^2.5.4",
+
+  ai: "^5.0.49",
+  "@ai-sdk/google": "^2.0.13",
+  "@ai-sdk/vue": "^2.0.49",
+  "@ai-sdk/svelte": "^3.0.39",
+  "@ai-sdk/react": "^2.0.39",
+  streamdown: "^1.3.0",
+  shiki: "^3.12.2",
+
+  "@orpc/server": "^1.10.0",
+  "@orpc/client": "^1.10.0",
+  "@orpc/openapi": "^1.10.0",
+  "@orpc/zod": "^1.10.0",
+  "@orpc/tanstack-query": "^1.10.0",
+
+  "@trpc/tanstack-react-query": "^11.5.0",
+  "@trpc/server": "^11.5.0",
+  "@trpc/client": "^11.5.0",
+
+  next: "^16.0.7",
+
+  convex: "^1.29.3",
+  "@convex-dev/react-query": "^0.1.0",
+  "convex-svelte": "^0.0.12",
+  "convex-nuxt": "0.1.5",
+  "convex-vue": "^0.1.5",
+  "@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",
+  "@tanstack/vue-query": "^5.90.2",
+
+  "@tanstack/react-query-devtools": "^5.85.5",
+  "@tanstack/react-query": "^5.85.5",
+
+  "@tanstack/solid-query": "^5.87.4",
+  "@tanstack/solid-query-devtools": "^5.87.4",
+  "@tanstack/solid-router-devtools": "^1.131.44",
+
+  wrangler: "^4.40.3",
+  "@cloudflare/vite-plugin": "^1.13.8",
+  "@opennextjs/cloudflare": "^1.6.5",
+  "nitro-cloudflare-dev": "^0.2.2",
+  "@sveltejs/adapter-cloudflare": "^7.2.1",
+  "@cloudflare/workers-types": "^4.20250822.0",
+
+  alchemy: "^0.77.0",
+
+  dotenv: "^17.2.2",
+  tsdown: "^0.16.5",
+  zod: "^4.1.13",
+  srvx: "0.8.15",
+
+  "@polar-sh/better-auth": "^1.1.3",
+  "@polar-sh/sdk": "^0.34.16",
+} as const;
+
+export type AvailableDependencies = keyof typeof dependencyVersionMap;
+
+export const ADDON_COMPATIBILITY = {
+  pwa: ["tanstack-router", "react-router", "solid", "next"],
+  tauri: ["tanstack-router", "react-router", "nuxt", "svelte", "solid", "next"],
+  biome: [],
+  husky: [],
+  turborepo: [],
+  starlight: [],
+  ultracite: [],
+  ruler: [],
+  oxlint: [],
+  fumadocs: [],
+  none: [],
+} as const;

package/src/helpers/addons/addons-setup.ts

@@ -0,0 +1,226 @@
+import path from "node:path";
+import { log, spinner } from "@clack/prompts";
+import { execa } from "execa";
+import fs from "fs-extra";
+import pc from "picocolors";
+import type { Frontend, PackageManager, ProjectConfig } from "../../types";
+import { addPackageDependency } from "../../utils/add-package-deps";
+import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { setupFumadocs } from "./fumadocs-setup";
+import { setupRuler } from "./ruler-setup";
+import { setupStarlight } from "./starlight-setup";
+import { setupTauri } from "./tauri-setup";
+import { setupUltracite } from "./ultracite-setup";
+import { addPwaToViteConfig } from "./vite-pwa-setup";
+
+export async function setupAddons(config: ProjectConfig, isAddCommand = false) {
+  const { addons, frontend, projectDir, packageManager } = config;
+  const hasReactWebFrontend =
+    frontend.includes("react-router") ||
+    frontend.includes("tanstack-router") ||
+    frontend.includes("next");
+  const hasNuxtFrontend = frontend.includes("nuxt");
+  const hasSvelteFrontend = frontend.includes("svelte");
+  const hasSolidFrontend = frontend.includes("solid");
+  const hasNextFrontend = frontend.includes("next");
+
+  if (addons.includes("turborepo")) {
+    await addPackageDependency({
+      devDependencies: ["turbo"],
+      projectDir,
+    });
+
+    if (isAddCommand) {
+      log.info(`${pc.yellow("Update your package.json scripts:")}
+
+${pc.dim("Replace:")} ${pc.yellow('"pnpm -r dev"')} ${pc.dim("→")} ${pc.green('"turbo dev"')}
+${pc.dim("Replace:")} ${pc.yellow('"pnpm --filter web dev"')} ${pc.dim(
+        "→",
+      )} ${pc.green('"turbo -F web dev"')}
+
+${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
+		`);
+    }
+  }
+
+  if (addons.includes("pwa") && (hasReactWebFrontend || hasSolidFrontend)) {
+    await setupPwa(projectDir, frontend);
+  }
+  if (
+    addons.includes("tauri") &&
+    (hasReactWebFrontend ||
+      hasNuxtFrontend ||
+      hasSvelteFrontend ||
+      hasSolidFrontend ||
+      hasNextFrontend)
+  ) {
+    await setupTauri(config);
+  }
+  const hasUltracite = addons.includes("ultracite");
+  const hasBiome = addons.includes("biome");
+  const hasHusky = addons.includes("husky");
+  const hasOxlint = addons.includes("oxlint");
+
+  if (hasUltracite) {
+    await setupUltracite(config, hasHusky);
+  } else {
+    if (hasBiome) {
+      await setupBiome(projectDir);
+    }
+    if (hasHusky) {
+      let linter: "biome" | "oxlint" | undefined;
+      if (hasOxlint) {
+        linter = "oxlint";
+      } else if (hasBiome) {
+        linter = "biome";
+      }
+      await setupHusky(projectDir, linter);
+    }
+  }
+
+  if (addons.includes("oxlint")) {
+    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);
+  }
+}
+
+function getWebAppDir(projectDir: string, frontends: Frontend[]) {
+  if (
+    frontends.some((f) =>
+      ["react-router", "tanstack-router", "nuxt", "svelte", "solid"].includes(f),
+    )
+  ) {
+    return path.join(projectDir, "apps/web");
+  }
+  return path.join(projectDir, "apps/web");
+}
+
+export async function setupBiome(projectDir: string) {
+  await addPackageDependency({
+    devDependencies: ["@biomejs/biome"],
+    projectDir,
+  });
+
+  const packageJsonPath = path.join(projectDir, "package.json");
+  if (await fs.pathExists(packageJsonPath)) {
+    const packageJson = await fs.readJson(packageJsonPath);
+
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      check: "biome check --write .",
+    };
+
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+  }
+}
+
+export async function setupHusky(projectDir: string, linter?: "biome" | "oxlint") {
+  await addPackageDependency({
+    devDependencies: ["husky", "lint-staged"],
+    projectDir,
+  });
+
+  const packageJsonPath = path.join(projectDir, "package.json");
+  if (await fs.pathExists(packageJsonPath)) {
+    const packageJson = await fs.readJson(packageJsonPath);
+
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      prepare: "husky",
+    };
+
+    if (linter === "oxlint") {
+      packageJson["lint-staged"] = {
+        "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "oxlint",
+      };
+    } 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 });
+  }
+}
+
+async function setupPwa(projectDir: string, frontends: Frontend[]) {
+  const isCompatibleFrontend = frontends.some((f) =>
+    ["react-router", "tanstack-router", "solid"].includes(f),
+  );
+  if (!isCompatibleFrontend) return;
+
+  const clientPackageDir = getWebAppDir(projectDir, frontends);
+
+  if (!(await fs.pathExists(clientPackageDir))) {
+    return;
+  }
+
+  await addPackageDependency({
+    dependencies: ["vite-plugin-pwa"],
+    devDependencies: ["@vite-pwa/assets-generator"],
+    projectDir: clientPackageDir,
+  });
+
+  const clientPackageJsonPath = path.join(clientPackageDir, "package.json");
+  if (await fs.pathExists(clientPackageJsonPath)) {
+    const packageJson = await fs.readJson(clientPackageJsonPath);
+
+    packageJson.scripts = {
+      ...packageJson.scripts,
+      "generate-pwa-assets": "pwa-assets-generator",
+    };
+
+    await fs.writeJson(clientPackageJsonPath, packageJson, { spaces: 2 });
+  }
+
+  const viteConfigTs = path.join(clientPackageDir, "vite.config.ts");
+
+  if (await fs.pathExists(viteConfigTs)) {
+    await addPwaToViteConfig(viteConfigTs, path.basename(projectDir));
+  }
+}
+
+async function setupOxlint(projectDir: string, packageManager: 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!");
+}

package/src/helpers/addons/examples-setup.ts

@@ -0,0 +1,104 @@
+import path from "node:path";
+import fs from "fs-extra";
+import type { AvailableDependencies } from "../../constants";
+import type { ProjectConfig } from "../../types";
+import { addPackageDependency } from "../../utils/add-package-deps";
+
+export async function setupExamples(config: ProjectConfig) {
+  const { examples, frontend, backend, projectDir, orm, database } = config;
+
+  if (backend === "convex" || !examples || examples.length === 0 || examples[0] === "none") {
+    return;
+  }
+
+  const apiDir = path.join(projectDir, "packages/api");
+  const apiDirExists = await fs.pathExists(apiDir);
+
+  if (apiDirExists && backend !== "none") {
+    if (orm === "drizzle") {
+      const dependencies: AvailableDependencies[] = ["drizzle-orm"];
+      if (database === "postgres") {
+        // Workaround: not sure there is a weird types error if i add it in dev dep
+        dependencies.push("@types/pg");
+      }
+      await addPackageDependency({
+        dependencies,
+        projectDir: apiDir,
+      });
+    } else if (orm === "prisma") {
+      await addPackageDependency({
+        dependencies: ["@prisma/client"],
+        projectDir: apiDir,
+      });
+    } else if (orm === "mongoose") {
+      await addPackageDependency({
+        dependencies: ["mongoose"],
+        projectDir: apiDir,
+      });
+    }
+  }
+
+  if (examples.includes("ai")) {
+    const webClientDir = path.join(projectDir, "apps/web");
+    const nativeClientDir = path.join(projectDir, "apps/native");
+    const apiDir = path.join(projectDir, "packages/api");
+
+    const webClientDirExists = await fs.pathExists(webClientDir);
+    const nativeClientDirExists = await fs.pathExists(nativeClientDir);
+    const apiDirExists = await fs.pathExists(apiDir);
+
+    const hasNuxt = frontend.includes("nuxt");
+    const hasSvelte = frontend.includes("svelte");
+    const hasReactWeb =
+      frontend.includes("react-router") ||
+      frontend.includes("tanstack-router") ||
+      frontend.includes("next") ||
+      frontend.includes("tanstack-start");
+    const hasNext = frontend.includes("next");
+    const hasReactNative =
+      frontend.includes("native-bare") ||
+      frontend.includes("native-uniwind") ||
+      frontend.includes("native-unistyles");
+
+    if (webClientDirExists) {
+      const dependencies: AvailableDependencies[] = ["ai"];
+      if (hasNuxt) {
+        dependencies.push("@ai-sdk/vue");
+      } else if (hasSvelte) {
+        dependencies.push("@ai-sdk/svelte");
+      } else if (hasReactWeb) {
+        dependencies.push("@ai-sdk/react", "streamdown");
+      }
+
+      if (hasNext) {
+        dependencies.push("shiki");
+      }
+
+      await addPackageDependency({
+        dependencies,
+        projectDir: webClientDir,
+      });
+    }
+
+    if (nativeClientDirExists && hasReactNative) {
+      await addPackageDependency({
+        dependencies: ["ai", "@ai-sdk/react"],
+        projectDir: nativeClientDir,
+      });
+    }
+
+    if (apiDirExists && backend !== "none") {
+      await addPackageDependency({
+        dependencies: ["ai", "@ai-sdk/google"],
+        projectDir: apiDir,
+      });
+    }
+
+    if (backend === "self" && webClientDirExists) {
+      await addPackageDependency({
+        dependencies: ["ai", "@ai-sdk/google"],
+        projectDir: webClientDir,
+      });
+    }
+  }
+}