vibeview 0.49.0 → 0.51.0

package/README.md

@@ -40,11 +40,34 @@ Build your React Native app on VibeView's build fleet — no Mac, no CI
 pipeline, no local toolchain:
 
 ```bash
-vibeview build --cloud                  # simulator/emulator build
+vibeview build --cloud                  # development build (loads JS from Metro)
+vibeview build --cloud --profile preview  # Release build that runs without Metro
 vibeview build --cloud --production     # signed release build (.ipa / .aab)
 ```
 
-A regular cloud build lands in your app's Build History, ready to run on a
+Each command builds a named profile from `vibeview.json` (`development`,
+`preview`, `production`, or one of your own; the `profiles` shape needs CLI
+0.51.0 or later):
+
+```json
+{
+  "platforms": {
+    "ios": {
+      "build": {
+        "profiles": {
+          "development": { "command": "...", "artifact": "..." },
+          "preview": { "command": "...", "artifact": "..." },
+          "production": { "command": "...", "artifact": "...", "autoIncrement": true }
+        }
+      }
+    }
+  }
+}
+```
+
+A missing profile is asked for once and saved; a React Native or Expo setup
+that accepts the suggested command also saves `preview`. A simulator or
+emulator cloud build lands in your app's Build History, ready to run on a
 cloud device. Add `--production` for a **signed release build** on iOS,
 tvOS, Android, or Android TV, using signing credentials you store once:
 
@@ -74,7 +97,7 @@ vibeview webhooks add --url https://ci.example.com/hooks/vibeview
 Webhooks POST a signed payload to your endpoint whenever a build finishes.
 Manage running builds with `vibeview builds list | logs | download | cancel`.
 
-Set `"autoIncrement": true` in a platform's `build` block and every
+Set `"autoIncrement": true` on a platform's `production` profile and every
 production build gets a server-assigned build number, injected into the
 build as `VIBEVIEW_BUILD_NUMBER` (inspect or seed the counters with
 `vibeview versions list/set`).
@@ -159,7 +182,7 @@ Output formats: `human`, `json`, and `junit` for any CI system. The exit code re
 | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
 | `vibeview login` / `logout` / `whoami`                      | Authenticate via browser, sign out, show who you are                                                     |
 | `vibeview dev`                                              | Live development on a cloud device                                                                       |
-| `vibeview build`                                            | Build your app — locally, or on the build fleet with `--cloud` (add `--production` for a signed release) |
+| `vibeview build`                                            | Build your app — locally, or on the build fleet with `--cloud` (`--profile <name>` picks the build; `--production` for a signed release) |
 | `vibeview builds list/logs/download/cancel/delete-artifact` | Manage cloud builds and their artifacts                                                                  |
 | `vibeview versions list/set`                                | Server-side build-number counters for `autoIncrement` production builds                                  |
 | `vibeview credentials add/generate/list/rm/download`        | App-signing credentials for production builds (`generate` covers iOS, tvOS, and Android)                 |

package/dist/{chunk-X5F4DA3S.js → chunk-ECWDMUNS.js}

@@ -40,6 +40,149 @@ function isNotRunMessage(message) {
   return (message ?? "").startsWith("Not run:");
 }
 
