create-better-fullstack 1.1.16 → 1.2.0

package/README.md

@@ -33,7 +33,7 @@ Options:
   --runtime <runtime>             Runtime (bun, node, workers, none)
   --api <type>                    API type (trpc, orpc, ts-rest, garph, none)
   --addons <types...>             Additional addons
-  --examples <types...>           Examples to include (todo, ai, none)
+  --examples <types...>           Examples to include (ai, none)
   --git / --no-git                Initialize git repository
   --package-manager <pm>          Package manager (npm, pnpm, bun)
   --install / --no-install        Install dependencies

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -236,7 +236,6 @@ declare const router: {
     }>>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodEnum<{
       none: "none";
-      todo: "todo";
       ai: "ai";
     }>>>;
     git: z.ZodOptional<z.ZodBoolean>;
@@ -419,6 +418,12 @@ declare const router: {
       none: "none";
       zap: "zap";
     }>>;
+    aiDocs: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      none: "none";
+      "claude-md": "claude-md";
+      "agents-md": "agents-md";
+      cursorrules: "cursorrules";
+    }>>>;
   }, z.core.$strip>], null>, _orpc_server0.Schema<{
     success: boolean;
     projectConfig: {
@@ -432,7 +437,7 @@ declare const router: {
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
       addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook")[];
-      examples: ("ai" | "none" | "todo")[];
+      examples: ("ai" | "none")[];
       auth: "none" | "better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;
@@ -480,6 +485,7 @@ declare const router: {
       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;
     };
     reproducibleCommand: string;
@@ -510,7 +516,7 @@ declare const router: {
       runtime: "none" | "bun" | "node" | "workers";
       frontend: ("none" | "tanstack-router" | "react-router" | "tanstack-start" | "next" | "nuxt" | "native-bare" | "native-uniwind" | "native-unistyles" | "svelte" | "solid" | "astro" | "qwik" | "angular" | "redwood" | "fresh")[];
       addons: ("none" | "pwa" | "tauri" | "starlight" | "biome" | "lefthook" | "husky" | "ruler" | "turborepo" | "fumadocs" | "ultracite" | "oxlint" | "opentui" | "wxt" | "msw" | "storybook")[];
-      examples: ("ai" | "none" | "todo")[];
+      examples: ("ai" | "none")[];
       auth: "none" | "better-auth" | "clerk" | "nextauth" | "stack-auth" | "supabase-auth" | "auth0";
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;
@@ -558,6 +564,7 @@ declare const router: {
       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;
     };
     reproducibleCommand: string;
@@ -642,6 +649,7 @@ declare function createVirtual(options: Partial<Omit<types_d_exports.ProjectConf
 }>;
 type API = import__better_fullstack_types.API;
 type Addons = import__better_fullstack_types.Addons;
+type AiDocs = import__better_fullstack_types.AiDocs;
 type Analytics = import__better_fullstack_types.Analytics;
 type Animation = import__better_fullstack_types.Animation;
 type Auth = import__better_fullstack_types.Auth;
@@ -686,4 +694,4 @@ 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 Addons, 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, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };
+export { type API, 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, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };

package/dist/index.mjs

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

package/dist/{src-DDAojCKV.mjs → src-BJjCw5ar.mjs}

@@ -266,7 +266,8 @@ const DEFAULT_CONFIG_BASE = {
 	goOrm: "gorm",
 	goApi: "none",
 	goCli: "none",
-	goLogging: "zap"
+	goLogging: "zap",
+	aiDocs: ["claude-md"]
 };
 function getDefaultConfig() {
 	return {
@@ -277,7 +278,8 @@ function getDefaultConfig() {
 		addons: [...DEFAULT_CONFIG_BASE.addons],
 		examples: [...DEFAULT_CONFIG_BASE.examples],
 		rustLibraries: [...DEFAULT_CONFIG_BASE.rustLibraries],
-		pythonAi: [...DEFAULT_CONFIG_BASE.pythonAi]
+		pythonAi: [...DEFAULT_CONFIG_BASE.pythonAi],
+		aiDocs: [...DEFAULT_CONFIG_BASE.aiDocs]
 	};
 }
 const DEFAULT_CONFIG = getDefaultConfig();
@@ -950,11 +952,6 @@ function allowedApisForFrontends(frontends = [], astroIntegration) {
 	if (includesAstro && astroIntegration && astroIntegration !== "react") return ["orpc", "none"];
 	return base;
 }
-function isExampleTodoAllowed(backend, database, api) {
-	if (backend === "convex") return true;
-	if (database === "none" || api === "none") return false;
-	return true;
-}
 function isExampleAIAllowed(backend, frontends = []) {
 	if (frontends.includes("solid")) return false;
 	if (backend === "convex") {
@@ -995,13 +992,9 @@ function validatePaymentsCompatibility(payments, auth, _backend, frontends = [])
 		if (web.length === 0 && frontends.length > 0) exitWithError("Polar payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.");
 	}
 }
-function validateExamplesCompatibility(examples, backend, database, frontend, api) {
+function validateExamplesCompatibility(examples, backend, frontend) {
 	const examplesArr = examples ?? [];
 	if (examplesArr.length === 0 || examplesArr.includes("none")) return;
-	if (examplesArr.includes("todo") && backend !== "convex") {
-		if (database === "none") exitWithError("The 'todo' example requires a database. Cannot use --examples todo when database is 'none'.");
-		if (api === "none") exitWithError("The 'todo' example requires an API layer (tRPC or oRPC). Cannot use --examples todo when api is 'none'.");
-	}
 	if (examplesArr.includes("ai") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
 	if (examplesArr.includes("ai") && backend === "convex") {
 		const frontendArr = frontend ?? [];
@@ -1546,6 +1539,42 @@ async function getAIChoice(ai) {
 	return response;
 }
 
+//#endregion
+//#region src/prompts/ai-docs.ts
+const AI_DOCS_OPTIONS = [
+	{
+		value: "claude-md",
+		label: "CLAUDE.md",
+		hint: "Claude Code CLI documentation"
+	},
+	{
+		value: "agents-md",
+		label: "Agents.md",
+		hint: "Generic AI assistant documentation"
+	},
+	{
+		value: "cursorrules",
+		label: ".cursorrules",
+		hint: "Cursor IDE rules file"
+	},
+	{
+		value: "none",
+		label: "None",
+		hint: "Skip AI documentation"
+	}
+];
+async function getAiDocsChoice(aiDocs) {
+	if (aiDocs !== void 0) return aiDocs;
+	const response = await navigableMultiselect({
+		message: "Generate AI documentation files?",
+		options: AI_DOCS_OPTIONS,
+		initialValues: DEFAULT_CONFIG.aiDocs
+	});
+	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (response.includes("none")) return [];
+	return response;
+}
+
 //#endregion
 //#region src/prompts/animation.ts
 async function getAnimationChoice(animation, frontends) {
@@ -2237,16 +2266,11 @@ async function getEmailChoice(email, backend) {
 
 //#endregion
 //#region src/prompts/examples.ts
-async function getExamplesChoice(examples, database, frontends, backend, api) {
+async function getExamplesChoice(examples, frontends, backend) {
 	if (examples !== void 0) return examples;
 	if (backend === "none") return [];
 	let response = [];
 	const options = [];
-	if (isExampleTodoAllowed(backend, database, api)) options.push({
-		value: "todo",
-		label: "Todo App",
-		hint: "A simple CRUD example app"
-	});
 	if (isExampleAIAllowed(backend, frontends ?? [])) options.push({
 		value: "ai",
 		label: "AI Chat",
@@ -2691,6 +2715,18 @@ async function getinstallChoice(install, ecosystem) {
 		if (isCancel$1(response$1)) return exitCancelled("Operation cancelled");
 		return response$1;
 	}
+	if (ecosystem === "go") {
+		if (!await commandExists("go")) {
+			log.warn("Go is not installed. Please install Go from https://go.dev/dl/");
+			return false;
+		}
+		const response$1 = await navigableConfirm({
+			message: "Run go mod tidy?",
+			initialValue: DEFAULT_CONFIG.install
+		});
+		if (isCancel$1(response$1)) return exitCancelled("Operation cancelled");
+		return response$1;
+	}
 	const response = await navigableConfirm({
 		message: "Install dependencies?",
 		initialValue: DEFAULT_CONFIG.install
@@ -3772,7 +3808,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		},
 		examples: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve([]);
-			return getExamplesChoice(flags.examples, results.database, results.frontend, results.backend, results.api);
+			return getExamplesChoice(flags.examples, results.frontend, results.backend);
 		},
 		dbSetup: ({ results }) => {
 			if (results.ecosystem !== "typescript") return Promise.resolve("none");
@@ -3922,6 +3958,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 			if (results.ecosystem !== "go") return Promise.resolve("none");
 			return getGoLoggingChoice(flags.goLogging);
 		},
+		aiDocs: () => getAiDocsChoice(flags.aiDocs),
 		git: () => getGitChoice(flags.git),
 		packageManager: ({ results }) => {
 			if (results.ecosystem === "rust" || results.ecosystem === "python" || results.ecosystem === "go") return Promise.resolve("npm");
@@ -3988,7 +4025,8 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		goOrm: result.goOrm,
 		goApi: result.goApi,
 		goCli: result.goCli,
-		goLogging: result.goLogging
+		goLogging: result.goLogging,
+		aiDocs: result.aiDocs
 	};
 }
 
@@ -4159,6 +4197,11 @@ function generateReproducibleCommand(config) {
 	flags.push(`--db-setup ${config.dbSetup}`);
 	flags.push(`--web-deploy ${config.webDeploy}`);
 	flags.push(`--server-deploy ${config.serverDeploy}`);
+	if (config.aiDocs && config.aiDocs.length > 0) {
+		const validDocs = config.aiDocs.filter((d) => d !== "none");
+		if (validDocs.length > 0) flags.push(`--ai-docs ${validDocs.join(" ")}`);
+		else flags.push("--ai-docs none");
+	} else flags.push("--ai-docs none");
 	flags.push(config.git ? "--git" : "--no-git");
 	flags.push(`--package-manager ${config.packageManager}`);
 	flags.push(config.install ? "--install" : "--no-install");
@@ -4297,7 +4340,7 @@ const TEMPLATE_PRESETS = {
 		auth: "better-auth",
 		payments: "none",
 		addons: ["turborepo"],
-		examples: ["todo"],
+		examples: ["none"],
 		dbSetup: "mongodb-atlas",
 		webDeploy: "none",
 		serverDeploy: "none"
@@ -4312,7 +4355,7 @@ const TEMPLATE_PRESETS = {
 		auth: "better-auth",
 		payments: "none",
 		addons: ["turborepo"],
-		examples: ["todo"],
+		examples: ["none"],
 		dbSetup: "none",
 		webDeploy: "none",
 		serverDeploy: "none"
@@ -4420,6 +4463,7 @@ function processFlags(options, projectName) {
 	if (options.uiLibrary) config.uiLibrary = options.uiLibrary;
 	if (options.addons && options.addons.length > 0) config.addons = processArrayOption(options.addons);
 	if (options.examples && options.examples.length > 0) config.examples = processArrayOption(options.examples);
+	if (options.aiDocs !== void 0) config.aiDocs = processArrayOption(options.aiDocs);
 	return config;
 }
 function getProvidedFlags(options) {
@@ -4880,11 +4924,7 @@ function validateFrontendConstraints(config, providedFlags) {
 	const hasWebFrontendFlag = (frontend ?? []).some((f) => isWebFrontend(f));
 	validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
 }
-function validateApiConstraints(config, options) {
-	if (config.api === "none") {
-		if (options.examples?.includes("todo") && options.backend !== "convex" && options.backend !== "none") exitWithError("Cannot use '--examples todo' when '--api' is set to 'none'. The todo example requires an API layer. Please remove 'todo' from --examples or choose an API type.");
-	}
-}
+function validateApiConstraints(_config, _options) {}
 function validateFullConfig(config, providedFlags, options) {
 	validateDatabaseOrmAuth(config, providedFlags);
 	validateDatabaseSetup(config, providedFlags);
@@ -4895,7 +4935,7 @@ function validateFullConfig(config, providedFlags, options) {
 	validateAdonisJSConstraints(config, providedFlags);
 	validateBackendConstraints(config, providedFlags, options);
 	validateFrontendConstraints(config, providedFlags);
-	validateApiConstraints(config, options);
+	/* @__PURE__ */ validateApiConstraints(config, options);
 	validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
 	validateSelfBackendCompatibility(providedFlags, options, config);
 	validateWorkersCompatibility(providedFlags, options, config);
@@ -4905,7 +4945,7 @@ function validateFullConfig(config, providedFlags, options) {
 		validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
 		config.addons = [...new Set(config.addons)];
 	}
-	validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
+	validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? []);
 	validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend ?? []);
 	validateNextAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 	validateStackAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
@@ -4926,7 +4966,7 @@ function validateConfigForProgrammaticUse(config) {
 		validateSupabaseAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 		validateAuth0Compatibility(config.auth, config.backend, config.frontend ?? []);
 		if (config.addons && config.addons.length > 0) validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-		validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
+		validateExamplesCompatibility(config.examples ?? [], config.backend, config.frontend ?? []);
 		validateUILibraryFrontendCompatibility(config.uiLibrary, config.frontend ?? [], config.astroIntegration);
 		validateUILibraryCSSFrameworkCompatibility(config.uiLibrary, config.cssFramework);
 		validatePeerDependencies(config);
@@ -5074,7 +5114,8 @@ async function writeBtsConfig(projectConfig) {
 		goOrm: projectConfig.goOrm,
 		goApi: projectConfig.goApi,
 		goCli: projectConfig.goCli,
-		goLogging: projectConfig.goLogging
+		goLogging: projectConfig.goLogging,
+		aiDocs: projectConfig.aiDocs
 	};
 	const baseContent = {
 		$schema: "https://better-fullstack-web.vercel.app/schema.json",
@@ -5132,7 +5173,8 @@ async function writeBtsConfig(projectConfig) {
 		goOrm: btsConfig.goOrm,
 		goApi: btsConfig.goApi,
 		goCli: btsConfig.goCli,
-		goLogging: btsConfig.goLogging
+		goLogging: btsConfig.goLogging,
+		aiDocs: btsConfig.aiDocs
 	};
 	let configContent = JSON.stringify(baseContent);
 	const formatResult = JSONC.format(configContent, void 0, {
@@ -6983,6 +7025,20 @@ async function runUvSync({ projectDir }) {
 		if (error instanceof Error) consola.error(pc.red(`uv sync error: ${error.message}`));
 	}
 }
+async function runGoModTidy({ projectDir }) {
+	const s = spinner();
+	try {
+		s.start("Running go mod tidy...");
+		await $({
+			cwd: projectDir,
+			stderr: "inherit"
+		})`go mod tidy`;
+		s.stop("Go dependencies installed successfully");
+	} catch (error) {
+		s.stop(pc.red("go mod tidy failed"));
+		if (error instanceof Error) consola.error(pc.red(`go mod tidy error: ${error.message}`));
+	}
+}
 
 //#endregion
 //#region src/utils/docker-utils.ts
@@ -7042,6 +7098,14 @@ async function displayPostInstallInstructions(config) {
 		displayRustInstructions(config);
 		return;
 	}
+	if (ecosystem === "go") {
+		displayGoInstructions(config);
+		return;
+	}
+	if (ecosystem === "python") {
+		displayPythonInstructions(config);
+		return;
+	}
 	const isConvex = backend === "convex";
 	const isBackendSelf = backend === "self";
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager === "pnpm" ? "pnpm run" : "bun run";
@@ -7251,6 +7315,87 @@ function displayRustInstructions(config) {
 	output += pc.cyan("https://github.com/Marve10s/Better-Fullstack");
 	consola$1.box(output);
 }
+function displayGoInstructions(config) {
+	const { relativePath, depsInstalled, goWebFramework, goOrm, goApi, goCli, goLogging } = config;
+	const cdCmd = `cd ${relativePath}`;
+	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
+	let stepCounter = 2;
+	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} go mod tidy\n`;
+	output += `${pc.cyan(`${stepCounter++}.`)} go run cmd/server/main.go\n`;
+	output += `\n${pc.bold("Your Go project includes:")}\n`;
+	if (goWebFramework && goWebFramework !== "none") output += `${pc.cyan("•")} Web Framework: ${{
+		gin: "Gin",
+		echo: "Echo"
+	}[goWebFramework] || goWebFramework}\n`;
+	if (goOrm && goOrm !== "none") output += `${pc.cyan("•")} Database: ${{
+		gorm: "GORM",
+		sqlc: "sqlc"
+	}[goOrm] || goOrm}\n`;
+	if (goApi && goApi !== "none") output += `${pc.cyan("•")} API: ${{ "grpc-go": "gRPC-Go" }[goApi] || goApi}\n`;
+	if (goCli && goCli !== "none") output += `${pc.cyan("•")} CLI: ${{
+		cobra: "Cobra",
+		bubbletea: "Bubble Tea"
+	}[goCli] || goCli}\n`;
+	if (goLogging && goLogging !== "none") output += `${pc.cyan("•")} Logging: ${{ zap: "Zap" }[goLogging] || goLogging}\n`;
+	output += `\n${pc.bold("Common Go commands:")}\n`;
+	output += `${pc.cyan("•")} Build: go build ./...\n`;
+	output += `${pc.cyan("•")} Run: go run cmd/server/main.go\n`;
+	output += `${pc.cyan("•")} Test: go test ./...\n`;
+	output += `${pc.cyan("•")} Tidy: go mod tidy\n`;
+	output += `${pc.cyan("•")} Format: go fmt ./...\n`;
+	output += `${pc.cyan("•")} Lint: golangci-lint run\n`;
+	output += `\n${pc.bold("Your project will be available at:")}\n`;
+	output += `${pc.cyan("•")} API: http://localhost:8080\n`;
+	if (goApi === "grpc-go") output += `${pc.cyan("•")} gRPC: localhost:50051\n`;
+	output += `\n${pc.bold("Like Better Fullstack?")} Please consider giving us a star\n   on GitHub:\n`;
+	output += pc.cyan("https://github.com/Marve10s/Better-Fullstack");
+	consola$1.box(output);
+}
+function displayPythonInstructions(config) {
+	const { relativePath, depsInstalled, pythonWebFramework, pythonOrm, pythonValidation, pythonAi, pythonTaskQueue, pythonQuality } = config;
+	const cdCmd = `cd ${relativePath}`;
+	let runCommand = "uv run uvicorn app.main:app --reload";
+	if (pythonWebFramework === "django") runCommand = "uv run python manage.py runserver";
+	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
+	let stepCounter = 2;
+	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} uv sync\n`;
+	output += `${pc.cyan(`${stepCounter++}.`)} ${runCommand}\n`;
+	output += `\n${pc.bold("Your Python project includes:")}\n`;
+	if (pythonWebFramework && pythonWebFramework !== "none") output += `${pc.cyan("•")} Web Framework: ${{
+		fastapi: "FastAPI",
+		django: "Django"
+	}[pythonWebFramework] || pythonWebFramework}\n`;
+	if (pythonOrm && pythonOrm !== "none") output += `${pc.cyan("•")} ORM: ${{
+		sqlalchemy: "SQLAlchemy",
+		sqlmodel: "SQLModel"
+	}[pythonOrm] || pythonOrm}\n`;
+	if (pythonValidation && pythonValidation !== "none") output += `${pc.cyan("•")} Validation: ${{ pydantic: "Pydantic" }[pythonValidation] || pythonValidation}\n`;
+	if (pythonAi && pythonAi.length > 0 && !pythonAi.includes("none")) {
+		const aiNames = {
+			langchain: "LangChain",
+			langgraph: "LangGraph",
+			llamaindex: "LlamaIndex",
+			"openai-sdk": "OpenAI SDK",
+			"anthropic-sdk": "Anthropic SDK",
+			crewai: "CrewAI"
+		};
+		const aiList = pythonAi.filter((ai) => ai !== "none").map((ai) => aiNames[ai] || ai).join(", ");
+		output += `${pc.cyan("•")} AI: ${aiList}\n`;
+	}
+	if (pythonTaskQueue && pythonTaskQueue !== "none") output += `${pc.cyan("•")} Task Queue: ${{ celery: "Celery" }[pythonTaskQueue] || pythonTaskQueue}\n`;
+	if (pythonQuality && pythonQuality !== "none") output += `${pc.cyan("•")} Code Quality: ${{ ruff: "Ruff" }[pythonQuality] || pythonQuality}\n`;
+	output += `\n${pc.bold("Common Python commands:")}\n`;
+	output += `${pc.cyan("•")} Install: uv sync\n`;
+	output += `${pc.cyan("•")} Run: ${runCommand}\n`;
+	output += `${pc.cyan("•")} Test: uv run pytest\n`;
+	output += `${pc.cyan("•")} Format: uv run ruff format .\n`;
+	output += `${pc.cyan("•")} Lint: uv run ruff check .\n`;
+	output += `\n${pc.bold("Your project will be available at:")}\n`;
+	output += `${pc.cyan("•")} API: http://localhost:8000\n`;
+	output += `\n${pc.bold("Like Better Fullstack?")} Please consider giving us a star\n   on GitHub:\n`;
+	output += pc.cyan("https://github.com/Marve10s/Better-Fullstack");
+	consola$1.box(output);
+}
 
 //#endregion
 //#region src/helpers/core/create-project.ts
@@ -7277,6 +7422,7 @@ async function createProject(options, cliInput = {}) {
 		});
 		if (options.install && options.ecosystem === "rust") await runCargoBuild({ projectDir });
 		if (options.install && options.ecosystem === "python") await runUvSync({ projectDir });
+		if (options.install && options.ecosystem === "go") await runGoModTidy({ projectDir });
 		await initializeGit(projectDir, options.git);
 		if (!isSilent()) await displayPostInstallInstructions({
 			...options,
@@ -7406,7 +7552,8 @@ async function createProjectHandler(input, options = {}) {
 						goOrm: "none",
 						goApi: "none",
 						goCli: "none",
-						goLogging: "none"
+						goLogging: "none",
+						aiDocs: []
 					},
 					reproducibleCommand: "",
 					timeScaffolded,
@@ -7678,7 +7825,8 @@ const router = os.router({
 		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)"),
-		goLogging: types_exports.GoLoggingSchema.optional().describe("Go logging (zap)")
+		goLogging: types_exports.GoLoggingSchema.optional().describe("Go logging (zap)"),
+		aiDocs: z.array(types_exports.AiDocsSchema).optional().describe("AI documentation files (claude-md, agents-md, cursorrules)")
 	})])).handler(async ({ input }) => {
 		const [projectName, options] = input;
 		const result = await createProjectHandler({
@@ -7878,7 +8026,8 @@ async function createVirtual(options) {
 				goOrm: options.goOrm || "none",
 				goApi: options.goApi || "none",
 				goCli: options.goCli || "none",
-				goLogging: options.goLogging || "none"
+				goLogging: options.goLogging || "none",
+				aiDocs: options.aiDocs || ["claude-md"]
 			},
 			templates: EMBEDDED_TEMPLATES
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-fullstack",
-  "version": "1.1.16",
+  "version": "1.2.0",
   "description": "A CLI-first toolkit for building Full Stack applications. Skip the configuration. Ship the code.",
   "keywords": [
     "better-auth",
@@ -76,8 +76,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.1.16",
-    "@better-fullstack/types": "^1.1.16",
+    "@better-fullstack/template-generator": "^1.2.0",
+    "@better-fullstack/types": "^1.2.0",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.0.0-alpha.8",
     "@orpc/server": "^1.13.0",