create-better-fullstack 1.8.1 → 2.0.0

package/README.md

@@ -43,13 +43,27 @@ Configure your stack visually — pick every option from a UI, preview your choi
 --yolo             # Scaffold a random stack — good for exploring
 --template <name>  # Use a preset (t3, mern, pern, uniwind)
 --ecosystem <lang> # Start in typescript, react-native, rust, python, go, java, or elixir mode
+--part <binding>   # Add a multi-ecosystem stack part, e.g. frontend:typescript:next
 --version-channel  # Dependency channel: stable, latest, beta
 --no-git           # Skip git initialization
 --no-install       # Skip dependency installation
+--verify           # Run generated project checks without starting dev servers
 --package-manager  # Package manager (bun, pnpm, npm, yarn)
 --verbose          # Show detailed output
 ```
 
+## Multi-Ecosystem Example
+
+Use repeated `--part` flags to bind each generated app or capability to an ecosystem:
+
+```bash
+bun create better-fullstack@latest my-mixed-app \
+  --part frontend:typescript:next \
+  --part backend:go:gin \
+  --part backend.orm:go:gorm \
+  --part database:universal:postgres
+```
+
 ## Links
 
 - [Website](https://better-fullstack.dev)

package/dist/addons-setup-Ca069cmy.mjs

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

package/dist/{addons-setup-CUmA_nra.mjs → addons-setup-DHoByttt.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { s as dependencyVersionMap, t as readBtsConfig } from "./bts-config-YcroedMK.mjs";
+import { m as dependencyVersionMap, t as readBtsConfig } from "./bts-config-BMniWIbd.mjs";
 import { autocompleteMultiselect, cancel, group, isCancel, log, multiselect, select, spinner } from "@clack/prompts";
 import pc from "picocolors";
 import fs from "fs-extra";

package/dist/{bts-config-YcroedMK.mjs → bts-config-BMniWIbd.mjs}

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { t as __reExport } from "./chunk-CCII7kTE.mjs";
 import fs from "fs-extra";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -70,13 +71,169 @@ const getLatestCLIVersion = () => {
 	return fs.readJSONSync(packageJsonPath).version ?? "1.0.0";
 };
 
+//#endregion
+//#region src/types.ts
+var types_exports = {};
+import * as import__better_fullstack_types from "@better-fullstack/types";
+__reExport(types_exports, import__better_fullstack_types);
+
+//#endregion
+//#region src/utils/graph-summary.ts
+const FRONTEND_LABELS = {
+	next: "Next.js web app",
+	astro: "Astro web app",
+	"react-vite": "React + Vite app",
+	"react-router": "React Router app",
+	"tanstack-router": "TanStack Router app",
+	"tanstack-start": "TanStack Start app",
+	nuxt: "Nuxt app",
+	svelte: "SvelteKit app",
+	solid: "Solid app",
+	"solid-start": "SolidStart app",
+	qwik: "Qwik app",
+	angular: "Angular app",
+	redwood: "RedwoodJS app",
+	fresh: "Fresh app"
+};
+const BACKEND_LABELS = {
+	"rust:axum": "Rust Axum API",
+	"rust:actix-web": "Rust Actix Web API",
+	"rust:rocket": "Rust Rocket API",
+	"rust:warp": "Rust Warp API",
+	"rust:poem": "Rust Poem API",
+	"rust:salvo": "Rust Salvo API",
+	"python:fastapi": "Python FastAPI API",
+	"python:django": "Python Django API",
+	"python:flask": "Python Flask API",
+	"python:litestar": "Python Litestar API",
+	"go:gin": "Go Gin API",
+	"go:echo": "Go Echo API",
+	"go:fiber": "Go Fiber API",
+	"go:chi": "Go Chi API",
+	"java:spring-boot": "Java Spring Boot API",
+	"java:quarkus": "Java Quarkus API",
+	"elixir:phoenix": "Elixir Phoenix API",
+	"elixir:phoenix-live-view": "Elixir Phoenix LiveView API"
+};
+const TOOL_LABELS = {
+	postgres: "Postgres",
+	sqlite: "SQLite",
+	mysql: "MySQL",
+	mongodb: "MongoDB",
+	redis: "Redis",
+	edgedb: "EdgeDB",
+	gorm: "GORM",
+	sqlc: "sqlc",
+	ent: "Ent",
+	"ecto-sql": "Ecto SQL",
+	ecto: "Ecto",
+	sqlx: "SQLx",
+	"sea-orm": "SeaORM",
+	sqlalchemy: "SQLAlchemy",
+	sqlmodel: "SQLModel",
+	"django-orm": "Django ORM",
+	"spring-data-jpa": "Spring Data JPA"
+};
+function getSelectedGraphParts(config) {
+	return (config.stackParts ?? []).filter((part) => part.source !== "provided");
+}
+function getGraphPart(config, role, ecosystem) {
+	return getSelectedGraphParts(config).find((part) => part.role === role && (!ecosystem || part.ecosystem === ecosystem));
+}
+function hasGraphPart(config, role, ecosystem) {
+	return Boolean(getGraphPart(config, role, ecosystem));
+}
+function getPrimaryGraphPart(config, role, ecosystem) {
+	return getSelectedGraphParts(config).find((part) => part.role === role && !part.ownerPartId && (!ecosystem || part.ecosystem === ecosystem));
+}
+function getGraphBackendUrl(config) {
+	switch (getPrimaryGraphPart(config, "backend")?.ecosystem) {
+		case "elixir": return "http://localhost:4000";
+		case "rust": return "http://localhost:3000";
+		case "python": return "http://localhost:8000";
+		case "go":
+		case "java": return "http://localhost:8080";
+		default: return null;
+	}
+}
+function getEffectiveStack(config) {
+	const effectiveStack = {};
+	const parts = getSelectedGraphParts(config);
+	for (const part of parts) {
+		const key = part.ownerPartId ? `backend.${part.role}` : part.role;
+		effectiveStack[key] = `${part.ecosystem}:${part.toolId}`;
+	}
+	return effectiveStack;
+}
+function labelFor(part) {
+	if (!part) return null;
+	if (part.role === "frontend" && part.ecosystem === "typescript") return FRONTEND_LABELS[part.toolId] ?? `${part.toolId} web app`;
+	if (part.role === "backend") return BACKEND_LABELS[`${part.ecosystem}:${part.toolId}`] ?? `${part.ecosystem} ${part.toolId} API`;
+	return TOOL_LABELS[part.toolId] ?? part.toolId;
+}
+function getGraphSummary(config) {
+	const selectedParts = getSelectedGraphParts(config);
+	if (selectedParts.length === 0) return null;
+	const frontend = getPrimaryGraphPart(config, "frontend");
+	const backend = getPrimaryGraphPart(config, "backend");
+	const database = getPrimaryGraphPart(config, "database");
+	const orm = selectedParts.find((part) => part.role === "orm");
+	const segments = [labelFor(frontend), labelFor(backend)].filter(Boolean);
+	const dataLabel = [labelFor(orm), labelFor(database)].filter(Boolean).join("/");
+	if (dataLabel) segments.push(dataLabel);
+	return segments.length > 0 ? segments.join(" + ") : selectedParts.map((part) => (0, types_exports.formatStackPartSpec)(part, selectedParts)).join(" + ");
+}
+function getGraphBackendDeployInstructions(config) {
+	const backend = getPrimaryGraphPart(config, "backend");
+	if (!backend || config.serverDeploy === "none") return "";
+	const targetPath = backend.targetPath ?? "apps/server";
+	const backendLabel = labelFor(backend) ?? `${backend.ecosystem}:${backend.toolId}`;
+	switch (config.serverDeploy) {
+		case "railway": return [
+			"Server deployment with Railway:",
+			`* Backend: ${backendLabel}`,
+			`* Config: ${targetPath}/railway.toml`,
+			`* Deploy: cd ${targetPath} && railway up`
+		].join("\n");
+		case "docker": return [
+			"Server deployment with Docker:",
+			`* Backend: ${backendLabel}`,
+			`* Build: cd ${targetPath} && docker build -t better-fullstack-server .`
+		].join("\n");
+		case "fly": return [
+			"Server deployment with Fly:",
+			`* Backend: ${backendLabel}`,
+			`* Deploy: cd ${targetPath} && fly launch`
+		].join("\n");
+		case "vercel": return [
+			"Server deployment with Vercel:",
+			`* Backend: ${backendLabel}`,
+			`* Deploy from: ${targetPath}`
+		].join("\n");
+		case "cloudflare":
+		case "sst": return [
+			`Server deployment with ${config.serverDeploy}:`,
+			`* Backend: ${backendLabel}`,
+			`* Review generated files in ${targetPath}`
+		].join("\n");
+		default: return "";
+	}
+}
+
 //#endregion
 //#region src/utils/bts-config.ts
 const BTS_CONFIG_FILE = "bts.jsonc";
 async function writeBtsConfig(projectConfig) {
+	const stackParts = projectConfig.stackParts ?? (0, types_exports.legacyProjectConfigToStackParts)(projectConfig);
+	const graphSummary = projectConfig.stackParts ? getGraphSummary({ stackParts }) : null;
+	const effectiveStack = projectConfig.stackParts ? getEffectiveStack({ stackParts }) : void 0;
 	const btsConfig = {
 		version: getLatestCLIVersion(),
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		...graphSummary ? {
+			graphSummary,
+			effectiveStack
+		} : {},
 		ecosystem: projectConfig.ecosystem,
 		database: projectConfig.database,
 		orm: projectConfig.orm,
@@ -168,12 +325,17 @@ async function writeBtsConfig(projectConfig) {
 		elixirTesting: projectConfig.elixirTesting,
 		elixirQuality: projectConfig.elixirQuality,
 		elixirDeploy: projectConfig.elixirDeploy,
-		aiDocs: projectConfig.aiDocs
+		aiDocs: projectConfig.aiDocs,
+		stackParts
 	};
 	const baseContent = {
 		$schema: "https://better-fullstack-web.vercel.app/schema.json",
 		version: btsConfig.version,
 		createdAt: btsConfig.createdAt,
+		...btsConfig.graphSummary ? {
+			graphSummary: btsConfig.graphSummary,
+			effectiveStack: btsConfig.effectiveStack
+		} : {},
 		ecosystem: btsConfig.ecosystem,
 		database: btsConfig.database,
 		orm: btsConfig.orm,
@@ -265,7 +427,8 @@ async function writeBtsConfig(projectConfig) {
 		elixirTesting: btsConfig.elixirTesting,
 		elixirQuality: btsConfig.elixirQuality,
 		elixirDeploy: btsConfig.elixirDeploy,
-		aiDocs: btsConfig.aiDocs
+		aiDocs: btsConfig.aiDocs,
+		stackParts: btsConfig.stackParts
 	};
 	let configContent = JSON.stringify(baseContent);
 	const formatResult = JSONC.format(configContent, void 0, {
@@ -276,6 +439,7 @@ async function writeBtsConfig(projectConfig) {
 	configContent = JSONC.applyEdits(configContent, formatResult);
 	const finalContent = `// Better Fullstack configuration file
 // safe to delete
