create-better-t-stack 3.7.3-canary.8e4d5716 → 3.7.3-canary.fe324be3

package/src/helpers/core/install-dependencies.ts

@@ -1,32 +0,0 @@
-import { spinner } from "@clack/prompts";
-import consola from "consola";
-import { $ } from "execa";
-import pc from "picocolors";
-import type { Addons, PackageManager } from "../../types";
-
-export async function installDependencies({
-  projectDir,
-  packageManager,
-}: {
-  projectDir: string;
-  packageManager: PackageManager;
-  addons?: Addons[];
-}) {
-  const s = spinner();
-
-  try {
-    s.start(`Running ${packageManager} install...`);
-
-    await $({
-      cwd: projectDir,
-      stderr: "inherit",
-    })`${packageManager} install`;
-
-    s.stop("Dependencies installed successfully");
-  } catch (error) {
-    s.stop(pc.red("Failed to install dependencies"));
-    if (error instanceof Error) {
-      consola.error(pc.red(`Installation error: ${error.message}`));
-    }
-  }
-}

package/src/helpers/core/payments-setup.ts

@@ -1,48 +0,0 @@
-import path from "node:path";
-import fs from "fs-extra";
-import type { ProjectConfig } from "../../types";
-import { addPackageDependency } from "../../utils/add-package-deps";
-
-export async function setupPayments(config: ProjectConfig) {
-  const { payments, projectDir, frontend } = config;
-
-  if (!payments || payments === "none") {
-    return;
-  }
-
-  const clientDir = path.join(projectDir, "apps/web");
-  const authDir = path.join(projectDir, "packages/auth");
-
-  const clientDirExists = await fs.pathExists(clientDir);
-  const authDirExists = await fs.pathExists(authDir);
-
-  if (payments === "polar") {
-    if (authDirExists) {
-      await addPackageDependency({
-        dependencies: ["@polar-sh/better-auth", "@polar-sh/sdk"],
-        projectDir: authDir,
-      });
-    }
-
-    if (clientDirExists) {
-      const hasWebFrontend = frontend.some((f) =>
-        [
-          "react-router",
-          "tanstack-router",
-          "tanstack-start",
-          "next",
-          "nuxt",
-          "svelte",
-          "solid",
-        ].includes(f),
-      );
-
-      if (hasWebFrontend) {
-        await addPackageDependency({
-          dependencies: ["@polar-sh/better-auth"],
-          projectDir: clientDir,
-        });
-      }
-    }
-  }
-}

package/src/helpers/core/post-installation.ts