+// src/lib/build-profiles.ts
+var DEVELOPMENT = "development";
+var PREVIEW = "preview";
+var PRODUCTION = "production";
+var PROFILE_NAME_RE = /^[a-z][a-z0-9-]{0,31}$/;
+var DISTRIBUTIONS = ["simulator", "production"];
+function defaultDistribution(name) {
+  return name === PRODUCTION ? "production" : "simulator";
+}
+function rawProfile(build, name) {
+  const own = build.profiles && Object.hasOwn(build.profiles, name) ? build.profiles[name] : void 0;
+  if (own) return own;
+  if (name === DEVELOPMENT && build.command && build.artifact) {
+    return { command: build.command, artifact: build.artifact };
+  }
+  if (name === PRODUCTION && build.productionCommand && build.productionArtifact) {
+    return { command: build.productionCommand, artifact: build.productionArtifact };
+  }
+  return null;
+}
+function hasProfile(build, name) {
+  return !!build && rawProfile(build, name) !== null;
+}
+function resolveProfile(build, name) {
+  if (!build) return null;
+  const p = rawProfile(build, name);
+  if (!p) return null;
+  const distribution = p.distribution ?? defaultDistribution(name);
+  const env = build.env === void 0 && p.env === void 0 ? void 0 : { ...build.env, ...p.env };
+  const xcode = p.xcode ?? build.xcode;
+  const node = p.node ?? build.node;
+  const autoIncrement = (p.autoIncrement ?? (name === PRODUCTION ? build.autoIncrement : void 0)) === true;
+  return {
+    name,
+    command: p.command,
+    artifact: p.artifact,
+    distribution,
+    ...env !== void 0 ? { env } : {},
+    ...xcode !== void 0 ? { xcode } : {},
+    ...node !== void 0 ? { node } : {},
+    autoIncrement
+  };
+}
+function missingProfileMessage(platformKey, name) {
+  return `no "${name}" profile for ${platformKey}: add platforms.${platformKey}.build.profiles.${name} {command, artifact} to vibeview.json`;
+}
+function developmentProfile(build) {
+  return resolveProfile(build, DEVELOPMENT);
+}
+function withProfile(build, name, profile) {
+  const {
+    command,
+    artifact,
+    productionCommand,
+    productionArtifact,
+    autoIncrement,
+    profiles,
+    ...shared
+  } = build ?? {};
+  const next = {};
+  const out = { ...shared };
+  if (command && artifact) next[DEVELOPMENT] = { command, artifact };
+  if (productionCommand && productionArtifact) {
+    next[PRODUCTION] = { command: productionCommand, artifact: productionArtifact };
+  } else if (name !== PRODUCTION) {
+    if (productionCommand) out.productionCommand = productionCommand;
+    if (productionArtifact) out.productionArtifact = productionArtifact;
+  }
+  Object.assign(next, profiles);
+  next[name] = profile;
+  out.profiles = next;
+  if (autoIncrement !== void 0) {
+    const production = next[PRODUCTION];
+    if (!production) out.autoIncrement = autoIncrement;
+    else if (production.autoIncrement === void 0) {
+      next[PRODUCTION] = { ...production, autoIncrement };
+    }
+  }
+  return out;
+}
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function nonEmpty(v) {
+  return typeof v === "string" && v.length > 0;
+}
+function validateBuildBlock(build, key) {
+  if (!isObject(build)) {
+    throw new Error(`vibeview.json: platforms.${key}.build must be an object with profiles`);
+  }
+  const at = `vibeview.json: platforms.${key}.build`;
+  if ("command" in build || "artifact" in build) {
+    if (!nonEmpty(build.command)) throw new Error(`${at}.command must be a non-empty string`);
+    if (!nonEmpty(build.artifact)) throw new Error(`${at}.artifact must be a non-empty string`);
+  }
+  for (const field of ["productionCommand", "productionArtifact"]) {
+    if (field in build && !nonEmpty(build[field])) {
+      throw new Error(`${at}.${field} must be a non-empty string`);
+    }
+  }
+  const profiles = build.profiles;
+  if (profiles !== void 0) {
+    if (!isObject(profiles)) {
+      throw new Error(`${at}.profiles must be an object of named profiles`);
+    }
+    for (const [name, p] of Object.entries(profiles)) {
+      if (!PROFILE_NAME_RE.test(name)) {
+        throw new Error(
+          `${at}.profiles: "${name}" is not a valid profile name (lowercase letters, digits and dashes, starting with a letter)`
+        );
+      }
+      if (!isObject(p)) throw new Error(`${at}.profiles.${name} must be an object`);
+      if (!nonEmpty(p.command)) {
+        throw new Error(`${at}.profiles.${name}.command must be a non-empty string`);
+      }
+      if (!nonEmpty(p.artifact)) {
+        throw new Error(`${at}.profiles.${name}.artifact must be a non-empty string`);
+      }
+      if (p.distribution !== void 0 && !DISTRIBUTIONS.includes(p.distribution)) {
+        throw new Error(`${at}.profiles.${name}.distribution must be "simulator" or "production"`);
+      }
+    }
+    if ("command" in build && DEVELOPMENT in profiles) {
+      throw new Error(
+        `${at}: the development profile is defined twice \u2014 keep profiles.development and remove build.command and build.artifact`
+      );
+    }
+    if ("productionCommand" in build && PRODUCTION in profiles) {
+      throw new Error(
+        `${at}: the production profile is defined twice \u2014 keep profiles.production and remove build.productionCommand and build.productionArtifact`
+      );
+    }
+  }
+  const legacyDevelopment = nonEmpty(build.command);
+  const legacyProduction = nonEmpty(build.productionCommand) && nonEmpty(build.productionArtifact);
+  const named = isObject(profiles) && Object.keys(profiles).length > 0;
+  if (!legacyDevelopment && !legacyProduction && !named) {
+    throw new Error(
+      `${at} needs at least one profile: add build.profiles.development {command, artifact}`
+    );
+  }
+}
+
 // src/lib/dev-config.ts
 import { readFileSync, renameSync, rmSync, writeFileSync } from "fs";
 import { join } from "path";