+${graphSummary ? "// For multi-ecosystem projects, graphSummary/effectiveStack and stackParts are the source of truth.\n// Legacy fields such as backend/orm may stay as compatibility fallbacks.\n" : ""}
 
 ${configContent}`;
 	const configPath = path.join(projectConfig.projectDir, BTS_CONFIG_FILE);
@@ -295,7 +459,19 @@ async function readBtsConfig(projectDir) {
 			console.warn("Warning: Found errors parsing bts.jsonc:", errors);
 			return null;
 		}
-		return config;
+		if (config.stackParts && config.stackParts.length > 0) {
+			const diagnostics = (0, types_exports.compareLegacyConfigToStackParts)(config, config.stackParts);
+			if (diagnostics.length > 0) console.warn(`Warning: bts.jsonc legacy fields differ from stackParts; using stackParts for ${diagnostics.map((diagnostic) => diagnostic.path).filter(Boolean).join(", ")}.`);
+			return {
+				...config,
+				...(0, types_exports.stackPartsToLegacyProjectConfigPartial)(config.stackParts),
+				stackParts: config.stackParts
+			};
+		}
+		return {
+			...config,
+			stackParts: (0, types_exports.legacyProjectConfigToStackParts)(config)
+		};
 	} catch {
 		return null;
 	}
@@ -318,4 +494,4 @@ async function updateBtsConfig(projectDir, updates) {
 }
 
 //#endregion
-export { DEFAULT_CONFIG as a, getDefaultConfig as c, getLatestCLIVersion as i, getUserPkgManager as l, updateBtsConfig as n, DEFAULT_UI_LIBRARY_BY_FRONTEND as o, writeBtsConfig as r, dependencyVersionMap as s, readBtsConfig as t };
+export { getGraphBackendUrl as a, getPrimaryGraphPart as c, getLatestCLIVersion as d, DEFAULT_CONFIG as f, getUserPkgManager as g, getDefaultConfig as h, getGraphBackendDeployInstructions as i, hasGraphPart as l, dependencyVersionMap as m, updateBtsConfig as n, getGraphPart as o, DEFAULT_UI_LIBRARY_BY_FRONTEND as p, writeBtsConfig as r, getGraphSummary as s, readBtsConfig as t, types_exports as u };

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-DoPutOIG.mjs").then((m) => m.startMcpServer());
+if (process.argv[2] === "mcp" && process.argv.length === 3) import("./mcp-YvDMaVXB.mjs").then((m) => m.startMcpServer());
 else import("./index.mjs").then((m) => m.createBtsCli().run());
 
 //#endregion

package/dist/index.d.mts

@@ -22,15 +22,17 @@ declare const router: {
   create: _orpc_server0.Procedure<_orpc_server0.MergedInitialContext<Record<never, never>, Record<never, never>, Record<never, never>>, Record<never, never>, z.ZodTuple<[z.ZodOptional<z.ZodString>, z.ZodObject<{
     template: z.ZodOptional<z.ZodEnum<{
       none: "none";
-      uniwind: "uniwind";
       mern: "mern";
       pern: "pern";
       t3: "t3";
+      uniwind: "uniwind";
     }>>;
     yes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     yolo: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    part: z.ZodOptional<z.ZodArray<z.ZodString>>;
     verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    verify: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     ecosystem: z.ZodOptional<z.ZodEnum<{
       typescript: "typescript";
       "react-native": "react-native";
@@ -238,9 +240,9 @@ declare const router: {
     }>>;
     mobileUI: z.ZodOptional<z.ZodEnum<{
       none: "none";
+      uniwind: "uniwind";
       tamagui: "tamagui";
       "gluestack-ui": "gluestack-ui";
-      uniwind: "uniwind";
       unistyles: "unistyles";
     }>>;
     mobileStorage: z.ZodOptional<z.ZodEnum<{
@@ -903,6 +905,17 @@ declare const router: {
       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;
+      stackParts?: {
+        id: string;
+        role: "api" | "runtime" | "backend" | "database" | "orm" | "auth" | "payments" | "email" | "logging" | "observability" | "stateManagement" | "forms" | "validation" | "testing" | "jobQueue" | "caching" | "i18n" | "search" | "fileStorage" | "cms" | "featureFlags" | "analytics" | "codeQuality" | "documentation" | "ai" | "frontend" | "mobile" | "deploy" | "ui" | "css" | "appPlatform";
+        toolId: string;
+        ecosystem: "typescript" | "react-native" | "rust" | "python" | "go" | "java" | "elixir" | "universal";
+        source: "selected" | "defaulted" | "provided" | "legacy" | "adjusted";
+        ownerPartId?: string | undefined;
+        providedByPartId?: string | undefined;
+        targetPath?: string | undefined;
+        settings?: Record<string, unknown> | undefined;
+      }[] | undefined;
     };
     reproducibleCommand: string;
     timeScaffolded: string;
@@ -1022,6 +1035,17 @@ declare const router: {
       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;
+      stackParts?: {
+        id: string;
+        role: "api" | "runtime" | "backend" | "database" | "orm" | "auth" | "payments" | "email" | "logging" | "observability" | "stateManagement" | "forms" | "validation" | "testing" | "jobQueue" | "caching" | "i18n" | "search" | "fileStorage" | "cms" | "featureFlags" | "analytics" | "codeQuality" | "documentation" | "ai" | "frontend" | "mobile" | "deploy" | "ui" | "css" | "appPlatform";
+        toolId: string;
+        ecosystem: "typescript" | "react-native" | "rust" | "python" | "go" | "java" | "elixir" | "universal";
+        source: "selected" | "defaulted" | "provided" | "legacy" | "adjusted";
+        ownerPartId?: string | undefined;
+        providedByPartId?: string | undefined;
+        targetPath?: string | undefined;
+        settings?: Record<string, unknown> | undefined;
+      }[] | undefined;
     };
     reproducibleCommand: string;
     timeScaffolded: string;
@@ -1154,6 +1178,17 @@ declare const router: {
       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;
+      stackParts?: {
+        id: string;
+        role: "api" | "runtime" | "backend" | "database" | "orm" | "auth" | "payments" | "email" | "logging" | "observability" | "stateManagement" | "forms" | "validation" | "testing" | "jobQueue" | "caching" | "i18n" | "search" | "fileStorage" | "cms" | "featureFlags" | "analytics" | "codeQuality" | "documentation" | "ai" | "frontend" | "mobile" | "deploy" | "ui" | "css" | "appPlatform";
+        toolId: string;
+        ecosystem: "typescript" | "react-native" | "rust" | "python" | "go" | "java" | "elixir" | "universal";
+        source: "selected" | "defaulted" | "provided" | "legacy" | "adjusted";
+        ownerPartId?: string | undefined;
+        providedByPartId?: string | undefined;
+        targetPath?: string | undefined;
+        settings?: Record<string, unknown> | undefined;
+      }[] | undefined;
     };
     reproducibleCommand: string;
     timeScaffolded: string;
@@ -1273,6 +1308,17 @@ declare const router: {
       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;
+      stackParts?: {
+        id: string;
+        role: "api" | "runtime" | "backend" | "database" | "orm" | "auth" | "payments" | "email" | "logging" | "observability" | "stateManagement" | "forms" | "validation" | "testing" | "jobQueue" | "caching" | "i18n" | "search" | "fileStorage" | "cms" | "featureFlags" | "analytics" | "codeQuality" | "documentation" | "ai" | "frontend" | "mobile" | "deploy" | "ui" | "css" | "appPlatform";
+        toolId: string;
+        ecosystem: "typescript" | "react-native" | "rust" | "python" | "go" | "java" | "elixir" | "universal";
+        source: "selected" | "defaulted" | "provided" | "legacy" | "adjusted";
+        ownerPartId?: string | undefined;
+        providedByPartId?: string | undefined;
+        targetPath?: string | undefined;
+        settings?: Record<string, unknown> | undefined;
+      }[] | undefined;
     };
     reproducibleCommand: string;
     timeScaffolded: string;