@prisma/cli 3.0.0-dev.69.1 → 3.0.0-dev.71.1

package/dist/commands/app/index.js

@@ -65,7 +65,7 @@ function createDeployCommand(runtime) {
 		"hono",
 		"tanstack-start",
 		"bun"
-	])).addOption(new Option("--entry <path>", "Entrypoint path for Bun deploys")).addOption(new Option("--http-port <port>", "HTTP port override for the deployed app")).addOption(new Option("--env <name=value|file>", "Environment variable assignment or dotenv file").argParser(collectRepeatableValues)).addOption(new Option("--db", "Create and wire an isolated database for the preview Branch")).addOption(new Option("--no-db", "Skip branch database setup")).addOption(new Option("--prod", "Confirm intent to deploy to production"));
+	])).addOption(new Option("--entry <path>", "Entrypoint path for Bun deploys")).addOption(new Option("--http-port <port>", "HTTP port override for the deployed app")).addOption(new Option("--env <name=value|file>", "Environment variable assignment or dotenv file").argParser(collectRepeatableValues)).addOption(new Option("--db", "Create and wire a Prisma Postgres database for this deploy target")).addOption(new Option("--no-db", "Skip database setup")).addOption(new Option("--prod", "Confirm intent to deploy to production"));
 	addGlobalFlags(command);
 	command.action(async (options) => {
 		const appName = options.app;
@@ -80,7 +80,7 @@ function createDeployCommand(runtime) {
 		const db = options.db;
 		const hasDbConflict = hasFlag(runtime.argv, "--db") && hasFlag(runtime.argv, "--no-db");
 		await runCommand(runtime, "app.deploy", options, (context) => {
-			if (hasDbConflict) throw usageError("app deploy accepts either --db or --no-db", "--db requests branch database setup, while --no-db disables it.", "Pass exactly one database setup flag.", ["prisma-cli app deploy --db", "prisma-cli app deploy --no-db"], "app");
+			if (hasDbConflict) throw usageError("app deploy accepts either --db or --no-db", "--db requests database setup, while --no-db disables it.", "Pass exactly one database setup flag.", ["prisma-cli app deploy --db", "prisma-cli app deploy --no-db"], "app");
 			return runAppDeploy(context, appName, {
 				projectRef,
 				createProjectName,

package/dist/controllers/app.js

@@ -17,6 +17,7 @@ import { buildProjectSetupNextActions, inferTargetName, projectNotFoundError, re
 import { bindProjectToDirectory, projectCreateFailedError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
 import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
 import { readLocalGitBranch } from "../lib/git/local-branch.js";
+import { resolveOrCreatePreviewBuildSettings } from "../lib/app/preview-build-settings.js";
 import { PREVIEW_BUILD_TYPES, RESOLVED_PREVIEW_BUILD_TYPES, executePreviewBuild } from "../lib/app/preview-build.js";
 import { PREVIEW_DEFAULT_REGION } from "../lib/app/preview-interaction.js";
 import { maybeSetupBranchDatabase } from "../lib/app/branch-database-deploy.js";
@@ -161,7 +162,7 @@ async function runAppDeploy(context, appName, options) {
 	});
 	framework = customized.framework;
 	runtime = customized.runtime;
-	await enforceProductionDeployGate(context, provider, {
+	const productionDeployGate = await enforceProductionDeployGate(context, provider, {
 		appId: selectedApp.appId,
 		appName: selectedApp.displayName,
 		branchKind: target.branch.kind,
@@ -170,10 +171,17 @@ async function runAppDeploy(context, appName, options) {
 	const buildType = framework.buildType;
 	assertSupportedEntrypoint(buildType, options?.entrypoint, "deploy");
 	const entrypoint = await resolveDeployEntrypoint(context.runtime.cwd, framework, options?.entrypoint, context.runtime.signal);
+	const buildSettingsResolution = await resolveOrCreatePreviewBuildSettings({
+		appPath: context.runtime.cwd,
+		buildType,
+		signal: context.runtime.signal
+	});
+	maybeRenderDeployBuildSettings(context, buildSettingsResolution);
 	const portMapping = parseDeployPortMapping(String(runtime.port));
 	const branchDatabaseSetup = await maybeSetupBranchDatabase(context, provider, projectId, toBranchDatabaseDeployBranch(target.branch), {
 		db: options?.db,
-		providedEnvVars: envVars
+		providedEnvVars: envVars,
+		firstProductionDeploy: productionDeployGate.firstProductionDeploy
 	});
 	const progressState = createPreviewDeployProgressState();
 	const deployStartedAt = Date.now();
@@ -186,6 +194,7 @@ async function runAppDeploy(context, appName, options) {
 		region: selectedApp.region,
 		entrypoint,
 		buildType,
+		buildSettings: buildSettingsResolution.settings,
 		portMapping,
 		envVars,
 		interaction: void 0,
@@ -214,6 +223,18 @@ async function runAppDeploy(context, appName, options) {
 			},
 			deployment: deployResult.deployment,
 			deploySettings: {
+				config: {
+					path: buildSettingsResolution.relativeConfigPath,
+					status: buildSettingsResolution.status
+				},
+				buildCommand: {
+					value: buildSettingsResolution.settings.buildCommand,
+					source: buildSettingsResolution.settings.buildCommandSource
+				},
+				outputDirectory: {
+					value: buildSettingsResolution.settings.outputDirectory,
+					source: buildSettingsResolution.settings.outputDirectorySource
+				},
 				framework: {
 					key: framework.key,
 					buildType,
@@ -1603,7 +1624,6 @@ async function detectNextConfig(cwd, signal) {
 	for (const candidate of [
 		"next.config.js",
 		"next.config.mjs",
-		"next.config.cjs",
 		"next.config.ts",
 		"next.config.mts"
 	]) {
@@ -1696,6 +1716,20 @@ async function maybeRenderDeploySetupBlock(context, details) {
 	const prefix = details.includeDirectory ? `Deploying ${directory} to` : "Deploying to";
 	context.output.stderr.write(`${prefix} ${details.projectName} / ${details.branchName} / ${details.appName}\n\n`);
 }
+function maybeRenderDeployBuildSettings(context, resolution) {
+	if (context.flags.json || context.flags.quiet) return;
+	const settings = resolution.settings;
+	const title = resolution.status === "created" ? `Created ${resolution.relativeConfigPath}` : `Using ${resolution.relativeConfigPath}`;
+	context.output.stderr.write(`${title}\n${renderDeployOutputRows(context.ui, [{
+		label: "Build Command",
+		value: settings.buildCommand ?? "none",
+		origin: settings.buildCommandSource ?? void 0
+	}, {
+		label: "Output Directory",
+		value: settings.outputDirectory,
+		origin: settings.outputDirectorySource ?? void 0
+	}]).join("\n")}\n\n`);
+}
 function maybeRenderProjectLinked(context, directory, projectName, localPinPath) {
 	if (context.flags.json || context.flags.quiet) return;
 	context.output.stderr.write(`${context.ui.success("✔")} Linked "${directory}" to Project "${projectName}"\nSaved ${localPinPath}\n\n`);

package/dist/lib/app/branch-database-deploy.js

@@ -9,65 +9,65 @@ import path from "node:path";
 async function maybeSetupBranchDatabase(context, provider, projectId, branch, options) {
 	if (options.db === false) return emptyBranchDatabaseSetupOutcome();
 	if (hasProvidedDatabaseEnvVars(options.providedEnvVars)) {
-		if (options.db === true) throw usageError("Branch database setup cannot be combined with provided database env vars", "The deploy command received --db and a DATABASE_URL or DIRECT_URL value from --env.", "Remove the --env database value to let --db create a branch override, or remove --db to deploy with the provided value.", ["prisma-cli app deploy --db", "prisma-cli app deploy --env DATABASE_URL=postgresql://example"], "app");
+		if (options.db === true) throw usageError("Database setup cannot be combined with provided database env vars", "The deploy command received --db and a DATABASE_URL or DIRECT_URL value from --env.", "Remove the --env database value to let --db create and wire a database, or remove --db to deploy with the provided value.", ["prisma-cli app deploy --db", "prisma-cli app deploy --env DATABASE_URL=postgresql://example"], "app");
 		return emptyBranchDatabaseSetupOutcome();
 	}
-	if (branch.kind === "production") {
-		if (options.db === true) throw usageError("Branch database setup is only available for preview branches", "Production database wiring is a durable environment decision and is not created implicitly by app deploy.", "Use project env commands to manage production DATABASE_URL, or deploy a preview branch with --db.", ["prisma-cli project env add DATABASE_URL=<value> --role production", "prisma-cli app deploy --branch feature/db --db"], "app");
+	if (branch.kind === "production" && !options.firstProductionDeploy) {
+		if (options.db === true) throw productionDatabaseSetupAfterFirstDeployError();
 		return emptyBranchDatabaseSetupOutcome();
 	}
-	const localSignal = await inspectBranchDatabaseSignal(context.runtime.cwd, context.runtime.signal);
-	const envState = await inspectBranchDatabaseEnv(provider, projectId, branch.id, context.runtime.signal);
-	const branchEnvVars = [envState.branchDatabaseUrl, envState.branchDirectUrl].filter((variable) => Boolean(variable)).map((variable) => variable.key).sort();
-	if (envState.branchDatabaseUrl) {
-		const warning = options.db === true ? `Branch "${branch.name}" already has DATABASE_URL. Leaving branch database env vars unchanged.` : null;
+	const envState = await inspectBranchDatabaseEnv(provider, projectId, branch, context.runtime.signal);
+	const targetEnvVars = getTargetDatabaseEnvVarKeys(envState);
+	if (hasExistingDatabaseEnvForTarget(branch, envState)) {
+		const warning = options.db === true ? existingDatabaseEnvWarning(branch, targetEnvVars) : null;
 		if (warning) emitBranchDatabaseWarning(context, warning);
 		return {
 			result: options.db === true ? {
 				status: "skipped",
-				reason: "branch-env-exists",
-				envVars: branchEnvVars,
+				reason: existingDatabaseEnvReason(branch),
+				envVars: targetEnvVars,
 				schema: null
 			} : void 0,
 			warnings: warning ? [warning] : []
 		};
 	}
+	const localSignal = await inspectBranchDatabaseSignal(context.runtime.cwd, context.runtime.signal);
 	if (localSignal.unsupportedSchema) {
-		if (options.db === true) throw unsupportedBranchDatabaseSchemaError(localSignal.unsupportedSchema, branch.name, context);
+		if (options.db === true) throw unsupportedBranchDatabaseSchemaError(localSignal.unsupportedSchema, branch, context);
 		return emptyBranchDatabaseSetupOutcome();
 	}
-	const hasSignal = hasBranchDatabaseSignal(localSignal) || Boolean(envState.previewDatabaseUrl);
+	const hasSignal = hasBranchDatabaseSignal(localSignal) || Boolean(envState.inheritedPreviewDatabaseUrl);
 	if (options.db !== true) {
 		if (!hasSignal) return emptyBranchDatabaseSetupOutcome();
 		if (!canPrompt(context) || context.flags.yes) {
-			const warning = "This app appears to use DATABASE_URL. Run prisma-cli app deploy --db to create an isolated database for this preview branch.";
+			const warning = databasePromptSuppressedWarning(branch);
 			emitBranchDatabaseWarning(context, warning);
 			return {
 				result: void 0,
 				warnings: [warning]
 			};
 		}
-		maybeRenderBranchDatabaseSignal(context, branch.name, localSignal, envState);
+		maybeRenderBranchDatabaseSignal(context, branch, localSignal, envState);
 		if (!await confirmPrompt({
 			input: context.runtime.stdin,
 			output: context.output.stderr,
-			message: `Create an isolated database for branch "${branch.name}"?`,
+			message: databasePromptMessage(branch),
 			initialValue: false
 		})) return emptyBranchDatabaseSetupOutcome();
-	}
+	} else if (!canPrompt(context) && !context.flags.yes) throw nonInteractiveDatabaseSetupRequiresYesError(branch);
 	return setupBranchDatabase(context, provider, projectId, branch, localSignal, envState);
 }
 async function setupBranchDatabase(context, provider, projectId, branch, signal, envState) {
-	emitBranchDatabaseProgress(context, "pending", "Creating branch database");
+	emitBranchDatabaseProgress(context, "pending", "Creating database");
 	const database = await provider.createBranchDatabase({
 		projectId,
 		branchId: branch.id,
 		branchName: branch.name,
 		signal: context.runtime.signal
 	}).catch((error) => {
-		throw branchDatabaseSetupFailedError("Failed to create branch database", error, branch.name);
+		throw branchDatabaseSetupFailedError("Failed to create database", error, branch);
 	});
-	emitBranchDatabaseProgress(context, "success", "Created branch database");
+	emitBranchDatabaseProgress(context, "success", "Created database");
 	try {
 		let schemaSetup = null;
 		const warnings = [];
@@ -80,12 +80,12 @@ async function setupBranchDatabase(context, provider, projectId, branch, signal,
 				databaseUrl: database.databaseUrl,
 				directUrl: database.directUrl
 			}).catch((error) => {
-				throw schemaSetupFailedError(error, signal.schema, branch.name, context.runtime.cwd);
+				throw schemaSetupFailedError(error, signal.schema, branch, context.runtime.cwd);
 			});
 			emitBranchDatabaseProgress(context, "success", "Applied database schema");
-		} else skippedSchemaWarning = "No supported Prisma schema source was found. Branch database env vars were created, but schema setup was skipped.";
+		} else skippedSchemaWarning = "No supported Prisma schema source was found. Database env vars were created, but schema setup was skipped.";
 		const envVars = await upsertBranchDatabaseEnvVars(context, provider, projectId, branch, database, envState);
-		emitBranchDatabaseProgress(context, "success", `Added branch env override${envVars.length === 1 ? "" : "s"} ${envVars.join(", ")}`);
+		emitBranchDatabaseProgress(context, "success", `Added ${envScopeLabel(branch)} env var${envVars.length === 1 ? "" : "s"} ${envVars.join(", ")}`);
 		if (skippedSchemaWarning) {
 			emitBranchDatabaseWarning(context, skippedSchemaWarning);
 			warnings.push(skippedSchemaWarning);
@@ -107,37 +107,36 @@ async function setupBranchDatabase(context, provider, projectId, branch, signal,
 			warnings
 		};
 	} catch (error) {
-		throw await cleanupCreatedBranchDatabaseAfterFailure(context, provider, database, branch.name, error);
+		throw await cleanupCreatedBranchDatabaseAfterFailure(context, provider, database, branch, error);
 	}
 }
 async function upsertBranchDatabaseEnvVars(context, provider, projectId, branch, database, envState) {
+	const scope = envScopeForBranch(branch);
 	const written = [];
 	await upsertBranchDatabaseEnvVar(context, provider, {
 		projectId,
-		branchId: branch.id,
-		className: "preview",
+		...scope,
 		key: "DATABASE_URL",
 		value: database.databaseUrl,
-		existing: envState.branchDatabaseUrl,
-		branchName: branch.name
+		existing: envState.targetDatabaseUrl,
+		branch
 	});
 	written.push("DATABASE_URL");
 	if (database.directUrl) {
 		await upsertBranchDatabaseEnvVar(context, provider, {
 			projectId,
-			branchId: branch.id,
-			className: "preview",
+			...scope,
 			key: "DIRECT_URL",
 			value: database.directUrl,
-			existing: envState.branchDirectUrl,
-			branchName: branch.name
+			existing: envState.targetDirectUrl,
+			branch
 		});
 		written.push("DIRECT_URL");
-	} else if (envState.branchDirectUrl) await provider.deleteEnvironmentVariable({
-		envVarId: envState.branchDirectUrl.id,
+	} else if (branch.kind === "preview" && envState.targetDirectUrl) await provider.deleteEnvironmentVariable({
+		envVarId: envState.targetDirectUrl.id,
 		signal: context.runtime.signal
 	}).catch((error) => {
-		throw branchDatabaseSetupFailedError("Failed to remove stale DIRECT_URL", error, branch.name);
+		throw branchDatabaseSetupFailedError("Failed to remove stale DIRECT_URL", error, branch);
 	});
 	return written;
 }
@@ -148,37 +147,39 @@ async function upsertBranchDatabaseEnvVar(context, provider, options) {
 			value: options.value,
 			signal: context.runtime.signal
 		}).catch((error) => {
-			throw branchDatabaseSetupFailedError(`Failed to update ${options.key}`, error, options.branchName);
+			throw branchDatabaseSetupFailedError(`Failed to update ${options.key}`, error, options.branch);
 		});
 		return;
 	}
 	await provider.createEnvironmentVariable({
 		projectId: options.projectId,
-		branchId: options.branchId,
 		className: options.className,
 		key: options.key,
 		value: options.value,
+		...options.branchId ? { branchId: options.branchId } : {},
 		signal: context.runtime.signal
 	}).catch((error) => {
-		throw branchDatabaseSetupFailedError(`Failed to write ${options.key}`, error, options.branchName);
+		throw branchDatabaseSetupFailedError(`Failed to write ${options.key}`, error, options.branch);
 	});
 }
-async function inspectBranchDatabaseEnv(provider, projectId, branchId, signal) {
+async function inspectBranchDatabaseEnv(provider, projectId, branch, signal) {
+	const scope = envScopeForBranch(branch);
 	const [databaseUrlRows, directUrlRows] = await Promise.all([provider.listEnvironmentVariables({
 		projectId,
-		className: "preview",
+		className: scope.className,
 		key: "DATABASE_URL",
 		signal
 	}), provider.listEnvironmentVariables({
 		projectId,
-		className: "preview",
+		className: scope.className,
 		key: "DIRECT_URL",
 		signal
 	})]);
+	const targetBranchId = branch.kind === "preview" ? branch.id : null;
 	return {
-		branchDatabaseUrl: findEnvVar(databaseUrlRows, { branchId }),
-		branchDirectUrl: findEnvVar(directUrlRows, { branchId }),
-		previewDatabaseUrl: findEnvVar(databaseUrlRows, { branchId: null })
+		targetDatabaseUrl: findEnvVar(databaseUrlRows, { branchId: targetBranchId }),
+		targetDirectUrl: findEnvVar(directUrlRows, { branchId: targetBranchId }),
+		inheritedPreviewDatabaseUrl: branch.kind === "preview" ? findEnvVar(databaseUrlRows, { branchId: null }) : null
 	};
 }
 function findEnvVar(rows, options) {
@@ -187,14 +188,47 @@ function findEnvVar(rows, options) {
 function hasProvidedDatabaseEnvVars(envVars) {
 	return Boolean(envVars && ("DATABASE_URL" in envVars || "DIRECT_URL" in envVars));
 }
-function maybeRenderBranchDatabaseSignal(context, branchName, signal, envState) {
+function envScopeForBranch(branch) {
+	return branch.kind === "production" ? { className: "production" } : {
+		className: "preview",
+		branchId: branch.id
+	};
+}
+function envScopeLabel(branch) {
+	return branch.kind === "production" ? "production" : "branch";
+}
+function getTargetDatabaseEnvVarKeys(envState) {
+	return [envState.targetDatabaseUrl, envState.targetDirectUrl].filter((variable) => Boolean(variable)).map((variable) => variable.key).sort();
+}
+function hasExistingDatabaseEnvForTarget(branch, envState) {
+	if (branch.kind === "production") return Boolean(envState.targetDatabaseUrl || envState.targetDirectUrl);
+	return Boolean(envState.targetDatabaseUrl);
+}
+function existingDatabaseEnvReason(branch) {
+	return branch.kind === "production" ? "production-env-exists" : "branch-env-exists";
+}
+function existingDatabaseEnvWarning(branch, envVars) {
+	if (branch.kind === "production") return `Production already has ${envVars.join(" and ")}. Treating it as BYO database configuration and leaving env vars unchanged.`;
+	return `Branch "${branch.name}" already has DATABASE_URL. Leaving branch database env vars unchanged.`;
+}
+function databasePromptSuppressedWarning(branch) {
+	if (branch.kind === "production") return "This app appears to use DATABASE_URL. Run prisma-cli app deploy --db --yes to create and wire a Prisma Postgres database for this first production deploy.";
+	return "This app appears to use DATABASE_URL. Run prisma-cli app deploy --db to create an isolated database for this preview branch.";
+}
+function databasePromptMessage(branch) {
+	return branch.kind === "production" ? "Create a Prisma Postgres database for production?" : `Create an isolated database for branch "${branch.name}"?`;
+}
+function maybeRenderBranchDatabaseSignal(context, branch, signal, envState) {
 	if (context.flags.json || context.flags.quiet) return;
 	const rows = [
 		signal.schema ? `  Schema  ${path.relative(context.runtime.cwd, signal.schema.path) || defaultSchemaSourcePath(signal.schema)}` : null,
 		signal.databaseUrlReferences.length > 0 ? `  Code    ${signal.databaseUrlReferences.slice(0, 3).join(", ")}` : null,
-		envState.previewDatabaseUrl ? "  Env     preview DATABASE_URL is inherited by this branch" : null
+		envState.inheritedPreviewDatabaseUrl ? "  Env     preview DATABASE_URL is inherited by this branch" : null
 	].filter((row) => Boolean(row));
-	context.output.stderr.write(`Database signal found for branch "${branchName}"\n${rows.join("\n")}\n\n`);
+	context.output.stderr.write(`Database signal found for ${databaseTargetLabel(branch)}\n${rows.join("\n")}\n\n`);
+}
+function databaseTargetLabel(branch) {
+	return branch.kind === "production" ? `production branch "${branch.name}"` : `branch "${branch.name}"`;
 }
 function emitBranchDatabaseProgress(context, status, message) {
 	if (context.flags.json || context.flags.quiet) return;
@@ -211,6 +245,12 @@ function emptyBranchDatabaseSetupOutcome() {
 		warnings: []
 	};
 }
+function productionDatabaseSetupAfterFirstDeployError() {
+	return usageError("Database setup is only available during the first production deploy", "The selected production app already has a live deployment.", "Use project env commands to manage production DATABASE_URL, or deploy a preview branch with --db.", ["prisma-cli project env add DATABASE_URL=<value> --role production", "prisma-cli app deploy --branch feature/db --db"], "app");
+}
+function nonInteractiveDatabaseSetupRequiresYesError(branch) {
+	return usageError("Database setup requires --yes in non-interactive mode", "The deploy command received --db, but prompts are not available and --yes was not passed.", "Pass --yes together with --db to confirm non-interactive database creation.", [branch.kind === "production" ? "prisma-cli app deploy --prod --db --yes" : `prisma-cli app deploy --branch ${formatCommandArgument(branch.name)} --db --yes`], "app");
+}
 function formatSchemaSetupCommand(command) {
 	switch (command) {
 		case "migrate-deploy": return "prisma migrate deploy";
@@ -218,46 +258,46 @@ function formatSchemaSetupCommand(command) {
 		case "prisma-next-db-init": return "prisma-next db init";
 	}
 }
-function branchDatabaseSetupFailedError(summary, error, branchName) {
+function branchDatabaseSetupFailedError(summary, error, branch) {
 	return new CliError({
 		code: "BRANCH_DATABASE_SETUP_FAILED",
 		domain: "app",
 		summary,
 		why: error instanceof Error ? error.message : String(error),
-		fix: "Retry the command, or create the branch database and env vars manually with project env commands.",
+		fix: "Retry the command, or create the database and env vars manually with project env commands.",
 		debug: formatDebugDetails(error),
-		meta: { branch: branchName },
+		meta: { branch: branch.name },
 		exitCode: 1,
-		nextSteps: [`prisma-cli app deploy --branch ${formatCommandArgument(branchName)} --db`, `prisma-cli project env list --branch ${formatCommandArgument(branchName)}`]
+		nextSteps: [formatAppDeployWithDbNextStep(branch), formatProjectEnvListNextStep(branch)]
 	});
 }
-async function cleanupCreatedBranchDatabaseAfterFailure(context, provider, database, branchName, error) {
-	const setupError = error instanceof CliError ? error : branchDatabaseSetupFailedError("Branch database setup failed", error, branchName);
-	emitBranchDatabaseProgress(context, "pending", "Removing branch database after setup failed");
+async function cleanupCreatedBranchDatabaseAfterFailure(context, provider, database, branch, error) {
+	const setupError = error instanceof CliError ? error : branchDatabaseSetupFailedError("Database setup failed", error, branch);
+	emitBranchDatabaseProgress(context, "pending", "Removing database after setup failed");
 	try {
 		await provider.deleteBranchDatabase({
 			databaseId: database.id,
 			signal: context.runtime.signal
 		});
-		emitBranchDatabaseProgress(context, "success", "Removed branch database after setup failed");
+		emitBranchDatabaseProgress(context, "success", "Removed database after setup failed");
 	} catch (cleanupError) {
-		return branchDatabaseCleanupFailedError(setupError, cleanupError, database, branchName);
+		return branchDatabaseCleanupFailedError(setupError, cleanupError, database, branch);
 	}
 	return setupError;
 }
-function branchDatabaseCleanupFailedError(setupError, cleanupError, database, branchName) {
+function branchDatabaseCleanupFailedError(setupError, cleanupError, database, branch) {
 	const cleanupWhy = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
-	const setupWhy = setupError.why ?? "Branch database setup failed.";
+	const setupWhy = setupError.why ?? "Database setup failed.";
 	return new CliError({
 		code: setupError.code,
 		domain: setupError.domain,
 		summary: setupError.summary,
 		why: `${setupWhy} Prisma could not delete the created database "${database.name}" (${database.id}): ${cleanupWhy}`,
-		fix: "Delete the created branch database from Console or contact Prisma support, then rerun deploy with --db.",
+		fix: "Delete the created database from Console or contact Prisma support, then rerun deploy with --db.",
 		debug: formatCombinedDebugDetails(setupError, cleanupError),
 		meta: {
 			...setupError.meta,
-			branch: branchName,
+			branch: branch.name,
 			databaseId: database.id,
 			databaseName: database.name,
 			cleanupFailed: true
@@ -266,7 +306,7 @@ function branchDatabaseCleanupFailedError(setupError, cleanupError, database, br
 		nextSteps: []
 	});
 }
-function schemaSetupFailedError(error, schema, branchName, cwd) {
+function schemaSetupFailedError(error, schema, branch, cwd) {
 	return new CliError({
 		code: "SCHEMA_SETUP_FAILED",
 		domain: "app",
@@ -275,17 +315,26 @@ function schemaSetupFailedError(error, schema, branchName, cwd) {
 		fix: "Fix the Prisma schema or migrations, then rerun deploy with --db.",
 		debug: formatDebugDetails(error),
 		meta: {
-			branch: branchName,
+			branch: branch.name,
 			schemaPath: schema.path,
 			source: schema.kind,
 			command: schema.command
 		},
 		exitCode: 1,
-		nextSteps: [...formatSchemaSetupNextSteps(schema, cwd), `prisma-cli app deploy --branch ${formatCommandArgument(branchName)} --db`]
+		nextSteps: [...formatSchemaSetupNextSteps(schema, cwd), formatAppDeployWithDbNextStep(branch)]
 	});
 }
-function unsupportedBranchDatabaseSchemaError(schema, branchName, context) {
-	return usageError("Branch database setup is not available for this Prisma schema", `${path.relative(context.runtime.cwd, schema.path) || defaultUnsupportedSchemaSourcePath(schema)} targets ${formatUnsupportedSchemaTarget(schema.target)}, but --db creates Prisma Postgres databases.`, "Use project env commands to provide a database URL for this branch, or switch the Prisma schema source to PostgreSQL before using --db.", [`prisma-cli project env add DATABASE_URL=<value> --branch ${formatCommandArgument(branchName)}`, `prisma-cli app deploy --branch ${formatCommandArgument(branchName)}`], "app");
+function unsupportedBranchDatabaseSchemaError(schema, branch, context) {
+	return usageError("Database setup is not available for this Prisma schema", `${path.relative(context.runtime.cwd, schema.path) || defaultUnsupportedSchemaSourcePath(schema)} targets ${formatUnsupportedSchemaTarget(schema.target)}, but --db creates Prisma Postgres databases.`, "Use project env commands to provide a database URL, or switch the Prisma schema source to PostgreSQL before using --db.", [formatProjectEnvAddNextStep(branch), `prisma-cli app deploy --branch ${formatCommandArgument(branch.name)}`], "app");
+}
+function formatAppDeployWithDbNextStep(branch) {
+	return `prisma-cli app deploy --branch ${formatCommandArgument(branch.name)} --db`;
+}
+function formatProjectEnvListNextStep(branch) {
+	return branch.kind === "production" ? "prisma-cli project env list --role production" : `prisma-cli project env list --branch ${formatCommandArgument(branch.name)}`;
+}
+function formatProjectEnvAddNextStep(branch) {
+	return branch.kind === "production" ? "prisma-cli project env add DATABASE_URL=<value> --role production" : `prisma-cli project env add DATABASE_URL=<value> --branch ${formatCommandArgument(branch.name)}`;
 }
 function formatSchemaSetupNextSteps(schema, cwd) {
 	const sourcePath = path.relative(cwd, schema.path) || defaultSchemaSourcePath(schema);

package/dist/lib/app/preview-build-settings.js

@@ -0,0 +1,385 @@
+import { CliError } from "../../shell/errors.js";
+import { readBunPackageJson } from "./bun-project.js";
+import { readFile, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { exec } from "node:child_process";
+import { parseModule } from "magicast";
+//#region src/lib/app/preview-build-settings.ts
+const PRISMA_APP_CONFIG_FILENAME = "prisma.app.json";
+const PRISMA_APP_CONFIG_SCHEMA_URL = "https://pris.ly/schemas/prisma-app-config.v1.json";
+async function resolveOrCreatePreviewBuildSettings(options) {
+	const configPath = path.join(options.appPath, PRISMA_APP_CONFIG_FILENAME);
+	const existing = await readPreviewBuildSettingsConfig(configPath, options.signal);
+	if (existing) return {
+		status: "used",
+		configPath,
+		relativeConfigPath: PRISMA_APP_CONFIG_FILENAME,
+		settings: {
+			buildCommand: existing.buildCommand,
+			buildCommandSource: null,
+			outputDirectory: existing.outputDirectory,
+			outputDirectorySource: null
+		}
+	};
+	const settings = await resolvePreviewBuildSettings(options);
+	const config = {
+		$schema: PRISMA_APP_CONFIG_SCHEMA_URL,
+		buildCommand: settings.buildCommand,
+		outputDirectory: settings.outputDirectory
+	};
+	try {
+		await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, {
+			encoding: "utf8",
+			flag: "wx",
+			signal: options.signal
+		});
+	} catch (error) {
+		if (error.code === "EEXIST") {
+			const raced = await readPreviewBuildSettingsConfig(configPath, options.signal);
+			if (raced) return {
+				status: "used",
+				configPath,
+				relativeConfigPath: PRISMA_APP_CONFIG_FILENAME,
+				settings: {
+					buildCommand: raced.buildCommand,
+					buildCommandSource: null,
+					outputDirectory: raced.outputDirectory,
+					outputDirectorySource: null
+				}
+			};
+		}
+		throw error;
+	}
+	return {
+		status: "created",
+		configPath,
+		relativeConfigPath: PRISMA_APP_CONFIG_FILENAME,
+		settings
+	};
+}
+async function resolvePreviewBuildSettings(options) {
+	switch (options.buildType) {
+		case "nextjs": {
+			const packageJson = await readBunPackageJson(options.appPath, options.signal);
+			const buildCommand = await resolveFrameworkBuildCommand(options.appPath, packageJson, {
+				command: "next build",
+				source: "Next.js default",
+				signal: options.signal
+			});
+			const outputRoot = await resolveNextOutputRoot(options.appPath, options.signal);
+			return {
+				buildCommand: buildCommand.command,
+				buildCommandSource: buildCommand.source,
+				outputDirectory: joinPosix(outputRoot, "standalone"),
+				outputDirectorySource: outputRoot === ".next" ? "Next.js output" : "next.config distDir"
+			};
+		}
+		case "tanstack-start": {
+			const packageJson = await readBunPackageJson(options.appPath, options.signal);
+			const buildCommand = await resolveFrameworkBuildCommand(options.appPath, packageJson, {
+				command: "vite build",
+				source: "TanStack Start default",
+				signal: options.signal
+			});
+			return {
+				buildCommand: buildCommand.command,
+				buildCommandSource: buildCommand.source,
+				outputDirectory: ".output",
+				outputDirectorySource: "TanStack Start output"
+			};
+		}
+		case "bun": {
+			const packageJson = await readBunPackageJson(options.appPath, options.signal);
+			const buildCommand = await resolveFrameworkBuildCommand(options.appPath, packageJson, {
+				command: null,
+				source: null,
+				signal: options.signal
+			});
+			return {
+				buildCommand: buildCommand.command,
+				buildCommandSource: buildCommand.source,
+				outputDirectory: ".",
+				outputDirectorySource: "app root"
+			};
+		}
+	}
+}
+async function readPreviewBuildSettingsConfig(configPath, signal) {
+	let content;
+	try {
+		content = await readFile(configPath, {
+			encoding: "utf8",
+			signal
+		});
+	} catch (error) {
+		if (error.code === "ENOENT") return null;
+		throw error;
+	}
+	let parsed;
+	try {
+		parsed = JSON.parse(content);
+	} catch (error) {
+		throw invalidPrismaAppConfigError(configPath, `The file is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw invalidPrismaAppConfigError(configPath, "The file must contain a JSON object.");
+	const raw = parsed;
+	if ("$schema" in raw && raw.$schema !== void 0 && typeof raw.$schema !== "string") throw invalidPrismaAppConfigError(configPath, "The $schema field must be a string when present.");
+	if (raw.buildCommand !== null && typeof raw.buildCommand !== "string") throw invalidPrismaAppConfigError(configPath, "The buildCommand field must be a string or null.");
+	let buildCommand = null;
+	if (typeof raw.buildCommand === "string") {
+		buildCommand = raw.buildCommand.trim();
+		if (buildCommand.length === 0) throw invalidPrismaAppConfigError(configPath, "The buildCommand field must not be an empty string. Use null to skip the build step.");
+	}
+	const outputDirectory = normalizeConfigOutputDirectory(configPath, raw.outputDirectory);
+	return {
+		buildCommand,
+		outputDirectory
+	};
+}
+function normalizeConfigOutputDirectory(configPath, value) {
+	if (typeof value !== "string" || value.trim().length === 0) throw invalidPrismaAppConfigError(configPath, "The outputDirectory field must be a non-empty string.");
+	const normalized = normalizeRelativePath(value);
+	if (!normalized) throw invalidPrismaAppConfigError(configPath, "The outputDirectory field must be a relative path inside the app directory.");
+	return normalized;
+}
+function invalidPrismaAppConfigError(configPath, why) {
+	return new CliError({
+		code: "APP_CONFIG_INVALID",
+		domain: "app",
+		summary: `Invalid ${PRISMA_APP_CONFIG_FILENAME}`,
+		why,
+		fix: `Edit ${PRISMA_APP_CONFIG_FILENAME} so buildCommand is a string or null and outputDirectory is a relative path inside the app root. Delete the file and rerun prisma-cli app deploy to regenerate defaults.`,
+		where: configPath,
+		meta: { configPath },
+		exitCode: 2,
+		nextSteps: ["prisma-cli app deploy"]
+	});
+}
+async function hasRootFile(appPath, filenames, signal) {
+	let entries;
+	try {
+		signal?.throwIfAborted();
+		entries = await readdir(appPath);
+		signal?.throwIfAborted();
+	} catch (error) {
+		if (signal?.aborted) throw error;
+		return false;
+	}
+	return entries.some((entry) => filenames.includes(entry));
+}
+function hasPackageDependency(packageJson, dependencyName) {
+	return hasAnyPackageDependency(packageJson, [dependencyName]);
+}
+function hasAnyPackageDependency(packageJson, dependencyNames) {
+	if (!packageJson) return false;
+	return [packageJson.dependencies, packageJson.devDependencies].some((group) => {
+		if (!group || typeof group !== "object") return false;
+		return dependencyNames.some((dependencyName) => dependencyName in group);
+	});
+}
+async function resolveFrameworkBuildCommand(appPath, packageJson, fallback) {
+	const buildScript = readBuildScript(packageJson);
+	if (buildScript) {
+		const packageManager = await resolvePackageManager(appPath, packageJson, fallback.signal);
+		if (!packageManager) return {
+			command: buildScript,
+			source: "package.json scripts.build"
+		};
+		return {
+			command: `${packageManager} run build`,
+			source: "package.json scripts.build"
+		};
+	}
+	return {
+		command: fallback.command,
+		source: fallback.source
+	};
+}
+function readBuildScript(packageJson) {
+	if (!packageJson?.scripts || typeof packageJson.scripts !== "object") return null;
+	const scripts = packageJson.scripts;
+	if (typeof scripts.build !== "string") return null;
+	const buildScript = scripts.build.trim();
+	return buildScript.length > 0 ? buildScript : null;
+}
+async function resolvePackageManager(appPath, packageJson, signal) {
+	const fromPackageManager = packageManagerFromPackageJson(packageJson?.packageManager);
+	if (fromPackageManager) return fromPackageManager;
+	if (await pathExists(path.join(appPath, "bun.lock"), signal) || await pathExists(path.join(appPath, "bun.lockb"), signal)) return "bun";
+	if (await pathExists(path.join(appPath, "pnpm-lock.yaml"), signal)) return "pnpm";
+	if (await pathExists(path.join(appPath, "yarn.lock"), signal)) return "yarn";
+	if (await pathExists(path.join(appPath, "package-lock.json"), signal)) return "npm";
+}
+function packageManagerFromPackageJson(value) {
+	if (typeof value !== "string") return null;
+	const name = value.split("@")[0];
+	return name === "bun" || name === "pnpm" || name === "yarn" || name === "npm" ? name : null;
+}
+async function runResolvedBuildCommand(appPath, settings, failurePrefix, signal) {
+	if (!settings.buildCommand) return;
+	await execBuildCommand(settings.buildCommand, appPath, failurePrefix, signal);
+}
+function execBuildCommand(command, cwd, failurePrefix, signal) {
+	return new Promise((resolve, reject) => {
+		const child = exec(command, {
+			cwd,
+			env: {
+				...process.env,
+				PATH: [path.join(cwd, "node_modules", ".bin"), process.env.PATH].filter(Boolean).join(path.delimiter)
+			},
+			maxBuffer: 10 * 1024 * 1024,
+			signal
+		}, (error, stdout, stderr) => {
+			if (error) {
+				const output = [stderr.trim(), stdout.trim()].filter(Boolean).join("\n");
+				reject(/* @__PURE__ */ new Error(`${failurePrefix} failed:\n${output || error.message}`));
+				return;
+			}
+			resolve();
+		});
+		if (signal?.aborted) child.kill();
+	});
+}
+async function resolveNextOutputRoot(appPath, signal) {
+	return (await readNextConfig(appPath, signal)).distDir ?? ".next";
+}
+async function readNextConfig(appPath, signal) {
+	for (const fileName of NEXT_CONFIG_FILENAMES) {
+		const filePath = path.join(appPath, fileName);
+		let content;
+		try {
+			content = await readFile(filePath, {
+				encoding: "utf8",
+				signal
+			});
+		} catch (error) {
+			if (error.code === "ENOENT") continue;
+			throw error;
+		}
+		return readStaticNextConfig(content);
+	}
+	return {};
+}
+const NEXT_CONFIG_FILENAMES = [
+	"next.config.js",
+	"next.config.mjs",
+	"next.config.ts",
+	"next.config.mts"
+];
+function readStaticNextConfig(content) {
+	try {
+		const program = asAstNode(parseModule(content).$ast);
+		const bindings = program ? collectStaticBindings(program) : /* @__PURE__ */ new Map();
+		const configObject = program ? findExportedConfigObject(program, bindings) : null;
+		if (!configObject) return {};
+		const rawDistDir = readStaticStringProperty(configObject, "distDir");
+		const output = readStaticStringProperty(configObject, "output");
+		return {
+			distDir: rawDistDir ? normalizeRelativePath(rawDistDir) : void 0,
+			output: output === "standalone" || output === "export" ? output : void 0
+		};
+	} catch {
+		return {};
+	}
+}
+function joinPosix(...parts) {
+	return parts.join("/").replace(/\/+/g, "/");
+}
+function nextOutputRootFromStandaloneDirectory(outputDirectory) {
+	const normalized = outputDirectory.replace(/\/+$/g, "");
+	if (normalized === "standalone") return ".";
+	if (normalized.endsWith("/standalone")) {
+		const outputRoot = normalized.slice(0, -11);
+		return outputRoot.length > 0 ? outputRoot : ".";
+	}
+	const dirname = path.posix.dirname(normalized);
+	return dirname === "." ? "." : dirname;
+}
+function asAstNode(value) {
+	if (!value || typeof value !== "object") return null;
+	return typeof value.type === "string" ? value : null;
+}
+function astNodes(value) {
+	if (!Array.isArray(value)) return [];
+	return value.map(asAstNode).filter((node) => Boolean(node));
+}
+function collectStaticBindings(program) {
+	const bindings = /* @__PURE__ */ new Map();
+	for (const statement of astNodes(program.body)) {
+		if (statement.type !== "VariableDeclaration") continue;
+		for (const declaration of astNodes(statement.declarations)) {
+			const id = asAstNode(declaration.id);
+			const init = asAstNode(declaration.init);
+			if (id?.type === "Identifier" && typeof id.name === "string" && init) bindings.set(id.name, init);
+		}
+	}
+	return bindings;
+}
+function findExportedConfigObject(program, bindings) {
+	for (const statement of astNodes(program.body)) {
+		if (statement.type === "ExportDefaultDeclaration") return resolveConfigObject(statement.declaration, bindings);
+		if (statement.type !== "ExpressionStatement") continue;
+		const expression = asAstNode(statement.expression);
+		if (expression?.type !== "AssignmentExpression" || expression.operator !== "=") continue;
+		if (isModuleExports(expression.left)) return resolveConfigObject(expression.right, bindings);
+	}
+	return null;
+}
+function resolveConfigObject(value, bindings, depth = 0) {
+	if (depth > 4) return null;
+	const node = unwrapStaticExpression(asAstNode(value));
+	if (!node) return null;
+	if (node.type === "ObjectExpression") return node;
+	if (node.type === "Identifier" && typeof node.name === "string") return resolveConfigObject(bindings.get(node.name), bindings, depth + 1);
+	if (node.type === "CallExpression") return resolveConfigObject(astNodes(node.arguments)[0], bindings, depth + 1);
+	return null;
+}
+function unwrapStaticExpression(node) {
+	let current = node;
+	while (current?.type === "TSAsExpression" || current?.type === "TSSatisfiesExpression" || current?.type === "TSNonNullExpression") current = asAstNode(current.expression);
+	return current;
+}
+function isModuleExports(value) {
+	const node = asAstNode(value);
+	if (node?.type !== "MemberExpression" || node.computed === true) return false;
+	const object = asAstNode(node.object);
+	const property = asAstNode(node.property);
+	return object?.type === "Identifier" && object.name === "module" && property?.type === "Identifier" && property.name === "exports";
+}
+function readStaticStringProperty(objectExpression, propertyName) {
+	for (const property of astNodes(objectExpression.properties)) {
+		if (property.type !== "ObjectProperty" || property.computed === true) continue;
+		if (propertyKeyName(property.key) !== propertyName) continue;
+		const value = unwrapStaticExpression(asAstNode(property.value));
+		if (value?.type === "StringLiteral" && typeof value.value === "string") {
+			const trimmed = value.value.trim();
+			return trimmed.length > 0 ? trimmed : void 0;
+		}
+	}
+}
+function propertyKeyName(value) {
+	const key = asAstNode(value);
+	if (key?.type === "Identifier" && typeof key.name === "string") return key.name;
+	if (key?.type === "StringLiteral" && typeof key.value === "string") return key.value;
+}
+function normalizeRelativePath(value) {
+	const raw = value.trim().replace(/\\/g, "/");
+	if (raw.length === 0 || raw.split("/").includes("..")) return;
+	const normalized = path.posix.normalize(raw);
+	const segments = normalized.split("/");
+	if (path.win32.isAbsolute(value) || path.posix.isAbsolute(normalized) || segments.includes("..")) return;
+	return normalized === "." ? "." : normalized;
+}
+async function pathExists(targetPath, signal) {
+	try {
+		signal?.throwIfAborted();
+		await stat(targetPath);
+		signal?.throwIfAborted();
+		return true;
+	} catch (error) {
+		if (signal?.aborted) throw error;
+		return false;
+	}
+}
+//#endregion
+export { PRISMA_APP_CONFIG_FILENAME, PRISMA_APP_CONFIG_SCHEMA_URL, hasAnyPackageDependency, hasPackageDependency, hasRootFile, joinPosix, nextOutputRootFromStandaloneDirectory, resolveOrCreatePreviewBuildSettings, resolvePreviewBuildSettings, runResolvedBuildCommand };

package/dist/lib/app/preview-build.js

@@ -1,7 +1,9 @@
-import { resolveBunEntrypoint } from "./bun-project.js";
-import { chmod, copyFile, cp, lstat, mkdir, readFile, readdir, readlink, rm, stat } from "node:fs/promises";
+import { readBunPackageJson, resolveBunEntrypoint } from "./bun-project.js";
+import { PRISMA_APP_CONFIG_FILENAME, hasAnyPackageDependency, hasPackageDependency, hasRootFile, joinPosix, nextOutputRootFromStandaloneDirectory, resolvePreviewBuildSettings, runResolvedBuildCommand } from "./preview-build-settings.js";
+import { chmod, copyFile, cp, lstat, mkdir, mkdtemp, readFile, readdir, readlink, rm, stat } from "node:fs/promises";
 import path from "node:path";
-import { AstroBuild, BunBuild, NextjsBuild, NuxtBuild, TanstackStartBuild } from "@prisma/compute-sdk";
+import os from "node:os";
+import { AstroBuild, BunBuild, NuxtBuild } from "@prisma/compute-sdk";
 //#region src/lib/app/preview-build.ts
 const PREVIEW_BUILD_TYPES = [
 	"auto",
@@ -17,18 +19,21 @@ var PreviewBuildStrategy = class {
 	#entrypoint;
 	#buildType;
 	#signal;
+	#buildSettings;
 	constructor(options) {
 		this.#appPath = options.appPath;
 		this.#entrypoint = options.entrypoint;
 		this.#buildType = options.buildType ?? "auto";
 		this.#signal = options.signal;
+		this.#buildSettings = options.buildSettings;
 	}
 	async canBuild(signal = this.#signal) {
 		const { strategy } = await resolvePreviewBuildStrategy({
 			appPath: this.#appPath,
 			entrypoint: this.#entrypoint,
 			buildType: this.#buildType,
-			signal
+			signal,
+			buildSettings: this.#buildSettings
 		});
 		return strategy.canBuild(signal);
 	}
@@ -37,7 +42,8 @@ var PreviewBuildStrategy = class {
 			appPath: this.#appPath,
 			entrypoint: this.#entrypoint,
 			buildType: this.#buildType,
-			signal
+			signal,
+			buildSettings: this.#buildSettings
 		});
 		return artifact;
 	}
@@ -47,11 +53,11 @@ async function executePreviewBuild(options) {
 		appPath: options.appPath,
 		entrypoint: options.entrypoint,
 		buildType: options.buildType ?? "auto",
-		signal: options.signal
+		signal: options.signal,
+		buildSettings: options.buildSettings
 	});
 	const artifact = await strategy.execute(options.signal);
 	try {
-		if (buildType === "nextjs") await restageNextjsArtifact(artifact, options.appPath, options.signal);
 		await normalizeArtifactSymlinks(artifact.directory, options.appPath, options.signal);
 		return {
 			artifact,
@@ -68,7 +74,8 @@ async function resolvePreviewBuildStrategy(options) {
 			appPath: options.appPath,
 			entrypoint: options.entrypoint,
 			buildType: options.buildType,
-			signal: options.signal
+			signal: options.signal,
+			buildSettings: options.buildSettings
 		});
 		return {
 			buildType: options.buildType,
@@ -81,7 +88,8 @@ async function resolvePreviewBuildStrategy(options) {
 			appPath: options.appPath,
 			entrypoint: options.entrypoint,
 			buildType,
-			signal: options.signal
+			signal: options.signal,
+			buildSettings: options.buildSettings
 		});
 		if (await strategy.canBuild(options.signal)) return {
 			buildType,
@@ -94,25 +102,170 @@ async function resolvePreviewBuildStrategy(options) {
 			appPath: options.appPath,
 			entrypoint: options.entrypoint,
 			buildType: "bun",
-			signal: options.signal
+			signal: options.signal,
+			buildSettings: options.buildSettings
 		})
 	};
 }
 async function createPreviewBuildStrategy(options) {
 	switch (options.buildType) {
-		case "nextjs": return new NextjsBuild({ appPath: options.appPath });
+		case "nextjs": return new PreviewNextjsBuild({
+			appPath: options.appPath,
+			buildSettings: options.buildSettings
+		});
 		case "nuxt": return new NuxtBuild({ appPath: options.appPath });
 		case "astro": return new AstroBuild({ appPath: options.appPath });
-		case "tanstack-start": return new TanstackStartBuild({ appPath: options.appPath });
+		case "tanstack-start": return new PreviewTanstackStartBuild({
+			appPath: options.appPath,
+			buildSettings: options.buildSettings
+		});
 		case "bun": {
 			const entrypoint = await resolveBunEntrypoint(options.appPath, options.entrypoint, options.signal);
-			return new BunBuild({
+			return new PreviewBunBuild({
 				appPath: options.appPath,
-				entrypoint
+				strategy: new BunBuild({
+					appPath: options.appPath,
+					entrypoint
+				}),
+				buildSettings: options.buildSettings
 			});
 		}
 	}
 }
+var PreviewNextjsBuild = class {
+	#appPath;
+	#buildSettings;
+	constructor(options) {
+		this.#appPath = options.appPath;
+		this.#buildSettings = options.buildSettings;
+	}
+	async canBuild(signal) {
+		const packageJson = await readBunPackageJson(this.#appPath, signal);
+		return await hasRootFile(this.#appPath, NEXT_CONFIG_FILENAMES, signal) || hasPackageDependency(packageJson, "next");
+	}
+	async execute(signal) {
+		const settings = this.#buildSettings ?? await resolvePreviewBuildSettings({
+			appPath: this.#appPath,
+			buildType: "nextjs",
+			signal
+		});
+		await runResolvedBuildCommand(this.#appPath, settings, "Next.js", signal);
+		const standaloneDir = path.join(this.#appPath, settings.outputDirectory);
+		if (!await directoryExists(standaloneDir, signal)) throw new Error(`Next.js build did not produce standalone output at ${settings.outputDirectory}. Add output: "standalone" to your next.config file, or update ${PRISMA_APP_CONFIG_FILENAME}.`);
+		const outDir = await unsupportedFilesystemBoundary(signal, () => mkdtemp(path.join(os.tmpdir(), "compute-build-")));
+		try {
+			const artifactDir = path.join(outDir, "app");
+			await stageNextjsStandaloneArtifact({
+				standaloneDir,
+				artifactDir,
+				appPath: this.#appPath,
+				signal
+			});
+			const entrypoint = await findNextStandaloneEntrypoint(artifactDir, signal);
+			await copyNextjsStaticAssets({
+				appPath: this.#appPath,
+				artifactDir,
+				outputRoot: nextOutputRootFromStandaloneDirectory(settings.outputDirectory),
+				entrypoint,
+				signal
+			});
+			return {
+				directory: artifactDir,
+				entrypoint,
+				defaultPortMapping: { http: 3e3 },
+				cleanup: () => rm(outDir, {
+					recursive: true,
+					force: true
+				})
+			};
+		} catch (error) {
+			await rm(outDir, {
+				recursive: true,
+				force: true
+			});
+			throw error;
+		}
+	}
+};
+var PreviewTanstackStartBuild = class {
+	#appPath;
+	#buildSettings;
+	constructor(options) {
+		this.#appPath = options.appPath;
+		this.#buildSettings = options.buildSettings;
+	}
+	async canBuild(signal) {
+		return hasAnyPackageDependency(await readBunPackageJson(this.#appPath, signal), TANSTACK_START_PACKAGES);
+	}
+	async execute(signal) {
+		const settings = this.#buildSettings ?? await resolvePreviewBuildSettings({
+			appPath: this.#appPath,
+			buildType: "tanstack-start",
+			signal
+		});
+		await runResolvedBuildCommand(this.#appPath, settings, "TanStack Start", signal);
+		const outputDir = path.join(this.#appPath, settings.outputDirectory);
+		const entrypoint = "server/index.mjs";
+		const entryPath = path.join(outputDir, entrypoint);
+		if (!(await unsupportedFilesystemBoundary(signal, () => stat(entryPath).catch(() => null)))?.isFile()) throw new Error(`TanStack Start build did not produce a Nitro node server entrypoint at ${joinPosix(settings.outputDirectory, entrypoint)}. Ensure your vite.config includes the tanstackStart() and nitro() plugins with the default node preset, or update ${PRISMA_APP_CONFIG_FILENAME}.`);
+		const outDir = await unsupportedFilesystemBoundary(signal, () => mkdtemp(path.join(os.tmpdir(), "compute-build-")));
+		try {
+			const artifactDir = path.join(outDir, "app");
+			await unsupportedFilesystemBoundary(signal, () => cp(outputDir, artifactDir, {
+				recursive: true,
+				verbatimSymlinks: true
+			}));
+			return {
+				directory: artifactDir,
+				entrypoint,
+				defaultPortMapping: { http: 3e3 },
+				cleanup: () => rm(outDir, {
+					recursive: true,
+					force: true
+				})
+			};
+		} catch (error) {
+			await rm(outDir, {
+				recursive: true,
+				force: true
+			});
+			throw error;
+		}
+	}
+};
+var PreviewBunBuild = class {
+	#appPath;
+	#strategy;
+	#buildSettings;
+	constructor(options) {
+		this.#appPath = options.appPath;
+		this.#strategy = options.strategy;
+		this.#buildSettings = options.buildSettings;
+	}
+	async canBuild(signal) {
+		return this.#strategy.canBuild(signal);
+	}
+	async execute(signal) {
+		const settings = this.#buildSettings ?? await resolvePreviewBuildSettings({
+			appPath: this.#appPath,
+			buildType: "bun",
+			signal
+		});
+		await runResolvedBuildCommand(this.#appPath, settings, "Bun", signal);
+		return this.#strategy.execute(signal);
+	}
+};
+const NEXT_CONFIG_FILENAMES = [
+	"next.config.js",
+	"next.config.mjs",
+	"next.config.ts",
+	"next.config.mts"
+];
+const TANSTACK_START_PACKAGES = [
+	"@tanstack/react-start",
+	"@tanstack/solid-start",
+	"@tanstack/start"
+];
 async function stageNextjsStandaloneArtifact(options) {
 	const standaloneRoot = path.resolve(options.standaloneDir);
 	const artifactRoot = path.resolve(options.artifactDir);
@@ -125,32 +278,42 @@ async function stageNextjsStandaloneArtifact(options) {
 	});
 	await hoistPnpmDependencies(path.join(artifactRoot, "node_modules"), options.signal);
 }
-async function restageNextjsArtifact(artifact, appPath, signal) {
-	const artifactDir = artifact.directory;
-	const standaloneDir = path.join(appPath, ".next", "standalone");
-	await unsupportedFilesystemBoundary(signal, () => rm(artifactDir, {
-		recursive: true,
-		force: true
-	}));
-	await stageNextjsStandaloneArtifact({
-		standaloneDir,
-		artifactDir,
-		appPath,
-		signal
-	});
-	const serverSubpath = nextjsServerSubpath(artifact.entrypoint);
-	const serverDir = serverSubpath ? path.join(artifactDir, serverSubpath) : artifactDir;
-	const publicDir = path.join(appPath, "public");
-	if (await directoryExists(publicDir, signal)) await unsupportedFilesystemBoundary(signal, () => cp(publicDir, path.join(serverDir, "public"), {
+async function copyNextjsStaticAssets(options) {
+	const serverSubpath = nextjsServerSubpath(options.entrypoint);
+	const serverDir = serverSubpath ? path.join(options.artifactDir, serverSubpath) : options.artifactDir;
+	const publicDir = path.join(options.appPath, "public");
+	if (await directoryExists(publicDir, options.signal)) await unsupportedFilesystemBoundary(options.signal, () => cp(publicDir, path.join(serverDir, "public"), {
 		recursive: true,
 		verbatimSymlinks: true
 	}));
-	const staticDir = path.join(appPath, ".next", "static");
-	if (await directoryExists(staticDir, signal)) await unsupportedFilesystemBoundary(signal, () => cp(staticDir, path.join(serverDir, ".next", "static"), {
+	const staticDir = path.join(options.appPath, options.outputRoot, "static");
+	if (await directoryExists(staticDir, options.signal)) await unsupportedFilesystemBoundary(options.signal, () => cp(staticDir, path.join(serverDir, options.outputRoot, "static"), {
 		recursive: true,
 		verbatimSymlinks: true
 	}));
 }
+async function findNextStandaloneEntrypoint(artifactDir, signal) {
+	const rootEntrypoint = path.join(artifactDir, "server.js");
+	if ((await unsupportedFilesystemBoundary(signal, () => stat(rootEntrypoint).catch(() => null)))?.isFile()) return "server.js";
+	const candidates = [];
+	await walk(artifactDir);
+	candidates.sort((left, right) => left.split("/").length - right.split("/").length || left.localeCompare(right));
+	const selected = candidates[0];
+	if (!selected) throw new Error(`Next.js standalone output did not contain server.js in ${artifactDir}`);
+	return selected;
+	async function walk(directory) {
+		const entries = await unsupportedFilesystemBoundary(signal, () => readdir(directory, { withFileTypes: true }));
+		for (const entry of entries) {
+			if (entry.name === "node_modules") continue;
+			const fullPath = path.join(directory, entry.name);
+			if (entry.isDirectory()) {
+				await walk(fullPath);
+				continue;
+			}
+			if (entry.isFile() && entry.name === "server.js") candidates.push(path.relative(artifactDir, fullPath).split(path.sep).join("/"));
+		}
+	}
+}
 function nextjsServerSubpath(entrypoint) {
 	const dir = path.posix.dirname(entrypoint);
 	return dir === "." ? "" : dir;

package/dist/lib/app/preview-provider.js

@@ -165,7 +165,8 @@ function createPreviewAppProvider(client, options) {
 					appPath: path.resolve(options.cwd),
 					entrypoint: options.entrypoint,
 					buildType: options.buildType,
-					signal: options.signal
+					signal: options.signal,
+					buildSettings: options.buildSettings
 				}),
 				projectId: options.projectId,
 				serviceId: resolvedApp.appId,

package/dist/lib/app/production-deploy-gate.js

@@ -3,22 +3,22 @@ import { canPrompt } from "../../shell/runtime.js";
 import { confirmPrompt } from "../../shell/prompt.js";
 //#region src/lib/app/production-deploy-gate.ts
 async function enforceProductionDeployGate(context, provider, options) {
-	if (options.branchKind !== "production") return;
+	if (options.branchKind !== "production") return { firstProductionDeploy: false };
 	if (!options.appId) {
 		renderFirstProductionDeployLine(context, options.appName);
-		return;
+		return { firstProductionDeploy: true };
 	}
 	const currentLiveDeployment = resolveCurrentProductionDeployment(await provider.listDeployments(options.appId).catch((error) => {
 		throw productionDeployInspectionFailedError(error);
 	}));
 	if (!currentLiveDeployment) {
 		renderFirstProductionDeployLine(context, options.appName);
-		return;
+		return { firstProductionDeploy: true };
 	}
 	if (!options.prod) throw productionDeployRequiresFlagError();
 	if (context.flags.yes) {
 		renderProductionDeployYesLine(context);
-		return;
+		return { firstProductionDeploy: false };
 	}
 	if (!canPrompt(context)) throw productionDeployConfirmationRequiredError(options.appName);
 	renderProductionDeployConfirmation(context, currentLiveDeployment);
@@ -28,6 +28,7 @@ async function enforceProductionDeployGate(context, provider, options) {
 		message: "Deploy to production?",
 		initialValue: false
 	})) throw productionDeployCancelledError();
+	return { firstProductionDeploy: false };
 }
 function resolveCurrentProductionDeployment(result) {
 	if (result.deployments.length === 0) return null;

package/dist/presenters/app.js

@@ -43,11 +43,16 @@ function renderAppDeploy(context, descriptor, result) {
 	];
 }
 function serializeAppDeploy(result) {
-	const { deploySettings: _deploySettings, localPin: _localPin, ...serialized } = result;
+	const { deploySettings, localPin: _localPin, ...serialized } = result;
 	const { id: _branchId, ...branch } = serialized.branch;
 	return {
 		...serialized,
-		branch
+		branch,
+		deploySettings: {
+			config: deploySettings.config,
+			buildCommand: deploySettings.buildCommand,
+			outputDirectory: deploySettings.outputDirectory
+		}
 	};
 }
 function renderBranchDatabaseDeploySummary(context, result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/cli",
-  "version": "3.0.0-dev.69.1",
+  "version": "3.0.0-dev.71.1",
   "description": "Command-line interface for the Prisma Developer Platform.",
   "type": "module",
   "bin": {