create-better-fullstack 1.5.2 → 1.5.3

package/dist/{addons-setup-1jZXP0D3.mjs → addons-setup-Bll5VFJd.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { s as dependencyVersionMap, t as readBtsConfig } from "./bts-config-BCe8SqYV.mjs";
+import { s as dependencyVersionMap, t as readBtsConfig } from "./bts-config-BYD8mHt-.mjs";
 import { autocompleteMultiselect, cancel, group, isCancel, log, multiselect, select, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";
@@ -255,6 +255,35 @@ function shouldSkipExternalCommands() {
 	return normalized === "1" || normalized === "true" || normalized === "yes";
 }
 
+//#endregion
+//#region src/helpers/addons/retry-install.ts
+const DEFAULT_MAX_ATTEMPTS = 3;
+const DEFAULT_INITIAL_DELAY_MS = 750;
+const RETRY_BACKOFF_MULTIPLIER = 2;
+function defaultSleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function formatDelay(ms) {
+	return ms >= 1e3 ? `${(ms / 1e3).toFixed(ms % 1e3 === 0 ? 0 : 1)}s` : `${ms}ms`;
+}
+async function runInstallWithRetries({ description, run, maxAttempts = DEFAULT_MAX_ATTEMPTS, initialDelayMs = DEFAULT_INITIAL_DELAY_MS, sleep = defaultSleep }) {
+	let delayMs = initialDelayMs;
+	for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
+		await run();
+		return true;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		if (attempt === maxAttempts) {
+			log.warn(pc.yellow(`Warning: Could not ${description} after ${maxAttempts} attempts: ${message}`));
+			return false;
+		}
+		log.warn(pc.yellow(`Warning: Failed to ${description} (attempt ${attempt}/${maxAttempts}): ${message}. Retrying in ${formatDelay(delayMs)}...`));
+		await sleep(delayMs);
+		delayMs *= RETRY_BACKOFF_MULTIPLIER;
+	}
+	return false;
+}
+
 //#endregion
 //#region src/helpers/addons/mcp-setup.ts
 const MCP_AGENTS = [
@@ -489,14 +518,15 @@ async function setupMcp(config) {
 			...globalFlags,
 			"-y"
 		];
-		try {
-			await $({
-				cwd: projectDir,
-				env: { CI: "true" }
-			})`${args}`;
-		} catch (error) {
-			log.warn(pc.yellow(`Warning: Could not install MCP server '${server.name}': ${error instanceof Error ? error.message : String(error)}`));
-		}
+		await runInstallWithRetries({
+			description: `install MCP server '${server.name}'`,
+			run: async () => {
+				await $({
+					cwd: projectDir,
+					env: { CI: "true" }
+				})`${args}`;
+			}
+		});
 	}
 	installSpinner.stop("MCP servers installed");
 }
@@ -912,14 +942,15 @@ async function setupSkills(config) {
 			...agentFlags,
 			"-y"
 		];
-		try {
-			await $({
-				cwd: projectDir,
-				env: { CI: "true" }
-			})`${args}`;
-		} catch (error) {
-			log.warn(pc.yellow(`Warning: Could not install skills from ${source}: ${error instanceof Error ? error.message : String(error)}`));
-		}
+		await runInstallWithRetries({
+			description: `install skills from ${source}`,
+			run: async () => {
+				await $({
+					cwd: projectDir,
+					env: { CI: "true" }
+				})`${args}`;
+			}
+		});
 	}
 	installSpinner.stop("Skills installed");
 }

package/dist/addons-setup-CWGwxN68.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import "./bts-config-BYD8mHt-.mjs";
+import { i as setupLefthook, n as setupBiome, r as setupHusky, t as setupAddons } from "./addons-setup-Bll5VFJd.mjs";
+
+export { setupAddons };

package/dist/{bts-config-BCe8SqYV.mjs → bts-config-BYD8mHt-.mjs}