@@ -1,383 +0,0 @@
-import { consola } from "consola";
-import pc from "picocolors";
-import type { Database, DatabaseSetup, ORM, ProjectConfig, Runtime } from "../../types";
-import { getDockerStatus } from "../../utils/docker-utils";
-export async function displayPostInstallInstructions(
-  config: ProjectConfig & { depsInstalled: boolean },
-) {
-  const {
-    api,
-    database,
-    relativePath,
-    packageManager,
-    depsInstalled,
-    orm,
-    addons,
-    runtime,
-    frontend,
-    backend,
-    dbSetup,
-    webDeploy,
-    serverDeploy,
-  } = config;
-
-  const isConvex = backend === "convex";
-  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 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 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)
-    : "";
-  const clerkInstructions = isConvex && config.auth === "clerk" ? getClerkInstructions() : "";
-  const polarInstructions =
-    config.payments === "polar" && config.auth === "better-auth"
-      ? getPolarInstructions(backend)
-      : "";
-  const alchemyDeployInstructions = getAlchemyDeployInstructions(
-    runCmd,
-    webDeploy,
-    serverDeploy,
-    backend,
-  );
-
-  const hasWeb = frontend?.some((f) =>
-    [
-      "tanstack-router",
-      "react-router",
-      "next",
-      "tanstack-start",
-      "nuxt",
-      "svelte",
-      "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";
-
-  let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
-  let stepCounter = 2;
-
-  if (!depsInstalled) {
-    output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
-  }
-
-  if (
-    database === "sqlite" &&
-    dbSetup === "none" &&
-    (serverDeploy === "alchemy" || webDeploy === "alchemy")
-  ) {
-    output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} db:local\n${pc.dim(
-      "   (starts local SQLite server for Workers compatibility)",
-    )}\n`;
-  }
-
-  if (isConvex) {
-    output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev:setup\n${pc.dim(
-      "   (this will guide you through Convex project setup)",
-    )}\n`;
-
-    output += `${pc.cyan(`${stepCounter++}.`)} Copy environment variables from\n${pc.white(
-      "   packages/backend/.env.local",
-    )} to ${pc.white("apps/*/.env")}\n`;
-    output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n\n`;
-  } else if (isBackendSelf) {
-    output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n`;
-  } else {
-    if (runtime !== "workers") {
-      output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n`;
-    }
-
-    if (runtime === "workers") {
-      if (dbSetup === "d1") {
-        output += `${pc.yellow(
-          "IMPORTANT:",
-        )} Complete D1 database setup first\n   (see Database commands below)\n`;
-      }
-      output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev\n`;
-    }
-  }
-
-  const hasStandaloneBackend = backend !== "none";
-  const hasAnyService =
-    hasWeb || hasStandaloneBackend || addons?.includes("starlight") || addons?.includes("fumadocs");
-
-  if (hasAnyService) {
-    output += `${pc.bold("Your project will be available at:")}\n`;
-
-    if (hasWeb) {
-      output += `${pc.cyan("•")} Frontend: http://localhost:${webPort}\n`;
-    } else if (!hasNative && !addons?.includes("starlight")) {
-      output += `${pc.yellow(
-        "NOTE:",
-      )} You are creating a backend-only app\n   (no frontend selected)\n`;
-    }
-
-    if (!isConvex && !isBackendSelf && hasStandaloneBackend) {
-      output += `${pc.cyan("•")} Backend API: http://localhost:3000\n`;
-
-      if (api === "orpc") {
-        output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:3000/api-reference\n`;
-      }
-    }
-
-    if (isBackendSelf && api === "orpc") {
-      output += `${pc.cyan("•")} OpenAPI (Scalar UI): http://localhost:${webPort}/api/rpc/api-reference\n`;
-    }
-
-    if (addons?.includes("starlight")) {
-      output += `${pc.cyan("•")} Docs: http://localhost:4321\n`;
-    }
-
-    if (addons?.includes("fumadocs")) {
-      output += `${pc.cyan("•")} Fumadocs: http://localhost:4000\n`;
-    }
-  }
-
-  if (nativeInstructions) output += `\n${nativeInstructions.trim()}\n`;
-  if (databaseInstructions) output += `\n${databaseInstructions.trim()}\n`;
-  if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;
-  if (lintingInstructions) output += `\n${lintingInstructions.trim()}\n`;
-  if (pwaInstructions) output += `\n${pwaInstructions.trim()}\n`;
-  if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
-  if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
-  if (clerkInstructions) output += `\n${clerkInstructions.trim()}\n`;
-  if (polarInstructions) output += `\n${polarInstructions.trim()}\n`;
-
-  if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
-  if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
-
-  output += `\n${pc.bold(
-    "Like Better-T-Stack?",
-  )} Please consider giving us a star\n   on GitHub:\n`;
-  output += pc.cyan("https://github.com/AmanVarshney01/create-better-t-stack");
-
-  consola.box(output);
-}
-
-function getNativeInstructions(isConvex: boolean, isBackendSelf: boolean, _frontend: string[]) {
-  const envVar = isConvex ? "EXPO_PUBLIC_CONVEX_URL" : "EXPO_PUBLIC_SERVER_URL";
-  const exampleUrl = isConvex
-    ? "https://<YOUR_CONVEX_URL>"
-    : isBackendSelf
-      ? "http://<YOUR_LOCAL_IP>:3001"
-      : "http://<YOUR_LOCAL_IP>:3000";
-  const envFileName = ".env";
-  const ipNote = isConvex
-    ? "your Convex deployment URL (find after running 'dev:setup')"
-    : "your local IP address";
-
-  let instructions = `${pc.yellow(
-    "NOTE:",
-  )} For Expo connectivity issues, update\n   apps/native/${envFileName} with ${ipNote}:\n   ${`${envVar}=${exampleUrl}`}\n`;
-
-  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 getLintingInstructions(runCmd?: string) {
-  return `${pc.bold("Linting and formatting:")}\n${pc.cyan(
-    "•",
-  )} Format and lint fix: ${`${runCmd} check`}\n`;
-}
-
-async function getDatabaseInstructions(
-  database: Database,
-  orm?: ORM,
-  runCmd?: string,
-  _runtime?: Runtime,
-  dbSetup?: DatabaseSetup,
-  serverDeploy?: string,
-  _backend?: string,
-) {
-  const instructions: string[] = [];
-
-  if (dbSetup === "docker") {
-    const dockerStatus = await getDockerStatus(database);
-
-    if (dockerStatus.message) {
-      instructions.push(dockerStatus.message);
-      instructions.push("");
-    }
-  }
-
-  if (dbSetup === "d1" && serverDeploy === "alchemy") {
-    if (orm === "drizzle") {
-      instructions.push(`${pc.cyan("•")} Generate migrations: ${`${runCmd} db:generate`}`);
-    } else if (orm === "prisma") {
-      instructions.push(`${pc.cyan("•")} Generate Prisma client: ${`${runCmd} db:generate`}`);
-      instructions.push(`${pc.cyan("•")} Apply migrations: ${`${runCmd} db:migrate`}`);
-    }
-  }
-
-  if (dbSetup === "planetscale") {
-    if (database === "mysql" && orm === "drizzle") {
-      instructions.push(
-        `${pc.yellow("NOTE:")} Enable foreign key constraints in PlanetScale database settings`,
-      );
-    }
-    if (database === "mysql" && orm === "prisma") {
-      instructions.push(
-        `${pc.yellow(
-          "NOTE:",
-        )} How to handle Prisma migrations with PlanetScale:\n   https://github.com/prisma/prisma/issues/7292`,
-      );
-    }
-  }
-
-  if (dbSetup === "turso" && orm === "prisma") {
-    instructions.push(
-      `${pc.yellow(
-        "NOTE:",
-      )} Follow Turso's Prisma guide for migrations via the Turso CLI:\n   https://docs.turso.tech/sdk/ts/orm/prisma`,
-    );
-  }
-
-  if (orm === "prisma") {
-    if (database === "mongodb" && dbSetup === "docker") {
-      instructions.push(
-        `${pc.yellow("WARNING:")} Prisma + MongoDB + Docker combination\n   may not work.`,
-      );
-    }
-    if (dbSetup === "docker") {
-      instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
-    }
-    if (!(dbSetup === "d1" && serverDeploy === "alchemy")) {
-      instructions.push(`${pc.cyan("•")} Generate Prisma Client: ${`${runCmd} db:generate`}`);
-      instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
-    }
-    if (!(dbSetup === "d1" && serverDeploy === "alchemy")) {
-      instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
-    }
-  } else if (orm === "drizzle") {
-    if (dbSetup === "docker") {
-      instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
-    }
-    if (dbSetup !== "d1") {
-      instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
-    }
-    if (!(dbSetup === "d1" && serverDeploy === "alchemy")) {
-      instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
-    }
-  } else if (orm === "mongoose") {
-    if (dbSetup === "docker") {
-      instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
-    }
-  } else if (orm === "none") {
-    instructions.push(`${pc.yellow("NOTE:")} Manual database schema setup\n   required.`);
-  }
-
-  return instructions.length ? `${pc.bold("Database commands:")}\n${instructions.join("\n")}` : "";
-}
-
-function getTauriInstructions(runCmd?: string) {
-  return `\n${pc.bold("Desktop app with Tauri:")}\n${pc.cyan(
-    "•",
-  )} Start desktop app: ${`cd apps/web && ${runCmd} desktop:dev`}\n${pc.cyan(
-    "•",
-  )} Build desktop app: ${`cd apps/web && ${runCmd} desktop:build`}\n${pc.yellow(
-    "NOTE:",
-  )} Tauri requires Rust and platform-specific dependencies.\n   See: ${"https://v2.tauri.app/start/prerequisites/"}`;
-}
-
-function getPwaInstructions() {
-  return `\n${pc.bold("PWA with React Router v7:")}\n${pc.yellow(
-    "NOTE:",
-  )} There is a known compatibility issue between VitePWA\n   and React Router v7. See:\n   https://github.com/vite-pwa/vite-plugin-pwa/issues/809`;
-}
-
-function getStarlightInstructions(runCmd?: string) {
-  return `\n${pc.bold("Documentation with Starlight:")}\n${pc.cyan(
-    "•",
-  )} Start docs site: ${`cd apps/docs && ${runCmd} dev`}\n${pc.cyan(
-    "•",
-  )} Build docs site: ${`cd apps/docs && ${runCmd} build`}`;
-}
-
-function getNoOrmWarning() {
-  return `\n${pc.yellow(
-    "WARNING:",
-  )} Database selected without an ORM. Features requiring\n   database access (e.g., examples, auth) need manual setup.`;
-}
-
-function getBunWebNativeWarning() {
-  return `\n${pc.yellow(
-    "WARNING:",
-  )} 'bun' might cause issues with web + native apps in a monorepo.\n   Use 'pnpm' if problems arise.`;
-}
-
-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 getPolarInstructions(backend?: string) {
-  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}`;
-}
-
-function getAlchemyDeployInstructions(
-  runCmd?: string,
-  webDeploy?: string,
-  serverDeploy?: string,
-  backend?: string,
-) {
-  const instructions: string[] = [];
-  const isBackendSelf = backend === "self";
-
-  if (webDeploy === "alchemy" && serverDeploy !== "alchemy") {
-    instructions.push(
-      `${pc.bold("Deploy web with Alchemy:")}\n${pc.cyan("•")} Dev: ${`cd apps/web && ${runCmd} alchemy dev`}\n${pc.cyan("•")} Deploy: ${`cd apps/web && ${runCmd} deploy`}\n${pc.cyan("•")} Destroy: ${`cd apps/web && ${runCmd} destroy`}`,
-    );
-  } else if (serverDeploy === "alchemy" && webDeploy !== "alchemy" && !isBackendSelf) {
-    instructions.push(
-      `${pc.bold("Deploy server with Alchemy:")}\n${pc.cyan("•")} Dev: ${`cd apps/server && ${runCmd} dev`}\n${pc.cyan("•")} Deploy: ${`cd apps/server && ${runCmd} deploy`}\n${pc.cyan("•")} Destroy: ${`cd apps/server && ${runCmd} destroy`}`,
-    );
-  } else if (webDeploy === "alchemy" && (serverDeploy === "alchemy" || isBackendSelf)) {
-    instructions.push(
-      `${pc.bold("Deploy with Alchemy:")}\n${pc.cyan("•")} Dev: ${`${runCmd} dev`}\n${pc.cyan("•")} Deploy: ${`${runCmd} deploy`}\n${pc.cyan("•")} Destroy: ${`${runCmd} destroy`}`,
-    );
-  }
-
-  return instructions.length ? `\n${instructions.join("\n")}` : "";
-}