@@ -121,33 +264,7 @@ function loadDevConfig(cwd) {
       throw new Error(`vibeview.json: platforms.${key}.appId must be a non-empty string`);
     }
     if (entry.build !== void 0) {
-      if (typeof entry.build !== "object" || entry.build === null) {
-        throw new Error(
-          `vibeview.json: platforms.${key}.build must be an object with command and artifact`
-        );
-      }
-      if (typeof entry.build.command !== "string" || !entry.build.command) {
-        throw new Error(`vibeview.json: platforms.${key}.build.command must be a non-empty string`);
-      }
-      if (typeof entry.build.artifact !== "string" || !entry.build.artifact) {
-        throw new Error(
-          `vibeview.json: platforms.${key}.build.artifact must be a non-empty string`
-        );
-      }
-      if (entry.build.productionCommand !== void 0) {
-        if (typeof entry.build.productionCommand !== "string" || !entry.build.productionCommand) {
-          throw new Error(
-            `vibeview.json: platforms.${key}.build.productionCommand must be a non-empty string`
-          );
-        }
-      }
-      if (entry.build.productionArtifact !== void 0) {
-        if (typeof entry.build.productionArtifact !== "string" || !entry.build.productionArtifact) {
-          throw new Error(
-            `vibeview.json: platforms.${key}.build.productionArtifact must be a non-empty string`
-          );
-        }
-      }
+      validateBuildBlock(entry.build, key);
     }
     if (entry.watchIgnore !== void 0) {
       if (!Array.isArray(entry.watchIgnore)) {
@@ -170,38 +287,54 @@ function loadDevConfig(cwd) {
   }
   return cfg;
 }
-function validateBuildEnv(env, platformKey) {
+function validateBuildEnv(env, platformKey, at = "build") {
   if (env === void 0) return;
   if (typeof env !== "object" || env === null || Array.isArray(env)) {
     throw new Error(
-      `vibeview.json: platforms.${platformKey}.build.env must be an object of string values`
+      `vibeview.json: platforms.${platformKey}.${at}.env must be an object of string values`
     );
   }
   for (const [envKey, envValue] of Object.entries(env)) {
     if (typeof envValue !== "string") {
       throw new Error(
-        `vibeview.json: platforms.${platformKey}.build.env must be an object of string values`
+        `vibeview.json: platforms.${platformKey}.${at}.env must be an object of string values`
       );
     }
     if (!ENV_KEY_RE.test(envKey)) {
       throw new Error(
-        `vibeview.json: platforms.${platformKey}.build.env key "${envKey}" is not a valid environment variable name (must match ${ENV_KEY_RE})`
+        `vibeview.json: platforms.${platformKey}.${at}.env key "${envKey}" is not a valid environment variable name (must match ${ENV_KEY_RE})`
       );
     }
   }
 }
 var XCODE_PLATFORMS = ["ios", "tvos"];
 var XCODE_VERSION_RE = /^\d+\.\d+$/;
-function validateBuildXcode(xcode, platformKey) {
+function validateBuildXcode(xcode, platformKey, at = "build") {
   if (xcode === void 0) return;
   if (!XCODE_PLATFORMS.includes(platformKey)) {
     throw new Error(
-      `vibeview.json: platforms.${platformKey}.build.xcode only applies to ios and tvos builds \u2014 remove it from the ${platformKey} block`
+      `vibeview.json: platforms.${platformKey}.${at}.xcode only applies to ios and tvos builds \u2014 remove it from the ${platformKey} block`
     );
   }
   if (typeof xcode !== "string" || !XCODE_VERSION_RE.test(xcode)) {
     throw new Error(
-      `vibeview.json: platforms.${platformKey}.build.xcode must be a version string like "27.1"`
+      `vibeview.json: platforms.${platformKey}.${at}.xcode must be a version string like "27.1"`
+    );
+  }
+}
+function normalizeNodeVersion(value) {
+  if (typeof value === "number") {
+    return Number.isInteger(value) && value > 0 && value < 1e3 ? String(value) : null;
+  }
+  if (typeof value !== "string") return null;
+  const m = /^v?(\d{1,3})(?:\.x)?$/.exec(value.trim());
+  return m ? String(Number(m[1])) : null;
+}
+function validateBuildNode(node, platformKey, at = "build") {
+  if (node === void 0) return;
+  if (normalizeNodeVersion(node) === null) {
+    throw new Error(
+      `vibeview.json: platforms.${platformKey}.${at}.node must be a Node.js major version like "24"`
     );
   }
 }
@@ -1301,6 +1434,57 @@ function iosArchiveExportCommand(ws, scheme = ws) {
 function managedExpoIosProductionCommand(cwd, name) {
   return `${installCommand(cwd)} && npx expo prebuild --platform ios && ` + iosArchiveExportCommand(name);
 }
+function hasSeparatePreview(cwd, platform) {
+  const flavor = detectFlavor(cwd);
+  if (flavor !== "expo" && flavor !== "bare-rn") return false;
+  if (platform === "ios") return true;
+  if (platform !== "android") return false;
+  return isManagedExpo(cwd, "android") || releaseSignedWithDebugKey(cwd);
+}
+function releaseSignedWithDebugKey(cwd) {
+  for (const file of ["android/app/build.gradle", "android/app/build.gradle.kts"]) {
+    let text;
+    try {
+      text = readFileSync6(join5(cwd, file), "utf-8");
+    } catch {
+      continue;
+    }
+    const release = gradleBlock(gradleBlock(text, "buildTypes") ?? "", "release");
+    if (release === null) return false;
+    return /signingConfig\s*=?\s*signingConfigs\s*\.\s*(?:debug\b|getByName\(\s*"debug"\s*\))/.test(
+      release
+    );
+  }
+  return false;
+}
+function gradleBlock(text, name) {
+  const m = new RegExp(`(?:(?:^|[^\\w.])${name}|getByName\\(\\s*"${name}"\\s*\\))\\s*\\{`).exec(
+    text
+  );
+  if (!m) return null;
+  let depth = 1;
+  const start = m.index + m[0].length;
+  for (let i = start; i < text.length; i++) {
+    if (text[i] === "{") depth++;
+    else if (text[i] === "}" && --depth === 0) return text.slice(start, i);
+  }
+  return null;
+}
+function toReleaseBuild(dev2) {
+  const swap = (v) => v?.replace(/-configuration Debug\b/g, "-configuration Release").replace(/Debug-iphonesimulator/g, "Release-iphonesimulator").replace(/assembleDebug\b/g, "assembleRelease").replace(/apk\/debug\//g, "apk/release/");
+  const out = {};
+  if (dev2.buildCommand !== void 0) out.buildCommand = swap(dev2.buildCommand);
+  if (dev2.artifact !== void 0) out.artifact = swap(dev2.artifact);
+  if (dev2.metroCommand !== void 0) out.metroCommand = dev2.metroCommand;
+  return out;
+}
+function previewDefaultsFor(cwd, platform, evaluatedIosName) {
+  const dev2 = defaultsFor(cwd, platform, evaluatedIosName);
+  if (hasSeparatePreview(cwd, platform)) return toReleaseBuild(dev2);
+  const flavor = detectFlavor(cwd);
+  if (platform === "android" && (flavor === "expo" || flavor === "bare-rn")) return {};
+  return dev2;
+}
 function productionDefaultsFor(cwd, platform, evaluatedIosName) {
   const flavor = detectFlavor(cwd);
   if ((flavor === "flutter" || flavor === "capacitor" || flavor === "native") && platform !== "tvos" && platform !== "roku") {
@@ -1480,7 +1664,8 @@ function evaluatedExpoName(cwd, readConfig, onEvaluate) {
 }
 async function resolvedDefaultsFor(cwd, platform, opts = {}) {
   const { production = false, readConfig = (c) => readExpoConfig(c), onEvaluate } = opts;
-  const base = production ? productionDefaultsFor : defaultsFor;
+  const profile = opts.profile ?? (production ? "production" : "development");
+  const base = profile === "production" ? productionDefaultsFor : profile === "preview" ? previewDefaultsFor : defaultsFor;
   const dynamic = dynamicExpoConfig(cwd);
   if (platform !== "ios" || !dynamic || !isManagedExpo(cwd, "ios")) {
     return base(cwd, platform);
@@ -1525,7 +1710,7 @@ function fillLaterHint(skipped, platform) {
   const lines = ["You can enable one-command builds later \u2014 add to vibeview.json:"];
   if (skipped.build) {
     lines.push(
-      `  platforms.${platform}.build = { "command": "<your build command>", "artifact": "<path to .app/.apk>" }`
+      `  platforms.${platform}.build.profiles.development = { "command": "<your build command>", "artifact": "<path to .app/.apk>" }`
     );
   }
   if (skipped.metro) {
@@ -1571,56 +1756,44 @@ async function commandSelect(message, detected) {
   choices.push({ value: "skip", name: "Skip for now" });
   return select({ message, choices });
 }
-async function promptBuildConfig(cwd, platform) {
-  const defaults = await promptDefaults(cwd, platform);
+function commandLabel(profile) {
+  if (profile === DEVELOPMENT) return "Build command";
+  return `${profile.charAt(0).toUpperCase()}${profile.slice(1)} build command`;
+}
+async function promptProfileConfig(cwd, platform, profile) {
+  const production = profile === PRODUCTION;
+  const defaults = await promptDefaults(cwd, platform, { profile });
   evaluatedConfigNote(cwd, defaults);
-  const choice = await commandSelect(`Build command for ${platform}`, defaults.buildCommand);
+  const label = commandLabel(profile);
+  const choice = await commandSelect(`${label} for ${platform}`, defaults.buildCommand);
   if (choice === "skip") return null;
   if (choice === "default") {
     return { command: defaults.buildCommand, artifact: defaults.artifact };
   }
   console.log(
     chalk2.dim(
-      "  Tip: include your install step \u2014 dependencies are not uploaded.\n       e.g. `yarn install --immutable && yarn build:android`"
+      "  Tip: include your install step \u2014 dependencies are not uploaded.\n" + (production ? "       e.g. `yarn install --immutable && cd android && ./gradlew bundleRelease`" : "       e.g. `yarn install --immutable && yarn build:android`")
     )
   );
-  const command = await input({ message: `Build command for ${platform}`, required: true });
+  const command = await input({ message: `${label} for ${platform}`, required: true });
   const artifact = await input({
-    message: platform === "roku" ? "Path to the channel zip it produces (* allowed)" : "Path to the built app it produces (.apk, or .app dir; * allowed)",
+    message: production ? "Path to the signed production artifact it produces (.aab/.ipa; * allowed)" : platform === "roku" ? "Path to the channel zip it produces (* allowed)" : "Path to the built app it produces (.apk, or .app dir; * allowed)",
     default: defaults.artifact,
     required: true
   });
   return { command, artifact };
 }
-async function promptProductionBuildConfig(cwd, platform) {
-  const defaults = await promptDefaults(cwd, platform, { production: true });
-  evaluatedConfigNote(cwd, defaults);
-  const choice = await commandSelect(
-    `Production build command for ${platform}`,
-    defaults.buildCommand
-  );
-  if (choice === "skip") return null;
-  if (choice === "default") {
-    return {
-      productionCommand: defaults.buildCommand,
-      productionArtifact: defaults.artifact
-    };
-  }
-  console.log(
-    chalk2.dim(
-      "  Tip: include your install step \u2014 dependencies are not uploaded.\n       e.g. `yarn install --immutable && cd android && ./gradlew bundleRelease`"
-    )
-  );
-  const productionCommand = await input({
-    message: `Production build command for ${platform}`,
-    required: true
-  });
-  const productionArtifact = await input({
-    message: "Path to the signed production artifact it produces (.aab/.ipa; * allowed)",
-    default: defaults.artifact,
-    required: true
-  });
-  return { productionCommand, productionArtifact };
+async function promptBuildConfig(cwd, platform) {
+  return promptProfileConfig(cwd, platform, DEVELOPMENT);
+}
+async function companionPreview(cwd, platform, development) {
+  if (!hasSeparatePreview(cwd, platform)) return null;
+  const dev2 = await promptDefaults(cwd, platform);
+  if (dev2.buildCommand !== development.command || dev2.artifact !== development.artifact)
+    return null;
+  const preview = toReleaseBuild(dev2);
+  if (!preview.buildCommand || !preview.artifact) return null;
+  return { command: preview.buildCommand, artifact: preview.artifact };
 }
 async function promptMetroCommand(cwd, platform) {
   const defaults = defaultsFor(cwd, platform);
@@ -1800,6 +1973,39 @@ function runTar(args) {
   });
 }
 
+// src/lib/cloud-manifest-entry.ts
+function validateCloudProfile(build, platformKey, name) {
+  validateBuildEnv(build.env, platformKey);
+  validateBuildXcode(build.xcode, platformKey);
+  validateBuildNode(build.node, platformKey);
+  const own = build.profiles?.[name];
+  if (own) {
+    const at = `build.profiles.${name}`;
+    validateBuildEnv(own.env, platformKey, at);
+    validateBuildXcode(own.xcode, platformKey, at);
+    validateBuildNode(own.node, platformKey, at);
+  }
+}
+function cloudManifestEntry(platform, profile, opts = {}) {
+  const production = profile.distribution === "production";
+  const xcode = platformUsesXcode(platform) ? opts.xcode ?? profile.xcode : void 0;
+  const node = opts.node ?? (profile.node === void 0 ? void 0 : normalizeNodeVersion(profile.node));
+  return {
+    platform,
+    ...opts.appPublicId ? { app_public_id: opts.appPublicId } : {},
+    profile: profile.name,
+    command: profile.command,
+    artifact_path: profile.artifact,
+    distribution: profile.distribution,
+    ...profile.env !== void 0 ? { env: profile.env } : {},
+    // autoIncrement is a PRODUCTION-only concept (the server-side build
+    // number is a store number).
+    ...profile.autoIncrement && production ? { auto_increment: true } : {},
+    ...xcode ? { xcode } : {},
+    ...node ? { node } : {}
+  };
+}
+
 // src/lib/build-preflight.ts
 import { execFile as execFile4 } from "child_process";
 import { realpathSync, statSync as statSync4 } from "fs";
@@ -2072,81 +2278,86 @@ async function resolveBarePlatform(cwd, cfg, opts) {
   }
   return platform;
 }
-function persistPromptedBuild(cwd, platform, build) {
+function persistPromptedProfiles(cwd, platform, profiles) {
   return updateDevConfig(cwd, platform, (next) => {
-    const entry = next.platforms[platform];
-    if (entry) {
-      entry.build = build;
-    } else {
-      next.platforms[platform] = { build };
-    }
+    const entry = next.platforms[platform] ?? (next.platforms[platform] = {});
+    let build = entry.build;
+    for (const [name, profile] of Object.entries(profiles))
+      build = withProfile(build, name, profile);
+    entry.build = build;
   });
 }
 function persistUploadedAppId(cwd, platform, build, appId) {
   updateDevConfig(cwd, platform, (next) => {
     const entry = next.platforms[platform];
     if (!entry) {
-      next.platforms[platform] = { appId, build };
+      next.platforms[platform] = build ? { appId, build } : { appId };
       return true;
     }
     if (entry.appId === appId && entry.build) return false;
     entry.appId = appId;
-    if (!entry.build) entry.build = build;
+    if (!entry.build && build) entry.build = build;
     return true;
   });
 }
-async function resolveBuildConfig(cwd, cfgRef, platform, opts) {
-  const existing = cfgRef.current?.platforms?.[platform]?.build;
+function requestedProfile(opts) {
+  return opts.profile ?? (opts.production ? PRODUCTION : DEVELOPMENT);
+}
+async function resolveBuildProfile(cwd, cfgRef, platform, opts) {
+  const name = requestedProfile(opts);
+  const build = cfgRef.current?.platforms?.[platform]?.build;
+  const existing = resolveProfile(build, name);
   if (existing) return existing;
   if (opts.json || !process.stdin.isTTY) {
-    fail(
-      opts,
-      `no build config for ${platform}: add platforms.${platform}.build {command, artifact} to vibeview.json`,
-      "config_required"
-    );
+    fail(opts, missingProfileMessage(platform, name), "config_required");
   }
-  const answered = await promptBuildConfig(cwd, platform);
+  const answered = await promptProfileConfig(cwd, platform, name);
   if (!answered) {
-    fail(opts, "build config is required to run vibeview build", "config_required");
-  }
-  cfgRef.current = persistPromptedBuild(cwd, platform, answered);
-  return answered;
-}
-function persistPromptedProductionBuild(cwd, platform, production) {
-  return updateDevConfig(cwd, platform, (next) => {
-    mergeProductionPair(next, platform, production);
-  });
-}
-function mergeProductionPair(next, platform, production) {
-  const existingBuild = next.platforms[platform]?.build;
-  if (!existingBuild?.command || !existingBuild?.artifact) {
-    throw new Error(
-      `internal: cannot persist a production build config for ${platform} before its debug command/artifact are resolved`
-    );
-  }
-  next.platforms[platform].build = { ...existingBuild, ...production };
-}
-async function resolveProductionBuildConfig(cwd, cfgRef, platform, opts) {
-  const entry = cfgRef.current?.platforms?.[platform]?.build;
-  if (entry?.productionCommand && entry?.productionArtifact) {
-    return { command: entry.productionCommand, artifact: entry.productionArtifact };
-  }
-  if (opts.json || !process.stdin.isTTY) {
     fail(
       opts,
-      `no production build config for ${platform}: add platforms.${platform}.build.productionCommand/productionArtifact to vibeview.json`,
+      name === PRODUCTION ? "a production build config is required for --production" : `a "${name}" build profile is required to run vibeview build`,
       "config_required"
     );
   }
-  const answered = await promptProductionBuildConfig(cwd, platform);
-  if (!answered) {
-    fail(opts, "a production build config is required for --production", "config_required");
+  const save = { [name]: answered };
+  if (name === DEVELOPMENT && !hasProfile(build, PREVIEW)) {
+    const preview = await companionPreview(cwd, platform, answered);
+    if (preview) {
+      save[PREVIEW] = preview;
+      console.error(
+        chalk3.dim(
+          `  Also saved a preview profile for ${platform}: the same build in Release, which runs without Metro
+  (share links, tests, GitHub pull requests). Build it with \`vibeview build --cloud --profile preview\`.`
+        )
+      );
+    }
   }
-  cfgRef.current = persistPromptedProductionBuild(cwd, platform, answered);
-  return { command: answered.productionCommand, artifact: answered.productionArtifact };
+  cfgRef.current = persistPromptedProfiles(cwd, platform, save);
+  return resolveProfile(cfgRef.current.platforms[platform]?.build, name);
 }
 async function buildCommand(opts, cloudDeps) {
   const cwd = process.cwd();
+  if (opts.profile !== void 0) {
+    if (!PROFILE_NAME_RE.test(opts.profile)) {
+      printFailure(
+        opts,
+        `--profile must be a profile name (lowercase letters, digits and dashes, starting with a letter), got "${opts.profile}"`,
+        "usage"
+      );
+      process.exitCode = 2;
+      return;
+    }
+    if (opts.production && opts.profile !== PRODUCTION) {
+      printFailure(
+        opts,
+        `--production builds the production profile \u2014 pass --production or --profile ${opts.profile}, not both`,
+        "usage"
+      );
+      process.exitCode = 2;
+      return;
+    }
+  }
+  opts = { ...opts, production: requestedProfile(opts) === PRODUCTION };
   const cfgRef = { current: loadDevConfig(cwd) };
   try {
     if (opts.cloud) {
@@ -2167,18 +2378,37 @@ async function buildCommand(opts, cloudDeps) {
         "usage"
       );
     }
+    if (opts.node !== void 0) {
+      fail(
+        opts,
+        "--node requires --cloud: a local build uses the Node.js on this machine",
+        "usage"
+      );
+    }
     const platform = await resolveBarePlatform(cwd, cfgRef.current, opts);
-    const build = await resolveBuildConfig(cwd, cfgRef, platform, opts);
+    const profile = await resolveBuildProfile(cwd, cfgRef, platform, opts);
+    if (profile.distribution === "production") {
+      fail(
+        opts,
+        `the "${profile.name}" profile is a signed production build, which runs in the cloud (vibeview build --cloud --profile ${profile.name})`,
+        "usage"
+      );
+    }
     const result = await runBuildForPlatform(
       cwd,
       platform,
-      build,
+      profile,
       opts,
       (l) => console.error(chalk3.dim(l))
     );
     for (const w of result.warnings ?? []) console.error(chalk3.yellow(`\u26A0 ${w}`));
     if (result.launch_warning) console.error(chalk3.yellow(`\u26A0 ${result.launch_warning}`));
-    persistUploadedAppId(cwd, platform, build, result.public_id);
+    persistUploadedAppId(
+      cwd,
+      platform,
+      cfgRef.current?.platforms?.[platform]?.build,
+      result.public_id
+    );
     if (opts.json) {
       console.log(
         JSON.stringify({ app_id: result.public_id, name: result.name, platform: result.platform })
@@ -2235,6 +2465,25 @@ async function resolveCloudPlatforms(cwd, cfgRef, opts) {
           );
         }
       }
+      if (opts.json || !process.stdin.isTTY) {
+        const name = requestedProfile(opts);
+        const missing = chosenPlatforms.filter(
+          (p) => !hasProfile(cfgRef.current?.platforms?.[p]?.build, name)
+        );
+        for (const p of missing) {
+          const reason = `no "${name}" profile in vibeview.json`;
+          emitCloud(opts.json, { event: "skipped", platform: p, reason });
+          if (!opts.json) console.error(chalk3.yellow(`\u26A0 skipping ${p}: ${reason}`));
+        }
+        chosenPlatforms = chosenPlatforms.filter((p) => !missing.includes(p));
+        if (chosenPlatforms.length === 0) {
+          fail(
+            opts,
+            `--platform all: no configured platform has a "${name}" profile \u2014 add platforms.<platform>.build.profiles.${name} {command, artifact} to vibeview.json`,
+            "config_required"
+          );
+        }
+      }
       return chosenPlatforms;
     }
     if (opts.json || !process.stdin.isTTY) {
@@ -2250,13 +2499,13 @@ async function resolveCloudPlatforms(cwd, cfgRef, opts) {
     });
     requireCloudCapable(opts, chosen);
     requireProductionCapable(opts, chosen);
-    await resolveBuildConfig(cwd, cfgRef, chosen, opts);
+    await resolveBuildProfile(cwd, cfgRef, chosen, opts);
     return [chosen];
   }
   const platform = opts.platform ? validateExplicitPlatform(opts.platform) : await resolveBarePlatform(cwd, cfgRef.current, opts);
   requireCloudCapable(opts, platform);
   requireProductionCapable(opts, platform);
-  await resolveBuildConfig(cwd, cfgRef, platform, opts);
+  await resolveBuildProfile(cwd, cfgRef, platform, opts);
   return [platform];
 }
 function validateExplicitPlatform(raw) {
@@ -2437,6 +2686,10 @@ async function runCloudBuildCommand(cwd, cfgRef, opts, deps) {
   if (opts.xcode !== void 0 && !XCODE_VERSION_RE.test(opts.xcode)) {
     fail(opts, `--xcode must be a version like 27.1, got "${opts.xcode}"`, "usage");
   }
+  const nodeFlag = opts.node === void 0 ? void 0 : normalizeNodeVersion(opts.node);
+  if (nodeFlag === null) {
+    fail(opts, `--node must be a Node.js major version like 24, got "${opts.node}"`, "usage");
+  }
   const platforms = await resolveCloudPlatforms(cwd, cfgRef, opts);
   if (opts.xcode !== void 0 && !platforms.some(platformUsesXcode)) {
     fail(
@@ -2449,18 +2702,19 @@ async function runCloudBuildCommand(cwd, cfgRef, opts, deps) {
   const client = new ApiClient(baseUrl, token);
   const d = deps ?? defaultCloudBuildDeps(client);
   const createFromArtifact = await resolveCloudAppIds(cwd, cfgRef, platforms, opts, d.listApps);
-  const productionBuilds = /* @__PURE__ */ new Map();
-  if (opts.production) {
-    for (const p of platforms) {
-      productionBuilds.set(p, await resolveProductionBuildConfig(cwd, cfgRef, p, opts));
-    }
+  const profiles = /* @__PURE__ */ new Map();
+  for (const p of platforms) {
+    profiles.set(p, await resolveBuildProfile(cwd, cfgRef, p, opts));
   }
   const cfg = cfgRef.current;
   for (const p of platforms) {
+    const profile = profiles.get(p);
     try {
-      validateBuildEnv(cfg?.platforms?.[p]?.build?.env, p);
-      validateBuildXcode(cfg?.platforms?.[p]?.build?.xcode, p);
-      if (cfg?.platforms?.[p]?.build?.autoIncrement === true && opts.production && createFromArtifact.has(p)) {
+      validateCloudProfile(cfg.platforms[p].build, p, profile.name);
+      if (profile.distribution === "production" && !PRODUCTION_SIGNING_PLATFORMS.includes(p)) {
+        throw new UsageError(productionUnsupportedReason(p));
+      }
+      if (profile.autoIncrement && profile.distribution === "production" && createFromArtifact.has(p)) {
         throw new UsageError(
           `platforms.${p}.build.autoIncrement needs the build linked to an app \u2014 set appId in vibeview.json (a brand-new app's first build can't auto-increment)`
         );
@@ -2486,7 +2740,7 @@ async function runCloudBuildCommand(cwd, cfgRef, opts, deps) {
     const uploaded = new Set(files);
     const warnings = /* @__PURE__ */ new Map();
     for (const p of platforms) {
-      const command = productionBuilds.get(p)?.command ?? cfg.platforms[p].build.command;
+      const command = profiles.get(p).command;
       const missingPkg = missingPackageJsonError(command, uploaded, cwd);
       if (missingPkg) fail(opts, missingPkg, "no_package_json");
       for (const w of buildCommandWarnings(command, uploaded)) {
@@ -2524,34 +2778,19 @@ ${offenders}`);
     packSpinner?.succeed(`packed source (${files.length} files, ${formatMB(sizeBytes)} MB)`);
     const manifestEntries = platforms.map((p) => {
       const entry = cfg.platforms[p];
-      const build = entry.build;
-      const production = productionBuilds.get(p);
-      const command = production ? production.command : build.command;
-      const artifactPath = production ? production.artifact : build.artifact;
-      const autoIncrement = build.autoIncrement === true;
-      if (autoIncrement && !production && !opts.json) {
+      const profile = profiles.get(p);
+      if (profile.autoIncrement && profile.distribution !== "production" && !opts.json) {
         console.error(
           chalk3.yellow(
             `note: platforms.${p}.build.autoIncrement only applies to production builds (--production) \u2014 ignoring it for this simulator build`
           )
         );
       }
-      const xcode = platformUsesXcode(p) ? opts.xcode ?? build.xcode : void 0;
-      return {
-        platform: p,
-        // OMITTED, never invented, for a platform whose app the artifact will
-        // create (resolveCloudAppIds). Otherwise the non-null assertion is
-        // safe: resolveCloudAppIds ran for every entry in `platforms` above —
-        // it either persisted a picked appId onto the entry, marked the
-        // platform create-from-artifact, or failed the whole command.
-        ...createFromArtifact.has(p) ? {} : { app_public_id: entry.appId },
-        command,
-        artifact_path: artifactPath,
-        distribution: production ? "production" : "simulator",
-        ...build.env ? { env: build.env } : {},
-        ...autoIncrement && production ? { auto_increment: true } : {},
-        ...xcode ? { xcode } : {}
-      };
+      return cloudManifestEntry(p, profile, {
+        xcode: opts.xcode,
+        node: nodeFlag,
+        appPublicId: createFromArtifact.has(p) ? void 0 : entry.appId
+      });
     });
     const uploadSpinner = !opts.json ? createSpinner("uploading source...") : null;
     uploadSpinner?.start();
@@ -2583,8 +2822,11 @@ ${offenders}`);
       return;
     }
     const finished = await waitForCloudBuilds(created, opts, d);
-    if (!opts.production) {
-      persistResolvedAppIds(cwd, cfgRef, createFromArtifact, finished.values());
+    const unlinkedSimulator = new Set(
+      [...createFromArtifact].filter((p) => profiles.get(p)?.distribution !== "production")
+    );
+    if (unlinkedSimulator.size > 0) {
+      persistResolvedAppIds(cwd, cfgRef, unlinkedSimulator, finished.values());
     }
     let downloadFailed = false;
     if (opts.download) {
@@ -3911,7 +4153,20 @@ async function ensureConfig(api, opts) {
   if (!existing) {
     isFirstRun = true;
     if (!opts.json && process.stdin.isTTY) {
-      firstRunBuild = await promptBuildConfig(process.cwd(), platform);
+      const answered = await promptBuildConfig(process.cwd(), platform);
+      if (answered) {
+        firstRunBuild = withProfile(void 0, DEVELOPMENT, answered);
+        const preview = await companionPreview(process.cwd(), platform, answered);
+        if (preview) {
+          firstRunBuild = withProfile(firstRunBuild, PREVIEW, preview);
+          console.error(
+            chalk4.dim(
+              `  Also saved a preview profile for ${platform}: the same build in Release, which runs without Metro
+  (share links, tests, GitHub pull requests). Build it with \`vibeview build --cloud --profile preview\`.`
+            )
+          );
+        }
+      }
       if (PLATFORM_NEEDS_METRO[platform]) {
         firstRunMetro = await promptMetroCommand(process.cwd(), platform);
       }
@@ -3944,7 +4199,7 @@ ${hint}`);
       chalk4.yellow(`\u26A0 app "${choice.staleCached}" no longer exists \u2014 pick your debug build again`)
     );
   }
-  const buildConfig = firstRunBuild ?? entry?.build ?? null;
+  const buildConfig = developmentProfile(firstRunBuild ?? entry?.build);
   if (!appId && buildConfig && typeof opts.build !== "string") {
     const strategy = buildAppStrategy(apps, opts.build === true, opts.json, process.stdin.isTTY);
     let action = strategy === "ask" ? "pick" : strategy;
@@ -4153,7 +4408,7 @@ async function runDevInProcess(opts) {
     }
   }
   const interactive = !opts.json && Boolean(process.stdin.isTTY);
-  const plannedBuild = cfg.savedConfig.platforms?.[cfg.platform]?.build;
+  const plannedBuild = developmentProfile(cfg.savedConfig.platforms?.[cfg.platform]?.build);
   if (!plannedBuild && (opts.build === true && !cfg.builtThisRun || !PLATFORM_NEEDS_METRO[cfg.platform])) {
     const message = noBuildConfigMessage(cfg.platform, interactive);
     console.error(chalk4.red(`error: ${message}`));
@@ -4163,7 +4418,7 @@ async function runDevInProcess(opts) {
   cfg.commitConfig();
   if (opts.build === true && !cfg.builtThisRun) {
     const reloaded = loadDevConfig(process.cwd());
-    const build = reloaded?.platforms?.[cfg.platform]?.build;
+    const build = developmentProfile(reloaded?.platforms?.[cfg.platform]?.build);
     if (!build) {
       const message = noBuildConfigMessage(cfg.platform, interactive);
       console.error(chalk4.red(`error: ${message}`));
@@ -4255,7 +4510,7 @@ async function runDevInProcess(opts) {
     metroPid = metroResult.pid ?? null;
   } else {
     const rokuEntry = loadDevConfig(process.cwd())?.platforms?.[cfg.platform];
-    rokuBuild = rokuEntry?.build;
+    rokuBuild = developmentProfile(rokuEntry?.build) ?? void 0;
     watchIgnore = rokuEntry?.watchIgnore ?? [];
     if (!rokuBuild) {
       const message = noBuildConfigMessage(cfg.platform, interactive);
@@ -5641,6 +5896,7 @@ export {
   stepsNotCheckedLabel,
   notCheckedSuffix,
   outcomeOf,
+  developmentProfile,
   DEV_PLATFORMS,
   PLATFORM_NEEDS_METRO,
   isDevPlatform,

package/dist/cli.js

@@ -8,6 +8,7 @@ import {
   clearDevState,
   createRokuPush,
   dev,
+  developmentProfile,
   feedbackSentLine,
   fetchFinalSummary,
   filterDeviceModels,
@@ -34,7 +35,7 @@ import {
   runAgentVerb,
   runStepsNotChecked,
   stepsNotCheckedLabel
-} from "./chunk-X5F4DA3S.js";
+} from "./chunk-ECWDMUNS.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -2065,7 +2066,7 @@ async function devReload(opts) {
   }
   let build;
   try {
-    build = loadDevConfig(cwd)?.platforms?.roku?.build;
+    build = developmentProfile(loadDevConfig(cwd)?.platforms?.roku?.build);
   } catch (err) {
     fail(
       opts,
@@ -2078,7 +2079,7 @@ async function devReload(opts) {
     fail(
       opts,
       "config_required",
-      "no build config for roku \u2014 run `vibeview build --platform roku` once to set it up",
+      "no development build profile for roku \u2014 run `vibeview build --platform roku` once to set it up",
       1
     );
   }
@@ -2119,7 +2120,7 @@ import chalk16 from "chalk";
 
 // src/lib/formatters/builds.ts
 import chalk15 from "chalk";
-var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP"];
+var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP", "PROFILE"];
 var UNBILLED_STATUSES = /* @__PURE__ */ new Set(["queued", "running"]);
 function formatCostCell(costMicro, status) {
   if (costMicro <= 0 && UNBILLED_STATUSES.has(status)) return "-";
@@ -2144,7 +2145,10 @@ function formatBuildsHuman(builds2) {
     b.status,
     formatUtcTimestamp(b.created_at),
     formatCostCell(b.cost_micro, b.status),
-    b.app_public_id ?? ""
+    b.app_public_id ?? "",
+    // Last, so the columns scripts already read keep their place. A build
+    // from a CLI that predates profiles shows its distribution.
+    b.profile ?? b.distribution ?? ""
   ]);
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
@@ -4369,13 +4373,19 @@ program.command("build").description("Run your configured build command and uplo
   "--download",
   "--cloud only: download the artifact of each succeeded build (implies wait)",
   false
+).option(
+  "--profile <name>",
+  "The vibeview.json build profile to build: development (default), preview, production, or one of your own"
 ).option(
   "--production",
-  "--cloud only: build a signed, installable production artifact (.aab/.ipa) using uploaded signing credentials (see `vibeview credentials add`), instead of the default unsigned simulator build",
+  "--cloud only: build the production profile, a signed, installable artifact (.aab/.ipa) using uploaded signing credentials (see `vibeview credentials add`); same as --profile production",
   false
 ).option(
   "--xcode <version>",
   "--cloud only, ios/tvos: the Xcode version to build with (e.g. 27.1), overriding vibeview.json build.xcode for this run"
+).option(
+  "--node <major>",
+  "--cloud only: the Node.js major to build with (e.g. 24), overriding vibeview.json build.node and the project .nvmrc for this run"
 ).option("--json", "Print the result as one JSON line (NDJSON events with --cloud)", false).action((opts) => buildCommand(opts));
 program.command("submit").description(
   "Submit a succeeded production cloud build's artifact to TestFlight (ios/tvos) or a Google Play track (android/androidtv) \u2014 binary upload only; store listing and review stay in the store consoles"
@@ -4508,7 +4518,7 @@ program.command("dev-reload").description(
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop/dev_reload as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-NOJQ4XLR.js");
+  const { runMcpServer } = await import("./server-IUCBELOJ.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-NOJQ4XLR.js → server-IUCBELOJ.js}

@@ -15,6 +15,7 @@ import {
   createRokuPush,
   decodeScreenshotResult,
   describeDevBuild,
+  developmentProfile,
   effectiveDevConfig,
   feedbackSentLine,
   filterDeviceModels,
@@ -34,7 +35,7 @@ import {
   renderEnvelope,
   resolveMetro,
   startDevSession
-} from "./chunk-X5F4DA3S.js";
+} from "./chunk-ECWDMUNS.js";
 import {
   ApiClient,
   NotFoundError,
@@ -1099,7 +1100,7 @@ function createDevSessionController(auth, webUrl) {
   let idle = null;
   const readRokuBuild = () => {
     try {
-      return loadDevConfig(process.cwd())?.platforms?.roku?.build ?? null;
+      return developmentProfile(loadDevConfig(process.cwd())?.platforms?.roku?.build);
     } catch (err) {
       throw new Error(
         `vibeview.json could not be read: ${err instanceof Error ? err.message : String(err)}`
@@ -1361,7 +1362,7 @@ function createDevSessionController(auth, webUrl) {
       }
       if (!target.build) {
         throw new Error(
-          "no build config for roku \u2014 add platforms.roku.build ({ command, artifact }) to vibeview.json, or run `vibeview build --platform roku` once to set it up"
+          "no development build profile for roku \u2014 add platforms.roku.build.profiles.development ({ command, artifact }) to vibeview.json, or run `vibeview build --platform roku` once to set it up"
         );
       }
       const started = Date.now();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.49.0",
+  "version": "0.51.0",
   "description": "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku devices: a React Native dev loop, device control for you or your coding agent (CLI or MCP), and tests from CI",
   "mcpName": "io.github.vibeview/vibeview",
   "type": "module",