@@ -72,6 +72,7 @@ const DEFAULT_CONFIG_BASE = {
 	rustApi: "none",
 	rustCli: "none",
 	rustLibraries: [],
+	rustLogging: "tracing",
 	pythonWebFramework: "fastapi",
 	pythonOrm: "sqlalchemy",
 	pythonValidation: "pydantic",
@@ -181,6 +182,7 @@ async function writeBtsConfig(projectConfig) {
 		rustApi: projectConfig.rustApi,
 		rustCli: projectConfig.rustCli,
 		rustLibraries: projectConfig.rustLibraries,
+		rustLogging: projectConfig.rustLogging,
 		pythonWebFramework: projectConfig.pythonWebFramework,
 		pythonOrm: projectConfig.pythonOrm,
 		pythonValidation: projectConfig.pythonValidation,
@@ -241,6 +243,7 @@ async function writeBtsConfig(projectConfig) {
 		rustApi: btsConfig.rustApi,
 		rustCli: btsConfig.rustCli,
 		rustLibraries: btsConfig.rustLibraries,
+		rustLogging: btsConfig.rustLogging,
 		pythonWebFramework: btsConfig.pythonWebFramework,
 		pythonOrm: btsConfig.pythonOrm,
 		pythonValidation: btsConfig.pythonValidation,

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 //#region src/cli.ts
-if (process.argv[2] === "mcp" && process.argv.length === 3) import("./mcp-C_X1WfCg.mjs").then((m) => m.startMcpServer());
+if (process.argv[2] === "mcp" && process.argv.length === 3) import("./mcp-CRjipp-w.mjs").then((m) => m.startMcpServer());
 else import("./index.mjs").then((m) => m.createBtsCli().run());
 
 //#endregion

package/dist/index.d.mts

@@ -30,6 +30,7 @@ declare const router: {
     yes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     yolo: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     ecosystem: z.ZodOptional<z.ZodEnum<{
       typescript: "typescript";
       rust: "rust";
@@ -208,6 +209,7 @@ declare const router: {
       meilisearch: "meilisearch";
       typesense: "typesense";
       elasticsearch: "elasticsearch";
+      algolia: "algolia";
     }>>;
     fileStorage: z.ZodOptional<z.ZodEnum<{
       none: "none";
@@ -472,10 +474,16 @@ declare const router: {
       "tokio-test": "tokio-test";
       mockall: "mockall";
     }>>>;
+    rustLogging: z.ZodOptional<z.ZodEnum<{
+      none: "none";
+      tracing: "tracing";
+      "env-logger": "env-logger";
+    }>>;
     pythonWebFramework: z.ZodOptional<z.ZodEnum<{
       none: "none";
       fastapi: "fastapi";
       django: "django";
+      flask: "flask";
     }>>;
     pythonOrm: z.ZodOptional<z.ZodEnum<{
       none: "none";
@@ -507,6 +515,7 @@ declare const router: {
       none: "none";
       gin: "gin";
       echo: "echo";
+      fiber: "fiber";
     }>>;
     goOrm: z.ZodOptional<z.ZodEnum<{
       none: "none";
@@ -575,7 +584,90 @@ declare const router: {
       analytics: "none" | "plausible" | "umami";
       cms: "none" | "payload" | "sanity" | "strapi" | "tinacms";
       caching: "none" | "upstash-redis";
-      search: "none" | "meilisearch" | "typesense" | "elasticsearch";
+      search: "none" | "meilisearch" | "typesense" | "elasticsearch" | "algolia";
+      fileStorage: "none" | "s3" | "r2";
+      rustWebFramework: "none" | "axum" | "actix-web";
+      rustFrontend: "none" | "leptos" | "dioxus";
+      rustOrm: "none" | "sea-orm" | "sqlx";
+      rustApi: "none" | "tonic" | "async-graphql";
+      rustCli: "none" | "clap" | "ratatui";
+      rustLibraries: ("none" | "serde" | "validator" | "jsonwebtoken" | "argon2" | "tokio-test" | "mockall")[];
+      rustLogging: "none" | "tracing" | "env-logger";
+      pythonWebFramework: "none" | "fastapi" | "django" | "flask";
+      pythonOrm: "none" | "sqlalchemy" | "sqlmodel";
+      pythonValidation: "none" | "pydantic";
+      pythonAi: ("none" | "langgraph" | "langchain" | "llamaindex" | "openai-sdk" | "anthropic-sdk" | "crewai")[];
+      pythonTaskQueue: "none" | "celery";
+      pythonQuality: "none" | "ruff";
+      goWebFramework: "none" | "gin" | "echo" | "fiber";
+      goOrm: "none" | "gorm" | "sqlc";
+      goApi: "none" | "grpc-go";
+      goCli: "none" | "cobra" | "bubbletea";
+      goLogging: "none" | "zap";
+      aiDocs: ("none" | "claude-md" | "agents-md" | "cursorrules")[];
+      astroIntegration?: "none" | "svelte" | "solid" | "react" | "vue" | undefined;
+      shadcnBase?: "radix" | "base" | undefined;
+      shadcnStyle?: "vega" | "nova" | "maia" | "lyra" | "mira" | undefined;
+      shadcnIconLibrary?: "lucide" | "tabler" | "hugeicons" | "phosphor" | "remixicon" | undefined;
+      shadcnColorTheme?: "neutral" | "stone" | "zinc" | "gray" | "amber" | "blue" | "cyan" | "emerald" | "fuchsia" | "green" | "indigo" | "lime" | "orange" | "pink" | "purple" | "red" | "rose" | "sky" | "teal" | "violet" | "yellow" | undefined;
+      shadcnBaseColor?: "neutral" | "stone" | "zinc" | "gray" | undefined;
+      shadcnFont?: "inter" | "geist" | "noto-sans" | "nunito-sans" | "figtree" | "roboto" | "raleway" | "dm-sans" | "public-sans" | "outfit" | "jetbrains-mono" | "geist-mono" | undefined;
+      shadcnRadius?: "default" | "none" | "small" | "medium" | "large" | undefined;
+    };
+    reproducibleCommand: string;
+    timeScaffolded: string;
+    elapsedTimeMs: number;
+    projectDirectory: string;
+    relativePath: string;
+    dryRun: boolean;
+    fileCount: number;
+    directoryCount: number;
+    files: string[];
+    error?: undefined;
+  } | {
+    success: boolean;
+    projectConfig: {
+      projectName: string;
+      projectDir: string;
+      relativePath: string;
+      ecosystem: "typescript" | "rust" | "python" | "go";
+      database: "none" | "sqlite" | "postgres" | "mysql" | "mongodb" | "edgedb" | "redis";
+      orm: "none" | "drizzle" | "prisma" | "mongoose" | "typeorm" | "kysely" | "mikroorm" | "sequelize";
+      backend: "none" | "hono" | "express" | "fastify" | "elysia" | "fets" | "nestjs" | "adonisjs" | "nitro" | "encore" | "convex" | "self";
+      runtime: "none" | "bun" | "node" | "workers";
+      frontend: ("none" | "tanstack-router" | "react-router" | "react-vite" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "solid-start" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
+      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "mcp" | "skills" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook" | "tanstack-query" | "tanstack-table" | "tanstack-virtual" | "tanstack-db" | "tanstack-pacer")[];
+      examples: ("ai" | "none" | "chat-sdk" | "tanstack-showcase")[];
+      auth: "none" | "better-auth" | "go-better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
+      payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
+      git: boolean;
+      packageManager: "bun" | "npm" | "pnpm" | "yarn";
+      versionChannel: "stable" | "latest" | "beta";
+      install: boolean;
+      dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "upstash" | "d1" | "docker";
+      api: "none" | "trpc" | "orpc" | "ts-rest" | "garph";
+      webDeploy: "none" | "docker" | "cloudflare" | "fly" | "railway" | "sst";
+      serverDeploy: "none" | "docker" | "cloudflare" | "fly" | "railway" | "sst";
+      ai: "none" | "langgraph" | "langchain" | "llamaindex" | "vercel-ai" | "mastra" | "voltagent" | "openai-agents" | "google-adk" | "modelfusion" | "tanstack-ai";
+      effect: "effect" | "none" | "effect-full";
+      stateManagement: "none" | "zustand" | "jotai" | "nanostores" | "redux-toolkit" | "mobx" | "xstate" | "valtio" | "tanstack-store" | "legend-state";
+      forms: "none" | "tanstack-form" | "react-hook-form" | "formik" | "final-form" | "conform" | "modular-forms";
+      testing: "none" | "vitest" | "playwright" | "vitest-playwright" | "jest" | "cypress";
+      email: "none" | "react-email" | "resend" | "nodemailer" | "postmark" | "sendgrid" | "aws-ses" | "mailgun" | "plunk";
+      cssFramework: "none" | "tailwind" | "scss" | "less" | "postcss-only";
+      uiLibrary: "none" | "shadcn-ui" | "daisyui" | "radix-ui" | "headless-ui" | "park-ui" | "chakra-ui" | "nextui" | "mantine" | "base-ui" | "ark-ui" | "react-aria";
+      validation: "none" | "zod" | "valibot" | "arktype" | "typebox" | "typia" | "runtypes" | "effect-schema";
+      realtime: "none" | "socket-io" | "partykit" | "ably" | "pusher" | "liveblocks" | "yjs";
+      jobQueue: "none" | "bullmq" | "trigger-dev" | "inngest" | "temporal";
+      animation: "none" | "framer-motion" | "gsap" | "react-spring" | "auto-animate" | "lottie";
+      fileUpload: "none" | "uploadthing" | "filepond" | "uppy";
+      logging: "none" | "pino" | "winston";
+      observability: "none" | "opentelemetry" | "sentry" | "grafana";
+      featureFlags: "none" | "growthbook" | "posthog";
+      analytics: "none" | "plausible" | "umami";
+      cms: "none" | "payload" | "sanity" | "strapi" | "tinacms";
+      caching: "none" | "upstash-redis";
+      search: "none" | "meilisearch" | "typesense" | "elasticsearch" | "algolia";
       fileStorage: "none" | "s3" | "r2";
       rustWebFramework: "none" | "axum" | "actix-web";
       rustFrontend: "none" | "leptos" | "dioxus";
@@ -583,13 +675,14 @@ declare const router: {
       rustApi: "none" | "tonic" | "async-graphql";
       rustCli: "none" | "clap" | "ratatui";
       rustLibraries: ("none" | "serde" | "validator" | "jsonwebtoken" | "argon2" | "tokio-test" | "mockall")[];
-      pythonWebFramework: "none" | "fastapi" | "django";
+      rustLogging: "none" | "tracing" | "env-logger";
+      pythonWebFramework: "none" | "fastapi" | "django" | "flask";
       pythonOrm: "none" | "sqlalchemy" | "sqlmodel";
       pythonValidation: "none" | "pydantic";
       pythonAi: ("none" | "langgraph" | "langchain" | "llamaindex" | "openai-sdk" | "anthropic-sdk" | "crewai")[];
       pythonTaskQueue: "none" | "celery";
       pythonQuality: "none" | "ruff";
-      goWebFramework: "none" | "gin" | "echo";
+      goWebFramework: "none" | "gin" | "echo" | "fiber";
       goOrm: "none" | "gorm" | "sqlc";
       goApi: "none" | "grpc-go";
       goCli: "none" | "cobra" | "bubbletea";
@@ -609,6 +702,10 @@ declare const router: {
     elapsedTimeMs: number;
     projectDirectory: string;
     relativePath: string;
+    dryRun?: undefined;
+    fileCount?: undefined;
+    directoryCount?: undefined;
+    files?: undefined;
     error?: undefined;
   } | {
     success: boolean;
@@ -619,6 +716,10 @@ declare const router: {
     elapsedTimeMs: number;
     projectDirectory: string;
     relativePath: string;
+    dryRun?: undefined;
+    fileCount?: undefined;
+    directoryCount?: undefined;
+    files?: undefined;
   } | undefined, {
     success: boolean;
     projectConfig: {
@@ -662,7 +763,90 @@ declare const router: {
       analytics: "none" | "plausible" | "umami";
       cms: "none" | "payload" | "sanity" | "strapi" | "tinacms";
       caching: "none" | "upstash-redis";
-      search: "none" | "meilisearch" | "typesense" | "elasticsearch";
+      search: "none" | "meilisearch" | "typesense" | "elasticsearch" | "algolia";
+      fileStorage: "none" | "s3" | "r2";
+      rustWebFramework: "none" | "axum" | "actix-web";
+      rustFrontend: "none" | "leptos" | "dioxus";
+      rustOrm: "none" | "sea-orm" | "sqlx";
+      rustApi: "none" | "tonic" | "async-graphql";
+      rustCli: "none" | "clap" | "ratatui";
+      rustLibraries: ("none" | "serde" | "validator" | "jsonwebtoken" | "argon2" | "tokio-test" | "mockall")[];
+      rustLogging: "none" | "tracing" | "env-logger";
+      pythonWebFramework: "none" | "fastapi" | "django" | "flask";
+      pythonOrm: "none" | "sqlalchemy" | "sqlmodel";
+      pythonValidation: "none" | "pydantic";
+      pythonAi: ("none" | "langgraph" | "langchain" | "llamaindex" | "openai-sdk" | "anthropic-sdk" | "crewai")[];
+      pythonTaskQueue: "none" | "celery";
+      pythonQuality: "none" | "ruff";
+      goWebFramework: "none" | "gin" | "echo" | "fiber";
+      goOrm: "none" | "gorm" | "sqlc";
+      goApi: "none" | "grpc-go";
+      goCli: "none" | "cobra" | "bubbletea";
+      goLogging: "none" | "zap";
+      aiDocs: ("none" | "claude-md" | "agents-md" | "cursorrules")[];
+      astroIntegration?: "none" | "svelte" | "solid" | "react" | "vue" | undefined;
+      shadcnBase?: "radix" | "base" | undefined;
+      shadcnStyle?: "vega" | "nova" | "maia" | "lyra" | "mira" | undefined;
+      shadcnIconLibrary?: "lucide" | "tabler" | "hugeicons" | "phosphor" | "remixicon" | undefined;
+      shadcnColorTheme?: "neutral" | "stone" | "zinc" | "gray" | "amber" | "blue" | "cyan" | "emerald" | "fuchsia" | "green" | "indigo" | "lime" | "orange" | "pink" | "purple" | "red" | "rose" | "sky" | "teal" | "violet" | "yellow" | undefined;
+      shadcnBaseColor?: "neutral" | "stone" | "zinc" | "gray" | undefined;
+      shadcnFont?: "inter" | "geist" | "noto-sans" | "nunito-sans" | "figtree" | "roboto" | "raleway" | "dm-sans" | "public-sans" | "outfit" | "jetbrains-mono" | "geist-mono" | undefined;
+      shadcnRadius?: "default" | "none" | "small" | "medium" | "large" | undefined;
+    };
+    reproducibleCommand: string;
+    timeScaffolded: string;
+    elapsedTimeMs: number;
+    projectDirectory: string;
+    relativePath: string;
+    dryRun: boolean;
+    fileCount: number;
+    directoryCount: number;
+    files: string[];
+    error?: undefined;
+  } | {
+    success: boolean;
+    projectConfig: {
+      projectName: string;
+      projectDir: string;
+      relativePath: string;
+      ecosystem: "typescript" | "rust" | "python" | "go";
+      database: "none" | "sqlite" | "postgres" | "mysql" | "mongodb" | "edgedb" | "redis";
+      orm: "none" | "drizzle" | "prisma" | "mongoose" | "typeorm" | "kysely" | "mikroorm" | "sequelize";
+      backend: "none" | "hono" | "express" | "fastify" | "elysia" | "fets" | "nestjs" | "adonisjs" | "nitro" | "encore" | "convex" | "self";
+      runtime: "none" | "bun" | "node" | "workers";
+      frontend: ("none" | "tanstack-router" | "react-router" | "react-vite" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "solid-start" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
+      addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "mcp" | "skills" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook" | "tanstack-query" | "tanstack-table" | "tanstack-virtual" | "tanstack-db" | "tanstack-pacer")[];
+      examples: ("ai" | "none" | "chat-sdk" | "tanstack-showcase")[];
+      auth: "none" | "better-auth" | "go-better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
+      payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
+      git: boolean;
+      packageManager: "bun" | "npm" | "pnpm" | "yarn";
+      versionChannel: "stable" | "latest" | "beta";
+      install: boolean;
+      dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "upstash" | "d1" | "docker";
+      api: "none" | "trpc" | "orpc" | "ts-rest" | "garph";
+      webDeploy: "none" | "docker" | "cloudflare" | "fly" | "railway" | "sst";
+      serverDeploy: "none" | "docker" | "cloudflare" | "fly" | "railway" | "sst";
+      ai: "none" | "langgraph" | "langchain" | "llamaindex" | "vercel-ai" | "mastra" | "voltagent" | "openai-agents" | "google-adk" | "modelfusion" | "tanstack-ai";
+      effect: "effect" | "none" | "effect-full";
+      stateManagement: "none" | "zustand" | "jotai" | "nanostores" | "redux-toolkit" | "mobx" | "xstate" | "valtio" | "tanstack-store" | "legend-state";
+      forms: "none" | "tanstack-form" | "react-hook-form" | "formik" | "final-form" | "conform" | "modular-forms";
+      testing: "none" | "vitest" | "playwright" | "vitest-playwright" | "jest" | "cypress";
+      email: "none" | "react-email" | "resend" | "nodemailer" | "postmark" | "sendgrid" | "aws-ses" | "mailgun" | "plunk";
+      cssFramework: "none" | "tailwind" | "scss" | "less" | "postcss-only";
+      uiLibrary: "none" | "shadcn-ui" | "daisyui" | "radix-ui" | "headless-ui" | "park-ui" | "chakra-ui" | "nextui" | "mantine" | "base-ui" | "ark-ui" | "react-aria";
+      validation: "none" | "zod" | "valibot" | "arktype" | "typebox" | "typia" | "runtypes" | "effect-schema";
+      realtime: "none" | "socket-io" | "partykit" | "ably" | "pusher" | "liveblocks" | "yjs";
+      jobQueue: "none" | "bullmq" | "trigger-dev" | "inngest" | "temporal";
+      animation: "none" | "framer-motion" | "gsap" | "react-spring" | "auto-animate" | "lottie";
+      fileUpload: "none" | "uploadthing" | "filepond" | "uppy";
+      logging: "none" | "pino" | "winston";
+      observability: "none" | "opentelemetry" | "sentry" | "grafana";
+      featureFlags: "none" | "growthbook" | "posthog";
+      analytics: "none" | "plausible" | "umami";
+      cms: "none" | "payload" | "sanity" | "strapi" | "tinacms";
+      caching: "none" | "upstash-redis";
+      search: "none" | "meilisearch" | "typesense" | "elasticsearch" | "algolia";
       fileStorage: "none" | "s3" | "r2";
       rustWebFramework: "none" | "axum" | "actix-web";
       rustFrontend: "none" | "leptos" | "dioxus";
@@ -670,13 +854,14 @@ declare const router: {
       rustApi: "none" | "tonic" | "async-graphql";
       rustCli: "none" | "clap" | "ratatui";
       rustLibraries: ("none" | "serde" | "validator" | "jsonwebtoken" | "argon2" | "tokio-test" | "mockall")[];
-      pythonWebFramework: "none" | "fastapi" | "django";
+      rustLogging: "none" | "tracing" | "env-logger";
+      pythonWebFramework: "none" | "fastapi" | "django" | "flask";
       pythonOrm: "none" | "sqlalchemy" | "sqlmodel";
       pythonValidation: "none" | "pydantic";
       pythonAi: ("none" | "langgraph" | "langchain" | "llamaindex" | "openai-sdk" | "anthropic-sdk" | "crewai")[];
       pythonTaskQueue: "none" | "celery";
       pythonQuality: "none" | "ruff";
-      goWebFramework: "none" | "gin" | "echo";
+      goWebFramework: "none" | "gin" | "echo" | "fiber";
       goOrm: "none" | "gorm" | "sqlc";
       goApi: "none" | "grpc-go";
       goCli: "none" | "cobra" | "bubbletea";
@@ -696,6 +881,10 @@ declare const router: {
     elapsedTimeMs: number;
     projectDirectory: string;
     relativePath: string;
+    dryRun?: undefined;
+    fileCount?: undefined;
+    directoryCount?: undefined;
+    files?: undefined;
     error?: undefined;
   } | {
     success: boolean;
@@ -706,6 +895,10 @@ declare const router: {
     elapsedTimeMs: number;
     projectDirectory: string;
     relativePath: string;
+    dryRun?: undefined;
+    fileCount?: undefined;
+    directoryCount?: undefined;
+    files?: undefined;
   } | undefined>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
   sponsors: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, _orpc_server0.Schema<unknown, unknown>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
   docs: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, _orpc_server0.Schema<unknown, unknown>, _orpc_server0.Schema<void, void>, _orpc_server0.MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
@@ -876,10 +1069,11 @@ type RustApi = import__better_fullstack_types.RustApi;
 type RustCli = import__better_fullstack_types.RustCli;
 type RustFrontend = import__better_fullstack_types.RustFrontend;
 type RustLibraries = import__better_fullstack_types.RustLibraries;
+type RustLogging = import__better_fullstack_types.RustLogging;
 type RustOrm = import__better_fullstack_types.RustOrm;
 type RustWebFramework = import__better_fullstack_types.RustWebFramework;
 type ServerDeploy = import__better_fullstack_types.ServerDeploy;
 type Template = import__better_fullstack_types.Template;
 type UILibrary = import__better_fullstack_types.UILibrary;
 type WebDeploy = import__better_fullstack_types.WebDeploy;
-export { type API, type AddInput, type AddResult, type Addons, type AiDocs, type Analytics, type Animation, type Auth, type Backend, type BetterTStackConfig, type CMS, type CSSFramework, type Caching, type CreateInput, type Database, type DatabaseSetup, type DirectoryConflict, EMBEDDED_TEMPLATES, type Ecosystem, type Effect, type Examples, type Frontend, type GeneratorOptions, type GeneratorResult, type GoApi, type GoCli, type GoLogging, type GoOrm, type GoWebFramework, type InitResult, type Logging, type ORM, type PackageManager, type Payments, type PythonAi, type PythonOrm, type PythonQuality, type PythonTaskQueue, type PythonValidation, type PythonWebFramework, type Realtime, type Runtime, type RustApi, type RustCli, type RustFrontend, type RustLibraries, type RustOrm, type RustWebFramework, type ServerDeploy, TEMPLATE_COUNT, type Template, type UILibrary, type VirtualDirectory, type VirtualFile, VirtualFileSystem, type VirtualFileTree, type VirtualNode, type WebDeploy, add, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, history, router, sponsors };
+export { type API, type AddInput, type AddResult, type Addons, type AiDocs, type Analytics, type Animation, type Auth, type Backend, type BetterTStackConfig, type CMS, type CSSFramework, type Caching, type CreateInput, type Database, type DatabaseSetup, type DirectoryConflict, EMBEDDED_TEMPLATES, type Ecosystem, type Effect, type Examples, type Frontend, type GeneratorOptions, type GeneratorResult, type GoApi, type GoCli, type GoLogging, type GoOrm, type GoWebFramework, type InitResult, type Logging, type ORM, type PackageManager, type Payments, type PythonAi, type PythonOrm, type PythonQuality, type PythonTaskQueue, type PythonValidation, type PythonWebFramework, type Realtime, type Runtime, type RustApi, type RustCli, type RustFrontend, type RustLibraries, type RustLogging, type RustOrm, type RustWebFramework, type ServerDeploy, TEMPLATE_COUNT, type Template, type UILibrary, type VirtualDirectory, type VirtualFile, VirtualFileSystem, type VirtualFileTree, type VirtualNode, type WebDeploy, add, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, history, router, sponsors };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { t as __reExport } from "./chunk-CCII7kTE.mjs";
-import { a as DEFAULT_CONFIG, c as getDefaultConfig, i as getLatestCLIVersion, l as getUserPkgManager, n as updateBtsConfig, o as DEFAULT_UI_LIBRARY_BY_FRONTEND, r as writeBtsConfig, t as readBtsConfig } from "./bts-config-BCe8SqYV.mjs";
-import { _ as setLastPromptShownUI, a as getPackageExecutionArgs, c as UserCancelledError, d as handleError, f as didLastPromptShowUI, g as setIsFirstPrompt$1, h as runWithContextAsync, l as exitCancelled, m as isSilent, o as addPackageDependency, p as isFirstPrompt, s as CLIError, t as setupAddons, u as exitWithError } from "./addons-setup-1jZXP0D3.mjs";
+import { a as DEFAULT_CONFIG, c as getDefaultConfig, i as getLatestCLIVersion, l as getUserPkgManager, n as updateBtsConfig, o as DEFAULT_UI_LIBRARY_BY_FRONTEND, r as writeBtsConfig, t as readBtsConfig } from "./bts-config-BYD8mHt-.mjs";
+import { _ as setLastPromptShownUI, a as getPackageExecutionArgs, c as UserCancelledError, d as handleError, f as didLastPromptShowUI, g as setIsFirstPrompt$1, h as runWithContextAsync, l as exitCancelled, m as isSilent, o as addPackageDependency, p as isFirstPrompt, s as CLIError, t as setupAddons, u as exitWithError } from "./addons-setup-Bll5VFJd.mjs";
 import { cancel, confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
 import pc from "picocolors";
@@ -2613,6 +2613,11 @@ async function getGoWebFrameworkChoice(goWebFramework) {
 				label: "Echo",
 				hint: "High performance, minimalist Go web framework"
 			},
+			{
+				value: "fiber",
+				label: "Fiber",
+				hint: "Express-inspired web framework built on Fasthttp"
+			},
 			{
 				value: "none",
 				label: "None",
@@ -3088,6 +3093,11 @@ async function getPythonWebFrameworkChoice(pythonWebFramework) {
 				label: "Django",
 				hint: "High-level Python web framework with batteries included"
 			},
+			{
+				value: "flask",
+				label: "Flask",
+				hint: "Lightweight WSGI web framework with minimal boilerplate"
+			},
 			{
 				value: "none",
 				label: "None",
@@ -3480,6 +3490,32 @@ async function getRustLibrariesChoice(rustLibraries) {
 	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
+async function getRustLoggingChoice(rustLogging) {
+	if (rustLogging !== void 0) return rustLogging;
+	const response = await navigableSelect({
+		message: "Select Rust logging library",
+		options: [
+			{
+				value: "tracing",
+				label: "Tracing",
+				hint: "Structured, composable instrumentation framework from Tokio"
+			},
+			{
+				value: "env-logger",
+				label: "env_logger",
+				hint: "Simple logger configured via environment variables"
+			},
+			{
+				value: "none",
+				label: "None",
+				hint: "No logging library"
+			}
+		],
+		initialValue: "tracing"
+	});
+	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	return response;
+}
 
 //#endregion
 //#region src/prompts/search.ts
@@ -3504,6 +3540,11 @@ async function getSearchChoice(search, backend) {
 				label: "Elasticsearch",
 				hint: "Distributed search and analytics engine with local and cloud deployments"
 			},
+			{
+				value: "algolia",
+				label: "Algolia",
+				hint: "Hosted search API with instant results, typo tolerance, and analytics"
+			},
 			{
 				value: "none",
 				label: "None",
@@ -4389,6 +4430,10 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 			if (results.ecosystem !== "rust") return Promise.resolve([]);
 			return getRustLibrariesChoice(flags.rustLibraries);
 		},
+		rustLogging: ({ results }) => {
+			if (results.ecosystem !== "rust") return Promise.resolve("none");
+			return getRustLoggingChoice(flags.rustLogging);
+		},
 		pythonWebFramework: ({ results }) => {
 			if (results.ecosystem !== "python") return Promise.resolve("none");
 			return getPythonWebFrameworkChoice(flags.pythonWebFramework);
@@ -4491,6 +4536,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		rustApi: result.rustApi,
 		rustCli: result.rustCli,
 		rustLibraries: result.rustLibraries,
+		rustLogging: result.rustLogging,
 		pythonWebFramework: result.pythonWebFramework,
 		pythonOrm: result.pythonOrm,
 		pythonValidation: result.pythonValidation,
@@ -4777,6 +4823,7 @@ function getRustFlags(config) {
 	flags.push(`--rust-api ${config.rustApi}`);
 	flags.push(`--rust-cli ${config.rustCli}`);
 	flags.push(formatArrayFlag("rust-libraries", config.rustLibraries));
+	flags.push(`--rust-logging ${config.rustLogging}`);
 	appendSharedNonTypeScriptFlags(flags, config);
 	appendCommonFlags(flags, config);
 	return flags;
@@ -6925,7 +6972,9 @@ async function displayPostInstallInstructions(config) {
 	const pwaInstructions = addons?.includes("pwa") && (frontend?.includes("react-router") || frontend?.includes("react-vite")) ? getPwaInstructions() : "";
 	const starlightInstructions = addons?.includes("starlight") ? getStarlightInstructions(runCmd) : "";
 	const clerkInstructions = config.auth === "clerk" ? getClerkInstructions(config.backend, config.frontend ?? []) : "";
-	const polarInstructions = config.payments === "polar" && config.auth === "better-auth" ? getPolarInstructions(backend, packageManager) : "";
+	const authSetupInstructions = getAuthSetupInstructions(config.auth, backend, config.frontend ?? []);
+	const polarInstructions = config.payments === "polar" ? getPolarInstructions(backend, packageManager) : "";
+	const paymentSetupInstructions = getPaymentSetupInstructions(config.payments, backend);
 	const alchemyDeployInstructions = getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy, backend);
 	const hasWeb = frontend?.some((f) => WEB_FRAMEWORKS.includes(f));
 	const hasNative = frontend?.includes("native-bare") || frontend?.includes("native-uniwind") || frontend?.includes("native-unistyles");
@@ -6974,8 +7023,10 @@ async function displayPostInstallInstructions(config) {
 	if (alchemyDeployInstructions) output += `\n${alchemyDeployInstructions.trim()}\n`;
 	if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
 	if (clerkInstructions) output += `\n${clerkInstructions.trim()}\n`;
+	if (authSetupInstructions) output += `\n${authSetupInstructions.trim()}\n`;
 	if (betterAuthConvexInstructions) output += `\n${betterAuthConvexInstructions.trim()}\n`;
 	if (polarInstructions) output += `\n${polarInstructions.trim()}\n`;
+	if (paymentSetupInstructions) output += `\n${paymentSetupInstructions.trim()}\n`;
 	if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
 	if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
 	output += `\n${pc.bold("Enjoying Better Fullstack?")} Help us grow — star the repo!\n`;
@@ -7023,9 +7074,15 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 		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 (dbSetup === "turso" && orm === "prisma") instructions.push(`${pc.yellow("NOTE:")} Turso + Prisma migrations require the Turso CLI.\n   1. Install and authenticate the Turso CLI:\n      ${pc.underline("https://docs.turso.tech/cli/installation")}\n   2. Confirm ${pc.white("DATABASE_URL")} and ${pc.white("TURSO_AUTH_TOKEN")} are set in your env file\n   3. Generate Prisma Client: ${`${runCmd} db:generate`}\n   4. Follow the official migration workflow:\n      ${pc.underline("https://docs.turso.tech/sdk/ts/orm/prisma")}`);
+	if (dbSetup === "turso" && orm === "drizzle") instructions.push(`${pc.yellow("NOTE:")} Turso + Drizzle requires the Turso CLI for database management.\n   1. Install and authenticate the Turso CLI:\n      ${pc.underline("https://docs.turso.tech/cli/installation")}\n   2. Confirm ${pc.white("DATABASE_URL")} and ${pc.white("TURSO_AUTH_TOKEN")} are set in your env file\n   3. Push schema: ${`${runCmd} db:push`}\n   4. Docs: ${pc.underline("https://orm.drizzle.team/docs/get-started/turso-new")}`);
+	if (dbSetup === "neon") instructions.push(`${pc.yellow("NOTE:")} Set your Neon ${pc.white("DATABASE_URL")} in your env file.\n   Dashboard: ${pc.underline("https://console.neon.tech")}`);
+	if (dbSetup === "supabase") instructions.push(`${pc.yellow("NOTE:")} Set your Supabase ${pc.white("DATABASE_URL")} in your env file.\n   Dashboard: ${pc.underline("https://supabase.com/dashboard")}`);
+	if (dbSetup === "prisma-postgres") instructions.push(`${pc.yellow("NOTE:")} Get your Prisma Postgres connection string from the console.\n   Console: ${pc.underline("https://console.prisma.io")}`);
+	if (dbSetup === "mongodb-atlas") instructions.push(`${pc.yellow("NOTE:")} Set your Atlas ${pc.white("DATABASE_URL")} in your env file.\n   Dashboard: ${pc.underline("https://cloud.mongodb.com")}`);
+	if (dbSetup === "upstash") instructions.push(`${pc.yellow("NOTE:")} Set your Upstash Redis credentials in your env file.\n   Console: ${pc.underline("https://console.upstash.com")}`);
 	if (orm === "prisma") {
-		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker: this combination has known issues.\n   Consider using MongoDB Atlas (${pc.underline("https://www.mongodb.com/atlas")}) for reliable Prisma + MongoDB support.`);
+		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker can be unreliable in local development.\n   • Start MongoDB first and wait until the container is ready before Prisma commands\n   • If ${`${runCmd} db:push`} keeps failing locally, switch to MongoDB Atlas for a supported Prisma workflow:\n     ${pc.underline("https://www.mongodb.com/atlas")}`);
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
 		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) {
 			instructions.push(`${pc.cyan("•")} Generate Prisma Client: ${`${runCmd} db:generate`}`);
@@ -7038,6 +7095,8 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) 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 === "typeorm" || orm === "mikroorm" || orm === "sequelize" || orm === "kysely") {
+		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")}` : "";
 }
@@ -7064,6 +7123,24 @@ function getClerkInstructions(backend, frontend) {
 	}
 	return "";
 }
+function getAuthSetupInstructions(auth, backend, frontend) {
+	if (auth === "clerk" || auth === "better-auth" || auth === "go-better-auth" || auth === "none") return "";
+	const envPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
+	if (auth === "nextauth") return `${pc.bold("NextAuth.js Setup:")}\n${pc.cyan("•")} Generate a secret: ${pc.white("npx auth secret")}\n${pc.cyan("•")} Set ${pc.white("AUTH_SECRET")} in ${pc.white(envPath)}\n${pc.cyan("•")} Configure your OAuth providers (e.g. ${pc.white("AUTH_GITHUB_ID")}, ${pc.white("AUTH_GITHUB_SECRET")})\n${pc.cyan("•")} Docs: ${pc.underline("https://authjs.dev/getting-started")}`;
+	if (auth === "stack-auth") return `${pc.bold("Stack Auth Setup:")}\n${pc.cyan("•")} Create a project at ${pc.underline("https://app.stack-auth.com")}\n${pc.cyan("•")} Set ${pc.white("NEXT_PUBLIC_STACK_PROJECT_ID")}, ${pc.white("NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY")},\n   and ${pc.white("STACK_SECRET_SERVER_KEY")} in ${pc.white(envPath)}`;
+	if (auth === "supabase-auth") return `${pc.bold("Supabase Auth Setup:")}\n${pc.cyan("•")} Create a project at ${pc.underline("https://supabase.com/dashboard")}\n${pc.cyan("•")} Set ${pc.white("NEXT_PUBLIC_SUPABASE_URL")}, ${pc.white("NEXT_PUBLIC_SUPABASE_ANON_KEY")},\n   and ${pc.white("SUPABASE_SERVICE_ROLE_KEY")} in ${pc.white(envPath)}`;
+	if (auth === "auth0") return `${pc.bold("Auth0 Setup:")}\n${pc.cyan("•")} Create an application at ${pc.underline("https://manage.auth0.com")}\n${pc.cyan("•")} Set ${pc.white("AUTH0_SECRET")}, ${pc.white("AUTH0_CLIENT_ID")}, ${pc.white("AUTH0_CLIENT_SECRET")},\n   and ${pc.white("AUTH0_ISSUER_BASE_URL")} in ${pc.white(envPath)}\n${pc.cyan("•")} Docs: ${pc.underline("https://auth0.com/docs/quickstart")}`;
+	return "";
+}
+function getPaymentSetupInstructions(payments, backend) {
+	if (payments === "polar" || payments === "none") return "";
+	const envPath = backend === "self" ? "apps/web/.env" : "apps/server/.env";
+	if (payments === "stripe") return `${pc.bold("Stripe Setup:")}\n${pc.cyan("•")} Get API keys from ${pc.underline("https://dashboard.stripe.com/apikeys")}\n${pc.cyan("•")} Set ${pc.white("STRIPE_SECRET_KEY")} and ${pc.white("STRIPE_WEBHOOK_SECRET")} in ${pc.white(envPath)}\n${pc.cyan("•")} For local webhooks: ${pc.white("stripe listen --forward-to localhost:3000/api/webhooks/stripe")}`;
+	if (payments === "lemon-squeezy") return `${pc.bold("Lemon Squeezy Setup:")}\n${pc.cyan("•")} Get API key from ${pc.underline("https://app.lemonsqueezy.com/settings/api")}\n${pc.cyan("•")} Set ${pc.white("LEMONSQUEEZY_API_KEY")} and ${pc.white("LEMONSQUEEZY_STORE_ID")} in ${pc.white(envPath)}`;
+	if (payments === "paddle") return `${pc.bold("Paddle Setup:")}\n${pc.cyan("•")} Get API keys from ${pc.underline("https://vendors.paddle.com")}\n${pc.cyan("•")} Set ${pc.white("PADDLE_API_KEY")} and ${pc.white("PADDLE_WEBHOOK_SECRET")} in ${pc.white(envPath)}`;
+	if (payments === "dodo") return `${pc.bold("Dodo Payments Setup:")}\n${pc.cyan("•")} Get API key from ${pc.underline("https://app.dodopayments.com")}\n${pc.cyan("•")} Set ${pc.white("DODO_PAYMENTS_API_KEY")} and ${pc.white("DODO_PAYMENTS_WEBHOOK_SECRET")} in ${pc.white(envPath)}`;
+	return "";
+}
 function getBetterAuthConvexInstructions(hasWeb, webPort, packageManager) {
 	const cmd = packageManager === "npm" ? "npx" : packageManager === "yarn" ? "yarn dlx" : packageManager;
 	return `${pc.bold("Better Auth + Convex Setup:")}\n${pc.cyan("•")} Set environment variables from ${pc.white("packages/backend")}:\n${pc.white("   cd packages/backend")}\n${pc.white(`   ${cmd} convex env set BETTER_AUTH_SECRET=$(openssl rand -base64 32)`)}\n` + (hasWeb ? `${pc.white(`   ${cmd} convex env set SITE_URL http://localhost:${webPort}`)}\n` : "");
@@ -7115,6 +7192,11 @@ function displayRustInstructions(config) {
 		clap: "Clap",
 		ratatui: "Ratatui"
 	}[rustCli] || rustCli}\n`;
+	const { rustLogging } = config;
+	if (rustLogging && rustLogging !== "none") output += `${pc.cyan("•")} Logging: ${{
+		tracing: "Tracing",
+		"env-logger": "env_logger"
+	}[rustLogging] || rustLogging}\n`;
 	output += `\n${pc.bold("Common Cargo commands:")}\n`;
 	output += `${pc.cyan("•")} Build: cargo build\n`;
 	output += `${pc.cyan("•")} Run: cargo run\n`;
@@ -7137,7 +7219,8 @@ function displayGoInstructions(config) {
 	output += `\n${pc.bold("Your Go project includes:")}\n`;
 	if (goWebFramework && goWebFramework !== "none") output += `${pc.cyan("•")} Web Framework: ${{
 		gin: "Gin",
-		echo: "Echo"
+		echo: "Echo",
+		fiber: "Fiber"
 	}[goWebFramework] || goWebFramework}\n`;
 	if (goOrm && goOrm !== "none") output += `${pc.cyan("•")} Database: ${{
 		gorm: "GORM",
@@ -7169,6 +7252,7 @@ function displayPythonInstructions(config) {
 	const cdCmd = `cd ${relativePath}`;
 	let runCommand = "uv run uvicorn app.main:app --reload";
 	if (pythonWebFramework === "django") runCommand = "uv run python manage.py runserver";
+	else if (pythonWebFramework === "flask") runCommand = "uv run flask --app app.main run --reload";
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} uv sync\n`;
@@ -7176,7 +7260,8 @@ function displayPythonInstructions(config) {
 	output += `\n${pc.bold("Your Python project includes:")}\n`;
 	if (pythonWebFramework && pythonWebFramework !== "none") output += `${pc.cyan("•")} Web Framework: ${{
 		fastapi: "FastAPI",
-		django: "Django"
+		django: "Django",
+		flask: "Flask"
 	}[pythonWebFramework] || pythonWebFramework}\n`;
 	if (pythonOrm && pythonOrm !== "none") output += `${pc.cyan("•")} ORM: ${{
 		sqlalchemy: "SQLAlchemy",
@@ -7298,93 +7383,104 @@ async function createProjectHandler(input, options = {}) {
 				currentPathInput = defaultName;
 			} else currentPathInput = await getProjectName(input.projectName);
 			const versionChannel = shouldPromptForVersionChannel(input) ? await getVersionChannelChoice() : input.versionChannel ?? "stable";
-			let finalPathInput;
-			let shouldClearDirectory;
-			try {
-				if (input.directoryConflict) {
-					const result = await handleDirectoryConflictProgrammatically(currentPathInput, input.directoryConflict);
-					finalPathInput = result.finalPathInput;
-					shouldClearDirectory = result.shouldClearDirectory;
-				} else {
-					const result = await handleDirectoryConflict(currentPathInput);
-					finalPathInput = result.finalPathInput;
-					shouldClearDirectory = result.shouldClearDirectory;
-				}
-			} catch (error) {
-				if (error instanceof UserCancelledError || error instanceof CLIError) throw error;
-				return {
-					success: false,
-					projectConfig: {
-						projectName: "",
-						projectDir: "",
+			let finalResolvedPath;
+			let finalBaseName;
+			if (input.dryRun) {
+				finalBaseName = path.basename(currentPathInput);
+				finalResolvedPath = path.resolve(process.cwd(), currentPathInput);
+			} else {
+				let finalPathInput;
+				let shouldClearDirectory;
+				try {
+					if (input.directoryConflict) {
+						const result = await handleDirectoryConflictProgrammatically(currentPathInput, input.directoryConflict);
+						finalPathInput = result.finalPathInput;
+						shouldClearDirectory = result.shouldClearDirectory;
+					} else {
+						const result = await handleDirectoryConflict(currentPathInput);
+						finalPathInput = result.finalPathInput;
+						shouldClearDirectory = result.shouldClearDirectory;
+					}
+				} catch (error) {
+					if (error instanceof UserCancelledError || error instanceof CLIError) throw error;
+					return {
+						success: false,
+						projectConfig: {
+							projectName: "",
+							projectDir: "",
+							relativePath: "",
+							ecosystem: "typescript",
+							database: "none",
+							orm: "none",
+							backend: "none",
+							runtime: "none",
+							frontend: [],
+							addons: [],
+							examples: [],
+							auth: "none",
+							payments: "none",
+							email: "none",
+							fileUpload: "none",
+							effect: "none",
+							git: false,
+							packageManager: "npm",
+							versionChannel: "stable",
+							install: false,
+							dbSetup: "none",
+							api: "none",
+							webDeploy: "none",
+							serverDeploy: "none",
+							cssFramework: "none",
+							uiLibrary: "none",
+							ai: "none",
+							stateManagement: "none",
+							validation: "zod",
+							forms: "react-hook-form",
+							testing: "vitest",
+							realtime: "none",
+							jobQueue: "none",
+							animation: "none",
+							logging: "none",
+							observability: "none",
+							rustWebFramework: "none",
+							rustFrontend: "none",
+							rustOrm: "none",
+							rustApi: "none",
+							rustCli: "none",
+							rustLibraries: [],
+							rustLogging: "none",
+							cms: "none",
+							caching: "none",
+							search: "none",
+							featureFlags: "none",
+							analytics: "none",
+							fileStorage: "none",
+							pythonWebFramework: "none",
+							pythonOrm: "none",
+							pythonValidation: "none",
+							pythonAi: [],
+							pythonTaskQueue: "none",
+							pythonQuality: "none",
+							goWebFramework: "none",
+							goOrm: "none",
+							goApi: "none",
+							goCli: "none",
+							goLogging: "none",
+							aiDocs: []
+						},
+						reproducibleCommand: "",
+						timeScaffolded,
+						elapsedTimeMs: Date.now() - startTime,
+						projectDirectory: "",
 						relativePath: "",
-						ecosystem: "typescript",
-						database: "none",
-						orm: "none",
-						backend: "none",
-						runtime: "none",
-						frontend: [],
-						addons: [],
-						examples: [],
-						auth: "none",
-						payments: "none",
-						email: "none",
-						fileUpload: "none",
-						effect: "none",
-						git: false,
-						packageManager: "npm",
-						versionChannel: "stable",
-						install: false,
-						dbSetup: "none",
-						api: "none",
-						webDeploy: "none",
-						serverDeploy: "none",
-						cssFramework: "none",
-						uiLibrary: "none",
-						ai: "none",
-						stateManagement: "none",
-						validation: "zod",
-						forms: "react-hook-form",
-						testing: "vitest",
-						realtime: "none",
-						jobQueue: "none",
-						animation: "none",
-						logging: "none",
-						observability: "none",
-						rustWebFramework: "none",
-						rustFrontend: "none",
-						rustOrm: "none",
-						rustApi: "none",
-						rustCli: "none",
-						rustLibraries: [],
-						cms: "none",
-						caching: "none",
-						search: "none",
-						featureFlags: "none",
-						analytics: "none",
-						fileStorage: "none",
-						pythonWebFramework: "none",
-						pythonOrm: "none",
-						pythonValidation: "none",
-						pythonAi: [],
-						pythonTaskQueue: "none",
-						pythonQuality: "none",
-						goWebFramework: "none",
-						goOrm: "none",
-						goApi: "none",
-						goCli: "none",
-						goLogging: "none",
-						aiDocs: []
-					},
-					reproducibleCommand: "",
-					timeScaffolded,
-					elapsedTimeMs: Date.now() - startTime,
-					projectDirectory: "",
-					relativePath: "",
-					error: error instanceof Error ? error.message : String(error)
-				};
+						error: error instanceof Error ? error.message : String(error)
+					};
+				}
+				const setupResult = await setupProjectDirectory(finalPathInput, shouldClearDirectory);
+				finalResolvedPath = setupResult.finalResolvedPath;
+				finalBaseName = setupResult.finalBaseName;
+				currentPathInput = finalPathInput;
 			}
-			const { finalResolvedPath, finalBaseName } = await setupProjectDirectory(finalPathInput, shouldClearDirectory);
 			const originalInput = {
 				...input,
 				projectDirectory: input.projectName
@@ -7418,7 +7514,7 @@ async function createProjectHandler(input, options = {}) {
 					...flagConfig,
 					projectName: finalBaseName,
 					projectDir: finalResolvedPath,
-					relativePath: finalPathInput,
+					relativePath: currentPathInput,
 					versionChannel
 				};
 				validateConfigCompatibility(config, providedFlags, cliInput);
@@ -7437,12 +7533,54 @@ async function createProjectHandler(input, options = {}) {
 					log.message("");
 				}
 				config = {
-					...await gatherConfig(flagConfig, finalBaseName, finalResolvedPath, finalPathInput),
+					...await gatherConfig(flagConfig, finalBaseName, finalResolvedPath, currentPathInput),
 					versionChannel
 				};
 			}
 			const preflight = validatePreflightConfig(config);
 			if (preflight.hasWarnings && !isSilent()) displayPreflightWarnings(preflight);
+			if (input.dryRun) {
+				const result = await generateVirtualProject$1({
+					config,
+					templates: EMBEDDED_TEMPLATES$1
+				});
+				if (!result.success || !result.tree) throw new Error(result.error || "Failed to generate project templates");
+				const files = [];
+				function walk(nodes, prefix) {
+					for (const node of nodes) {
+						const current = prefix ? `${prefix}/${node.name}` : node.name;
+						if (node.type === "directory" && node.children) walk(node.children, current);
+						else files.push(current);
+					}
+				}
+				walk(result.tree.root.children, "");
+				if (!isSilent()) {
+					log.info(pc.bold(pc.cyan(`Dry run complete — ${result.tree.fileCount} files in ${result.tree.directoryCount} directories`)));
+					log.message("");
+					log.message(pc.bold("Files that would be created:"));
+					for (const file of files) log.message(pc.dim(`  ${file}`));
+				}
+				const reproducibleCommand$1 = generateReproducibleCommand(config);
+				if (!isSilent()) {
+					log.message("");
+					log.success(pc.blue(`You can reproduce this setup with the following command:\n${reproducibleCommand$1}`));
+				}
+				const elapsedTimeMs$1 = Date.now() - startTime;
+				if (!isSilent()) outro(pc.magenta("No files were written (dry run)."));
+				return {
+					success: true,
+					projectConfig: config,
+					reproducibleCommand: reproducibleCommand$1,
+					timeScaffolded,
+					elapsedTimeMs: elapsedTimeMs$1,
+					projectDirectory: config.projectDir,
+					relativePath: config.relativePath,
+					dryRun: true,
+					fileCount: result.tree.fileCount,
+					directoryCount: result.tree.directoryCount,
+					files
+				};
+			}
 			await createProject(config, { manualDb: cliInput.manualDb ?? input.manualDb });
 			const reproducibleCommand = generateReproducibleCommand(config);
 			if (!isSilent()) log.success(pc.blue(`You can reproduce this setup with the following command:\n${reproducibleCommand}`));
@@ -7594,7 +7732,7 @@ function displaySponsorsBox(sponsors$1) {
 //#region src/index.ts
 const router = os.router({
 	create: os.meta({
-		description: "Create a new Better Fullstack project",
+		description: "Scaffold a new Better Fullstack project from 270+ compatible stack options",
 		default: true,
 		negateBooleans: true
 	}).input(z.tuple([types_exports.ProjectNameSchema.optional(), z.object({
@@ -7602,6 +7740,7 @@ const router = os.router({
 		yes: z.boolean().optional().default(false).describe("Use default configuration"),
 		yolo: z.boolean().optional().default(false).describe("(WARNING - NOT RECOMMENDED) Bypass validations and compatibility checks"),
 		verbose: z.boolean().optional().default(false).describe("Show detailed result information"),
+		dryRun: z.boolean().optional().default(false).describe("Preview generated file tree without writing to disk"),
 		ecosystem: types_exports.EcosystemSchema.optional().describe("Language ecosystem (typescript, rust, python, or go)"),
 		database: types_exports.DatabaseSchema.optional(),
 		orm: types_exports.ORMSchema.optional(),
@@ -7659,13 +7798,14 @@ const router = os.router({
 		rustApi: types_exports.RustApiSchema.optional().describe("Rust API layer (tonic, async-graphql)"),
 		rustCli: types_exports.RustCliSchema.optional().describe("Rust CLI tools (clap, ratatui)"),
 		rustLibraries: z.array(types_exports.RustLibrariesSchema).optional().describe("Rust core libraries"),
+		rustLogging: types_exports.RustLoggingSchema.optional().describe("Rust logging (tracing, env-logger)"),
 		pythonWebFramework: types_exports.PythonWebFrameworkSchema.optional().describe("Python web framework (fastapi, django)"),
 		pythonOrm: types_exports.PythonOrmSchema.optional().describe("Python ORM/database (sqlalchemy, sqlmodel)"),
 		pythonValidation: types_exports.PythonValidationSchema.optional().describe("Python validation (pydantic)"),
 		pythonAi: z.array(types_exports.PythonAiSchema).optional().describe("Python AI/ML frameworks"),
 		pythonTaskQueue: types_exports.PythonTaskQueueSchema.optional().describe("Python task queue (celery)"),
 		pythonQuality: types_exports.PythonQualitySchema.optional().describe("Python code quality (ruff)"),
-		goWebFramework: types_exports.GoWebFrameworkSchema.optional().describe("Go web framework (gin, echo)"),
+		goWebFramework: types_exports.GoWebFrameworkSchema.optional().describe("Go web framework (gin, echo, fiber)"),
 		goOrm: types_exports.GoOrmSchema.optional().describe("Go ORM/database (gorm, sqlc)"),
 		goApi: types_exports.GoApiSchema.optional().describe("Go API layer (grpc-go)"),
 		goCli: types_exports.GoCliSchema.optional().describe("Go CLI tools (cobra, bubbletea)"),
@@ -7706,7 +7846,7 @@ const router = os.router({
 			log.message(`Please visit ${BUILDER_URL}`);
 		}
 	}),
-	add: os.meta({ description: "Add addons or deployment targets to an existing Better Fullstack project" }).input(z.object({
+	add: os.meta({ description: "Add addons or deployment targets to an existing Better Fullstack project using its bts.jsonc config" }).input(z.object({
 		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
 		webDeploy: types_exports.WebDeploySchema.optional().describe("Web deployment option to set"),
 		serverDeploy: types_exports.ServerDeploySchema.optional().describe("Server deployment option to set"),
@@ -7741,7 +7881,7 @@ const router = os.router({
 			ecosystem: input.ecosystem
 		});
 	}),
-	mcp: os.meta({ description: "Start MCP server for AI agent integration (stdio transport)" }).handler(async () => {
+	mcp: os.meta({ description: "Start the Better Fullstack MCP server so AI agents can inspect the schema, plan stacks, and scaffold projects over stdio" }).handler(async () => {
 		log.message("MCP server is started via the 'mcp' subcommand intercepted in cli.ts.");
 		log.message("Run: create-better-fullstack mcp");
 	})
@@ -7899,6 +8039,7 @@ async function createVirtual(options) {
 				rustApi: options.rustApi || "none",
 				rustCli: options.rustCli || "none",
 				rustLibraries: options.rustLibraries || [],
+				rustLogging: options.rustLogging || (options.ecosystem === "rust" ? "tracing" : "none"),
 				pythonWebFramework: options.pythonWebFramework || "none",
 				pythonOrm: options.pythonOrm || "none",
 				pythonValidation: options.pythonValidation || "none",

package/dist/{mcp-C_X1WfCg.mjs → mcp-CRjipp-w.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "./bts-config-BCe8SqYV.mjs";
+import "./bts-config-BYD8mHt-.mjs";
 import { t as startMcpServer } from "./mcp-entry.mjs";
 
 export { startMcpServer };

package/dist/mcp-entry.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { i as getLatestCLIVersion, r as writeBtsConfig, t as readBtsConfig } from "./bts-config-BCe8SqYV.mjs";
+import { i as getLatestCLIVersion, r as writeBtsConfig, t as readBtsConfig } from "./bts-config-BYD8mHt-.mjs";
 import z from "zod";
-import { AISchema, APISchema, AddonsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BackendSchema, CMSSchema, CSSFrameworkSchema, CachingSchema, DatabaseSchema, DatabaseSetupSchema, EcosystemSchema, EffectSchema, EmailSchema, ExamplesSchema, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GoApiSchema, GoCliSchema, GoLoggingSchema, GoOrmSchema, GoWebFrameworkSchema, JobQueueSchema, LoggingSchema, ORMSchema, ObservabilitySchema, PackageManagerSchema, PaymentsSchema, PythonAiSchema, PythonOrmSchema, PythonQualitySchema, PythonTaskQueueSchema, PythonValidationSchema, PythonWebFrameworkSchema, RealtimeSchema, RuntimeSchema, RustApiSchema, RustCliSchema, RustFrontendSchema, RustLibrariesSchema, RustOrmSchema, RustWebFrameworkSchema, SearchSchema, ServerDeploySchema, StateManagementSchema, TestingSchema, UILibrarySchema, ValidationSchema, WebDeploySchema, analyzeStackCompatibility } from "@better-fullstack/types";
+import { AISchema, APISchema, AddonsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BackendSchema, CMSSchema, CSSFrameworkSchema, CachingSchema, DatabaseSchema, DatabaseSetupSchema, EcosystemSchema, EffectSchema, EmailSchema, ExamplesSchema, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GoApiSchema, GoCliSchema, GoLoggingSchema, GoOrmSchema, GoWebFrameworkSchema, JobQueueSchema, LoggingSchema, ORMSchema, ObservabilitySchema, PackageManagerSchema, PaymentsSchema, PythonAiSchema, PythonOrmSchema, PythonQualitySchema, PythonTaskQueueSchema, PythonValidationSchema, PythonWebFrameworkSchema, RealtimeSchema, RuntimeSchema, RustApiSchema, RustCliSchema, RustFrontendSchema, RustLibrariesSchema, RustLoggingSchema, RustOrmSchema, RustWebFrameworkSchema, SearchSchema, ServerDeploySchema, StateManagementSchema, TestingSchema, UILibrarySchema, ValidationSchema, WebDeploySchema, analyzeStackCompatibility } from "@better-fullstack/types";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -114,6 +114,7 @@ const SCHEMA_MAP = {
 	rustApi: RustApiSchema,
 	rustCli: RustCliSchema,
 	rustLibraries: RustLibrariesSchema,
+	rustLogging: RustLoggingSchema,
 	pythonWebFramework: PythonWebFrameworkSchema,
 	pythonOrm: PythonOrmSchema,
 	pythonValidation: PythonValidationSchema,
@@ -165,7 +166,8 @@ const ECOSYSTEM_CATEGORIES = {
 		"rustOrm",
 		"rustApi",
 		"rustCli",
-		"rustLibraries"
+		"rustLibraries",
+		"rustLogging"
 	],
 	python: [
 		"pythonWebFramework",
@@ -302,6 +304,7 @@ function buildProjectConfig(input, overrides) {
 		rustApi: input.rustApi ?? "none",
 		rustCli: input.rustCli ?? "none",
 		rustLibraries: input.rustLibraries ?? [],
+		rustLogging: input.rustLogging ?? "none",
 		pythonWebFramework: input.pythonWebFramework ?? "none",
 		pythonOrm: input.pythonOrm ?? "none",
 		pythonValidation: input.pythonValidation ?? "none",
@@ -390,6 +393,7 @@ function buildCompatibilityInput(input) {
 		rustApi: input.rustApi ?? "none",
 		rustCli: input.rustCli ?? "none",
 		rustLibraries: (input.rustLibraries ?? []).join(",") || "none",
+		rustLogging: input.rustLogging ?? "none",
 		pythonWebFramework: input.pythonWebFramework ?? "none",
 		pythonOrm: input.pythonOrm ?? "none",
 		pythonValidation: input.pythonValidation ?? "none",
@@ -592,6 +596,7 @@ async function startMcpServer() {
 		rustApi: RustApiSchema.optional().describe("Rust API layer"),
 		rustCli: RustCliSchema.optional().describe("Rust CLI framework"),
 		rustLibraries: z.array(RustLibrariesSchema).optional().describe("Rust libraries"),
+		rustLogging: RustLoggingSchema.optional().describe("Rust logging library"),
 		pythonWebFramework: PythonWebFrameworkSchema.optional().describe("Python web framework"),
 		pythonOrm: PythonOrmSchema.optional().describe("Python ORM"),
 		pythonValidation: PythonValidationSchema.optional().describe("Python validation"),
@@ -671,7 +676,7 @@ async function startMcpServer() {
 			await writeBtsConfig(config);
 			let addonWarnings = [];
 			if (config.addons.length > 0 && config.addons[0] !== "none") {
-				const { setupAddons } = await import("./addons-setup-AbN693PV.mjs");
+				const { setupAddons } = await import("./addons-setup-CWGwxN68.mjs");
 				addonWarnings = await setupAddons(config);
 			}
 			const installCmd = getInstallCommand(input.ecosystem ?? "typescript", projectName, input.packageManager);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-fullstack",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Scaffold production-ready fullstack apps in seconds. Pick your stack from 270+ options — the CLI wires everything together.",
   "keywords": [
     "angular",
@@ -101,7 +101,7 @@
     "check-types": "tsc --noEmit",
     "test": "bun test ./test/*.test.ts",
     "test:watch": "bun test --watch",
-    "test:coverage": "bun test --coverage",
+    "test:coverage": "bun test --coverage ./test/*.test.ts",
     "test:ci": "CI=1 bun test --bail=5",
     "test:e2e": "E2E=1 bun test test/e2e/e2e.e2e.ts --timeout 600000",
     "test:integration": "bun test test/e2e/cli-interaction.test.ts test/e2e/cli-binary.test.ts",
@@ -112,10 +112,10 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.5.2",
-    "@better-fullstack/types": "^1.5.2",
+    "@better-fullstack/template-generator": "^1.5.3",
+    "@better-fullstack/types": "^1.5.3",
     "@clack/core": "^0.5.0",
-    "@clack/prompts": "^1.1.0",
+    "@clack/prompts": "^1.2.0",
     "@orpc/server": "^1.13.13",
     "consola": "^3.4.2",
     "env-paths": "^4.0.0",
@@ -127,7 +127,7 @@
     "oxfmt": "^0.19.0",
     "picocolors": "^1.1.1",
     "tinyglobby": "^0.2.15",
-    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "trpc-cli": "^0.12.1",
     "ts-morph": "^27.0.2",
     "yaml": "^2.8.3",
@@ -136,7 +136,7 @@
   "devDependencies": {
     "@types/bun": "^1.3.11",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.5.2",
     "publint": "^0.3.18",
     "tsdown": "^0.18.2",
     "typescript": "^5.9.3"

package/dist/addons-setup-AbN693PV.mjs

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-import "./bts-config-BCe8SqYV.mjs";
-import { i as setupLefthook, n as setupBiome, r as setupHusky, t as setupAddons } from "./addons-setup-1jZXP0D3.mjs";
-
-export { setupAddons };