@akanjs/cli 2.3.6-rc.1 → 2.3.6-rc.3

package/incrementalBuilder.proc.js

@@ -2490,6 +2490,7 @@ var PAGE_ROUTE_EXPORTS = new Set([
 ]);
 var ROOT_LAYOUT_EXPORTS = new Set([
   "default",
+  "pageConfig",
   "head",
   "metadata",
   "generateHead",
@@ -2506,6 +2507,7 @@ var ROOT_LAYOUT_EXPORTS = new Set([
 ]);
 var LAYOUT_ROUTE_EXPORTS = new Set([
   "default",
+  "pageConfig",
   "head",
   "metadata",
   "generateHead",
@@ -5195,6 +5197,7 @@ export async function generateMetadata(props: PageProps) {
 
 export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
 export const Error = userLayout.Error ?? inheritedLayout.Error;
+export const pageConfig = userLayout.pageConfig ?? inheritedLayout.pageConfig;
 
 export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
   return (
@@ -5236,6 +5239,7 @@ export async function generateMetadata(props: PageProps) {
 
 export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;
 export const Error = userLayout.Error ?? inheritedLayout.Error;
+export const pageConfig = userLayout.pageConfig ?? inheritedLayout.pageConfig;
 
 export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
   return <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>;
@@ -9484,7 +9488,9 @@ class Builder {
 }
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp as cp2, mkdir as mkdir11, rm as rm5 } from "fs/promises";
+import os from "os";
 import path38 from "path";
+import { select as select2 } from "@inquirer/prompts";
 import { MobileProject } from "@trapezedev/project";
 import { capitalize as capitalize4 } from "akanjs/common";
 
@@ -9663,6 +9669,407 @@ var resolveMobilePath = (target, pathname) => {
 };
 var targetHtmlFilename = (target) => target.basePath?.replace(/^\/+|\/+$/g, "") ? `${target.basePath.replace(/^\/+|\/+$/g, "")}.html` : "index.html";
 // pkgs/@akanjs/devkit/capacitorApp.ts
+var iosNativeBlockedEnvKeys = new Set([
+  "AR",
+  "AS",
+  "CC",
+  "CFLAGS",
+  "CONDA_BUILD_SYSROOT",
+  "CONDA_PREFIX",
+  "CPP",
+  "CPPFLAGS",
+  "CPATH",
+  "CXX",
+  "CXXFLAGS",
+  "LD",
+  "LDFLAGS",
+  "LIBRARY_PATH",
+  "MACOSX_DEPLOYMENT_TARGET",
+  "NM",
+  "OBJC",
+  "OBJCXX",
+  "PREFIX",
+  "RANLIB",
+  "SDKROOT",
+  "STRIP"
+]);
+var rootCapacitorConfigFilenames = [
+  "capacitor.config.ts",
+  "capacitor.config.js",
+  "capacitor.config.json"
+];
+var rootCapacitorConfigPaths = (appRoot) => rootCapacitorConfigFilenames.map((file) => path38.join(appRoot, file));
+async function clearRootCapacitorConfigs(appRoot) {
+  await Promise.all(rootCapacitorConfigPaths(appRoot).map((file) => rm5(file, { force: true })));
+}
+async function writeRootCapacitorConfig(appRoot, content) {
+  await clearRootCapacitorConfigs(appRoot);
+  await Bun.write(path38.join(appRoot, "capacitor.config.json"), content);
+}
+var getLocalIP = () => {
+  const interfaces = os.networkInterfaces();
+  for (const iface of Object.values(interfaces)) {
+    if (!iface)
+      continue;
+    for (const alias of iface) {
+      if (alias.family === "IPv4" && !alias.internal)
+        return alias.address;
+    }
+  }
+  return "127.0.0.1";
+};
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var asString = (value) => typeof value === "string" ? value : undefined;
+var firstString = (...values) => values.find((value) => typeof value === "string");
+var scoreIosDeviceTarget = (target) => {
+  const state = target.state?.toLowerCase() ?? "";
+  return (state.includes("available") ? 4 : 0) + (state.includes("wired") ? 2 : 0) + (state.includes("paired") ? 1 : 0);
+};
+var dedupeIosRunTargets = (targets) => {
+  const byKey = new Map;
+  const runnableTargets = targets.filter((target) => !target.state?.toLowerCase().includes("unavailable"));
+  for (const target of runnableTargets) {
+    const key = target.xcodebuildId ?? target.id;
+    const current = byKey.get(key);
+    if (!current || scoreIosDeviceTarget(target) > scoreIosDeviceTarget(current))
+      byKey.set(key, target);
+  }
+  return [...byKey.values()];
+};
+function walkRecords(value, visit) {
+  if (Array.isArray(value)) {
+    for (const item of value)
+      walkRecords(item, visit);
+    return;
+  }
+  if (!isRecord(value))
+    return;
+  visit(value);
+  for (const item of Object.values(value))
+    walkRecords(item, visit);
+}
+function parseDevicectlDevices(output) {
+  try {
+    const json = JSON.parse(output);
+    const targets = new Map;
+    walkRecords(json, (record) => {
+      const deviceProperties = isRecord(record.deviceProperties) ? record.deviceProperties : {};
+      const hardwareProperties = isRecord(record.hardwareProperties) ? record.hardwareProperties : {};
+      const connectionProperties = isRecord(record.connectionProperties) ? record.connectionProperties : {};
+      const devicectlId = firstString(record.identifier, record.deviceIdentifier);
+      const potentialHostnames = Array.isArray(connectionProperties.potentialHostnames) ? connectionProperties.potentialHostnames.filter((value) => typeof value === "string") : [];
+      const hostnameUdid = potentialHostnames.map((hostname) => hostname.match(/([0-9A-Fa-f]{8}-[0-9A-Fa-f]{16})\.coredevice\.local/)?.[1]).find((value) => Boolean(value));
+      const udid = firstString(hardwareProperties.udid, hostnameUdid, record.udid, record.UDID);
+      const id = udid ?? devicectlId;
+      const name = firstString(deviceProperties.name, record.name, record.deviceName, record.displayName);
+      if (!id || !name)
+        return;
+      const state = [
+        firstString(record.state, record.connectionState, record.availability, connectionProperties.tunnelState),
+        firstString(connectionProperties.transportType),
+        firstString(connectionProperties.pairingState)
+      ].filter(Boolean).join(" ");
+      targets.set(id, { id, name, kind: "device", state, devicectlId, xcodebuildId: udid ?? id });
+    });
+    return dedupeIosRunTargets([...targets.values()]);
+  } catch {
+    const targets = [];
+    for (const line of output.split(/\r?\n/)) {
+      const id = line.match(/[0-9A-Fa-f]{8}-[0-9A-Fa-f]{16}|[0-9A-Fa-f-]{25,}/)?.[0];
+      if (!id)
+        continue;
+      const name = line.replace(id, "").replace(/[()]/g, " ").trim().replace(/\s+/g, " ") || id;
+      targets.push({ id, name, kind: "device" });
+    }
+    return dedupeIosRunTargets(targets);
+  }
+}
+function parseSimctlDevices(output) {
+  try {
+    const json = JSON.parse(output);
+    const devices = json.devices ?? {};
+    return Object.values(devices).flatMap((runtimeDevices) => runtimeDevices).filter(isRecord).flatMap((device) => {
+      const id = firstString(device.udid, device.UDID, device.identifier);
+      const name = firstString(device.name, device.displayName);
+      const isAvailable = device.isAvailable !== false && device.availabilityError === undefined;
+      if (!id || !name || !isAvailable)
+        return [];
+      return [{ id, name, kind: "simulator", state: asString(device.state) }];
+    });
+  } catch {
+    const targets = [];
+    for (const line of output.split(/\r?\n/)) {
+      const match = line.match(/^\s*(.+?)\s+\(([0-9A-Fa-f-]{20,})\)\s+\(([^)]+)\)/);
+      if (!match)
+        continue;
+      targets.push({ id: match[2], name: match[1].trim(), kind: "simulator", state: match[3] });
+    }
+    return targets;
+  }
+}
+function buildIosNativeRunCommand({
+  appRoot,
+  device,
+  scheme = "App",
+  configuration = "Debug"
+}) {
+  const derivedDataPath = path38.join(appRoot, "ios/DerivedData", device.id);
+  const productPlatform = device.kind === "device" ? "iphoneos" : "iphonesimulator";
+  const destination = device.kind === "device" ? `id=${device.xcodebuildId ?? device.id}` : `platform=iOS Simulator,id=${device.id}`;
+  return {
+    configuration,
+    derivedDataPath,
+    appPath: path38.join(derivedDataPath, "Build/Products", `${configuration}-${productPlatform}`, "App.app"),
+    xcodebuildArgs: [
+      "-project",
+      "App.xcodeproj",
+      "-scheme",
+      scheme,
+      "-configuration",
+      configuration,
+      "-destination",
+      destination,
+      "-derivedDataPath",
+      derivedDataPath,
+      "build"
+    ]
+  };
+}
+function classifyIosRunFailure(log) {
+  const lower = log.toLowerCase();
+  if (lower.includes("unknown argument: '-index-store-path'") || lower.includes("compiler was not recognized")) {
+    return {
+      kind: "compiler-toolchain",
+      title: "iOS build is using a non-Xcode compiler from the shell environment.",
+      detail: "Akan removes common Conda/compiler environment variables for native iOS runs. If this persists, run outside the activated toolchain environment."
+    };
+  }
+  if (lower.includes("developer mode") && lower.includes("disabled")) {
+    return {
+      kind: "device-state",
+      title: "iOS device Developer Mode is disabled.",
+      detail: "Enable Developer Mode on the iPhone, then reconnect and run the command again."
+    };
+  }
+  if (lower.includes("untrusted") || lower.includes("not paired") || lower.includes("locked")) {
+    return {
+      kind: "device-state",
+      title: "iOS device is not ready for installation.",
+      detail: "Unlock the iPhone, trust this computer, and make sure the device is paired before retrying."
+    };
+  }
+  if (lower.includes('unable to find utility "devicectl"') || lower.includes("devicectl") && lower.includes("not found")) {
+    return {
+      kind: "devicectl-unavailable",
+      title: "Xcode devicectl is not available.",
+      detail: "Install a recent Xcode version and verify xcode-select points to that Xcode installation."
+    };
+  }
+  if (lower.includes("there are no accounts registered with xcode") || lower.includes("unable to log in with account")) {
+    return {
+      kind: "apple-account",
+      title: "Xcode Apple ID is not available.",
+      detail: "Sign in to an Apple ID in Xcode Settings > Accounts, then retry the Akan iOS command."
+    };
+  }
+  if (lower.includes("failed registering bundle identifier") || lower.includes("cannot be registered to your development team")) {
+    return {
+      kind: "bundle-identifier",
+      title: "iOS bundle identifier is not available for this Apple Developer Team.",
+      detail: "Change mobile appId to a globally unique bundle identifier that your team can register, then rerun the iOS command."
+    };
+  }
+  if (lower.includes("does not have permission") || lower.includes("your account") && lower.includes("permission")) {
+    return {
+      kind: "team-permission",
+      title: "Apple Developer Team permission is missing.",
+      detail: "Check that the signed-in Apple ID has permission for the selected DEVELOPMENT_TEAM."
+    };
+  }
+  if (lower.includes("license agreement") || lower.includes("program license agreement")) {
+    return {
+      kind: "license-agreement",
+      title: "Apple Developer Program license agreement is not accepted.",
+      detail: "Accept the latest Apple Developer Program license agreement, then retry."
+    };
+  }
+  if (lower.includes("no signing certificate") || lower.includes("doesn't include signing certificate")) {
+    return {
+      kind: "certificate",
+      title: "iOS development signing certificate is missing.",
+      detail: "Create or download an Apple Development certificate for the selected team."
+    };
+  }
+  if (lower.includes("device") && lower.includes("not") && lower.includes("registered")) {
+    return {
+      kind: "device-registration",
+      title: "iPhone is not registered in the provisioning profile.",
+      detail: "Allow provisioning updates with a team that can register this device, or register the device manually."
+    };
+  }
+  if (lower.includes("no profiles for") || lower.includes("requires a provisioning profile")) {
+    return {
+      kind: "provisioning-profile",
+      title: "Matching iOS provisioning profile was not found.",
+      detail: "Akan can request Xcode provisioning updates for physical devices, but the Apple account and team must be valid."
+    };
+  }
+  return {
+    kind: "unknown",
+    title: "iOS native run failed.",
+    detail: "Review the xcodebuild/devicectl output above. You can retry with --noAllowProvisioningUpdates to use the conservative path."
+  };
+}
+function formatIosRunFailureMessage(input2) {
+  return [
+    input2.classification.title,
+    input2.classification.detail,
+    `Mobile target: ${input2.targetName}`,
+    `Bundle ID: ${input2.appId}`,
+    input2.teamId ? `Development Team: ${input2.teamId}` : null,
+    "Capacitor is still used for native project generation and sync; Akan only runs the native build/install step directly."
+  ].filter((line) => Boolean(line)).join(`
+`);
+}
+function sanitizeIosNativeRunEnv(env) {
+  return Object.fromEntries(Object.entries(env).filter(([key]) => !iosNativeBlockedEnvKeys.has(key)));
+}
+var androidReleaseSigningKeys = [
+  "MYAPP_RELEASE_STORE_FILE",
+  "MYAPP_RELEASE_STORE_PASSWORD",
+  "MYAPP_RELEASE_KEY_ALIAS",
+  "MYAPP_RELEASE_KEY_PASSWORD"
+];
+function getMissingAndroidReleaseSigningKeys({
+  env = process.env,
+  gradleProperties = ""
+} = {}) {
+  return androidReleaseSigningKeys.filter((key) => {
+    const gradleEnvKey = `ORG_GRADLE_PROJECT_${key}`;
+    return env[key] === undefined && env[gradleEnvKey] === undefined && !new RegExp(`^\\s*${key}\\s*=`, "m").test(gradleProperties);
+  });
+}
+function formatAndroidReleaseSigningError(missingKeys) {
+  return [
+    "Android release signing configuration is incomplete.",
+    `Missing: ${missingKeys.join(", ")}`,
+    "Set these values in android/gradle.properties or ORG_GRADLE_PROJECT_* environment variables before building a release artifact."
+  ].join(`
+`);
+}
+function getAdbDeviceStateIssues(output) {
+  return output.split(/\r?\n/).map((line) => line.trim().split(/\s+/)).filter(([id, state]) => id && state && id !== "List").flatMap(([id, state]) => {
+    if (state === "unauthorized")
+      return [`Android device ${id} is unauthorized. Confirm USB debugging authorization on the device.`];
+    if (state === "offline")
+      return [`Android device ${id} is offline. Reconnect the device or restart adb.`];
+    return [];
+  });
+}
+var mergeAllowNavigation = (configured, localIp) => {
+  const values = Array.isArray(configured) ? configured.filter((value) => typeof value === "string") : [];
+  if (localIp)
+    values.push(localIp);
+  values.push("localhost");
+  return [...new Set(values)];
+};
+function assertJsonSerializable(value, label = "capacitor.config", seen = new WeakSet) {
+  if (value === null)
+    return;
+  const valueType = typeof value;
+  if (valueType === "function" || valueType === "symbol" || valueType === "bigint" || valueType === "undefined") {
+    throw new Error(`${label} must be JSON serializable. Found ${valueType}.`);
+  }
+  if (valueType === "number" && !Number.isFinite(value)) {
+    throw new Error(`${label} must be JSON serializable. Found non-finite number.`);
+  }
+  if (valueType !== "object")
+    return;
+  const objectValue = value;
+  if (seen.has(objectValue))
+    throw new Error(`${label} must be JSON serializable. Found circular reference.`);
+  seen.add(objectValue);
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => {
+      assertJsonSerializable(item, `${label}[${index}]`, seen);
+    });
+    return;
+  }
+  for (const [key, item] of Object.entries(value)) {
+    assertJsonSerializable(item, `${label}.${key}`, seen);
+  }
+}
+function materializeCapacitorConfig(target, { operation, localServerUrl, localIp }) {
+  const {
+    name,
+    basePath: _basePath,
+    version: _version,
+    buildNum: _buildNum,
+    assets: _assets,
+    permissions: _permissions,
+    links: _links,
+    files: _files,
+    appId,
+    appName,
+    webDir: _webDir,
+    plugins,
+    server,
+    android,
+    ios,
+    cordova,
+    experimental,
+    ...capacitorConfig
+  } = target;
+  const serverConfig = isRecord(server) ? server : undefined;
+  const cordovaConfig = isRecord(cordova) ? cordova : undefined;
+  const experimentalConfig = isRecord(experimental) ? experimental : undefined;
+  const pluginsConfig = isRecord(plugins) ? plugins : {};
+  const keyboardPluginConfig = isRecord(pluginsConfig.Keyboard) ? pluginsConfig.Keyboard : {};
+  const config = {
+    ...capacitorConfig,
+    appId,
+    appName,
+    webDir: path38.posix.join(".akan", "mobile", name, "www"),
+    plugins: {
+      CapacitorCookies: { enabled: true },
+      ...pluginsConfig,
+      Keyboard: {
+        resize: "none",
+        ...keyboardPluginConfig
+      }
+    },
+    android: {
+      ...isRecord(android) ? android : {},
+      path: "android"
+    },
+    ios: {
+      ...isRecord(ios) ? ios : {},
+      path: "ios"
+    }
+  };
+  if (operation === "local") {
+    if (!localServerUrl)
+      throw new Error(`Local server URL is required for mobile target '${name}'.`);
+    config.server = {
+      ...serverConfig,
+      androidScheme: "http",
+      url: localServerUrl,
+      cleartext: true,
+      allowNavigation: mergeAllowNavigation(serverConfig?.allowNavigation, localIp)
+    };
+  } else if (serverConfig && Object.keys(serverConfig).length > 0) {
+    config.server = serverConfig;
+  }
+  if (cordovaConfig && Object.keys(cordovaConfig).length > 0) {
+    config.cordova = cordovaConfig;
+  }
+  if (experimentalConfig && Object.keys(experimentalConfig).length > 0) {
+    config.experimental = experimentalConfig;
+  }
+  assertJsonSerializable(config);
+  return config;
+}
+
 class CapacitorApp {
   app;
   target;
@@ -9695,7 +10102,6 @@ class CapacitorApp {
     regenerate = false
   } = {}) {
     await mkdir11(this.targetRoot, { recursive: true });
-    await this.#writeCapacitorConfig();
     if (regenerate) {
       if (!platform || platform === "ios")
         await rm5(path38.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
@@ -9743,12 +10149,122 @@ class CapacitorApp {
   async openIos() {
     await this.#spawnMobile("npx", ["cap", "open", "ios"], { operation: "local", env: "local" });
   }
-  async runIos({ operation, env, regenerate = false }) {
+  async runIos({ operation, env, regenerate = false, noAllowProvisioningUpdates = false, iosDeviceId }) {
     if (operation === "release")
       await this.prepareWww();
     await this.#prepareIos({ operation, env, regenerate });
-    const args = ["cap", "run", "ios"];
-    await this.#spawnMobile("npx", args, { operation, env }, { stdio: "inherit" });
+    const runTarget = await this.#selectIosRunTarget(iosDeviceId);
+    if (runTarget.kind === "simulator") {
+      await this.#spawnMobile("npx", ["cap", "run", "ios", "--target", runTarget.id], { operation, env }, { stdio: "inherit" });
+      return;
+    }
+    await this.#runIosPhysicalDevice({ operation, env, runTarget, noAllowProvisioningUpdates });
+  }
+  async#selectIosRunTarget(deviceId) {
+    const targets = await this.#loadIosRunTargets();
+    if (deviceId) {
+      const found = targets.find((target) => target.id === deviceId);
+      if (!found)
+        throw new Error(`iOS run target '${deviceId}' was not found.`);
+      return found;
+    }
+    if (targets.length === 0) {
+      throw new Error("No iOS run targets found. Open Simulator or connect an iPhone, then retry.");
+    }
+    return await select2({
+      message: "Select iOS run target",
+      choices: targets.map((target) => ({
+        name: `[${target.kind}] ${target.name}${target.state ? ` (${target.state})` : ""}`,
+        value: target
+      }))
+    });
+  }
+  async#loadIosRunTargets() {
+    const devices = await this.#loadPhysicalIosDevices();
+    const simulators = await this.#loadIosSimulators();
+    return [...devices, ...simulators];
+  }
+  async#loadPhysicalIosDevices() {
+    try {
+      return parseDevicectlDevices(await this.#spawn("xcrun", ["devicectl", "list", "devices", "--json-output", "-"]));
+    } catch (jsonError) {
+      try {
+        return parseDevicectlDevices(await this.#spawn("xcrun", ["devicectl", "list", "devices"]));
+      } catch (textError) {
+        const classification = classifyIosRunFailure(`${jsonError instanceof Error ? jsonError.message : ""}
+${textError instanceof Error ? textError.message : ""}`);
+        if (classification.kind === "devicectl-unavailable")
+          this.app.logger.warn(classification.detail);
+        return [];
+      }
+    }
+  }
+  async#loadIosSimulators() {
+    try {
+      return parseSimctlDevices(await this.#spawn("xcrun", ["simctl", "list", "devices", "available", "--json"]));
+    } catch {
+      try {
+        return parseSimctlDevices(await this.#spawn("xcrun", ["simctl", "list", "devices", "available"]));
+      } catch {
+        return [];
+      }
+    }
+  }
+  async#runIosPhysicalDevice({
+    operation,
+    env,
+    runTarget,
+    noAllowProvisioningUpdates
+  }) {
+    const mobileEnv = sanitizeIosNativeRunEnv(await this.#commandEnv(operation, env));
+    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    await this.#writeRootCapacitorConfig(configContent);
+    const scheme = this.#iosScheme();
+    const command = buildIosNativeRunCommand({
+      appRoot: this.app.cwdPath,
+      device: runTarget,
+      scheme,
+      configuration: operation === "release" ? "Release" : "Debug"
+    });
+    const xcodebuildArgs = noAllowProvisioningUpdates ? command.xcodebuildArgs : [...command.xcodebuildArgs.slice(0, -1), "-allowProvisioningUpdates", ...command.xcodebuildArgs.slice(-1)];
+    try {
+      await this.#spawn("xcodebuild", xcodebuildArgs, {
+        cwd: path38.join(this.app.cwdPath, this.iosProjectPath),
+        env: mobileEnv
+      });
+      const devicectlId = runTarget.devicectlId ?? runTarget.id;
+      await this.#spawn("xcrun", ["devicectl", "device", "install", "app", "--device", devicectlId, command.appPath], {
+        env: mobileEnv
+      });
+      await this.#spawn("xcrun", ["devicectl", "device", "process", "launch", "--device", devicectlId, this.target.appId], {
+        env: mobileEnv
+      });
+    } catch (error) {
+      throw new Error(formatIosRunFailureMessage({
+        classification: classifyIosRunFailure(this.#errorOutput(error)),
+        appId: this.target.appId,
+        targetName: this.target.name,
+        teamId: await this.#getIosDevelopmentTeam()
+      }));
+    } finally {
+      await this.#clearRootCapacitorConfigs();
+    }
+  }
+  #iosScheme() {
+    return isRecord(this.target.ios) && typeof this.target.ios.scheme === "string" ? this.target.ios.scheme : "App";
+  }
+  async#getIosDevelopmentTeam() {
+    const pbxprojPath = path38.join(this.app.cwdPath, this.iosProjectPath, "App.xcodeproj/project.pbxproj");
+    if (!await Bun.file(pbxprojPath).exists())
+      return;
+    return (await Bun.file(pbxprojPath).text()).match(/DEVELOPMENT_TEAM = ([^;]+);/)?.[1]?.trim();
+  }
+  #errorOutput(error) {
+    if (error instanceof CommandExecutionError)
+      return `${error.stdout}
+${error.stderr}
+${error.message}`;
+    return error instanceof Error ? error.message : String(error);
   }
   async#prepareAndroid({ operation, env, regenerate = false }) {
     await this.init({ platform: "android", operation, env, regenerate });
@@ -9802,6 +10318,7 @@ class CapacitorApp {
   async buildAndroid(assembleType, { env = "debug", regenerate = false } = {}) {
     await this.prepareWww();
     await this.#prepareAndroid({ operation: "release", env, regenerate });
+    await this.#assertAndroidReleaseSigningConfig();
     await this.#updateAndroidBuildTypes();
     const isWindows = process.platform === "win32";
     const gradleCommand = isWindows ? "gradlew.bat" : "./gradlew";
@@ -9851,10 +10368,30 @@ class CapacitorApp {
     if (operation === "release")
       await this.prepareWww();
     await this.#prepareAndroid({ operation, env, regenerate });
+    await this.#assertAndroidAdbReady();
     this.app.logger.info(`Running Android in ${operation} mode on ${env} env`);
     const args = ["cap", "run", "android"];
     await this.#spawnMobile("npx", args, { operation, env }, { stdio: "inherit" });
   }
+  async#assertAndroidReleaseSigningConfig() {
+    const gradlePropertiesPath = path38.join(this.app.cwdPath, this.androidRootPath, "gradle.properties");
+    const gradleProperties = await Bun.file(gradlePropertiesPath).exists() ? await Bun.file(gradlePropertiesPath).text() : "";
+    const missingKeys = getMissingAndroidReleaseSigningKeys({ gradleProperties });
+    if (missingKeys.length > 0)
+      throw new Error(formatAndroidReleaseSigningError(missingKeys));
+  }
+  async#assertAndroidAdbReady() {
+    try {
+      const issues = getAdbDeviceStateIssues(await this.#spawn("adb", ["devices"]));
+      if (issues.length > 0)
+        throw new Error(issues.join(`
+`));
+    } catch (error) {
+      if (error instanceof CommandExecutionError)
+        return;
+      throw error;
+    }
+  }
   async releaseIos() {
     await this.prepareWww();
     await this.#prepareIos({ operation: "release", env: "main" });
@@ -9879,30 +10416,18 @@ class CapacitorApp {
     return html.replace(/<\/head\s*>/i, `${script}
 </head>`);
   }
-  async#writeCapacitorConfig() {
+  async#writeCapacitorConfig({ operation }, commandEnv) {
     await mkdir11(this.targetRoot, { recursive: true });
-    const appInfoPath = path38.relative(this.app.cwdPath, path38.join(this.app.cwdPath, "akan.app.json")).split(path38.sep).join("/");
-    const content = `import type { AppScanResult } from "akanjs";
-import { withBase } from "${process.env.USE_AKANJS_PKGS === "true" ? "../../pkgs/" : ""}akanjs/capacitor.base.config";
-import appInfo from "${appInfoPath.startsWith(".") ? appInfoPath : `./${appInfoPath}`}";
-
-export default withBase(
-  (config, target) => ({
-    ...config,
-    webDir: \`.akan/mobile/\${target.name}/www\`,
-    android: {
-      ...config.android,
-      path: "android",
-    },
-    ios: {
-      ...config.ios,
-      path: "ios",
-    },
-  }),
-  appInfo as AppScanResult,
-);
+    const localIp = operation === "local" ? getLocalIP() : undefined;
+    const config = materializeCapacitorConfig(this.target, {
+      operation,
+      localIp,
+      localServerUrl: localIp ? this.#localCsrUrl(localIp, commandEnv) : undefined
+    });
+    const content = `${JSON.stringify(config, null, 2)}
 `;
-    await Bun.write(path38.join(this.app.cwdPath, "capacitor.config.ts"), content);
+    await Bun.write(path38.join(this.targetRoot, "capacitor.config.json"), content);
+    return content;
   }
   async#prepareTargetAssets() {
     if (!this.target.assets)
@@ -9999,14 +10524,37 @@ export default withBase(
       ...devPort ? { PORT: devPort, AKAN_PUBLIC_CLIENT_PORT: devPort, AKAN_PUBLIC_SERVER_PORT: devPort } : {}
     });
   }
+  #localCsrUrl(ip, commandEnv) {
+    const basePath2 = this.target.basePath?.replace(/^\/+|\/+$/g, "");
+    const locale = commandEnv.AKAN_PUBLIC_DEFAULT_LOCALE ?? "en";
+    const pathname = basePath2 ? `${locale}/${basePath2}` : `${locale}/`;
+    const port = commandEnv.AKAN_PUBLIC_CLIENT_PORT ?? commandEnv.PORT ?? "8282";
+    const params = new URLSearchParams({ csr: "true", akanMobileTarget: this.target.name });
+    if (basePath2)
+      params.set("akanMobileBasePath", basePath2);
+    return `http://${ip}:${port}/${pathname}?${params}`;
+  }
+  async#clearRootCapacitorConfigs() {
+    await clearRootCapacitorConfigs(this.app.cwdPath);
+  }
+  async#writeRootCapacitorConfig(content) {
+    await writeRootCapacitorConfig(this.app.cwdPath, content);
+  }
   async#spawn(command, args = [], options = {}) {
     return await this.app.spawn(command, args, { cwd: this.app.cwdPath, ...options });
   }
   async#spawnMobile(command, args = [], { operation, env }, options = {}) {
-    return await this.#spawn(command, args, {
-      ...options,
-      env: { ...await this.#commandEnv(operation, env), ...options.env }
-    });
+    const mobileEnv = { ...await this.#commandEnv(operation, env), ...options.env };
+    const configContent = await this.#writeCapacitorConfig({ operation }, mobileEnv);
+    await this.#writeRootCapacitorConfig(configContent);
+    try {
+      return await this.#spawn(command, args, {
+        ...options,
+        env: mobileEnv
+      });
+    } finally {
+      await this.#clearRootCapacitorConfigs();
+    }
   }
   async addCamera() {
     await this.#setPermissionInIos({
@@ -10123,7 +10671,7 @@ var Module = createInternalArgToken("Module");
 var Workspace = createInternalArgToken("Workspace");
 // pkgs/@akanjs/devkit/commandDecorators/command.ts
 import path39 from "path";
-import { confirm, input as input2, select as select2 } from "@inquirer/prompts";
+import { confirm, input as input2, select as select3 } from "@inquirer/prompts";
 import { Logger as Logger10 } from "akanjs/common";
 import chalk6 from "chalk";
 import { program } from "commander";
@@ -10459,7 +11007,7 @@ var getOptionValue = async (argMeta, opt, context) => {
     return defaultValue;
   if (enumChoices) {
     const choices = normalizeEnumChoices(await resolveEnumChoices(argMeta, context) ?? []);
-    const choice = await select2({ message: ask ?? desc ?? `Select the ${name} value`, choices });
+    const choice = await select3({ message: ask ?? desc ?? `Select the ${name} value`, choices });
     return choice;
   } else if (nullable)
     return null;
@@ -10531,7 +11079,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     else if (value && libNames.includes(value))
       return LibExecutor.from(workspace, value);
     else {
-      const sysName = await select2({
+      const sysName = await select3({
         message: `Select the App or Lib name`,
         choices: [...appNames, ...libNames]
       });
@@ -10550,7 +11098,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     else if (value && pkgNames.includes(value))
       return PkgExecutor.from(workspace, value);
     else {
-      const execName = await select2({
+      const execName = await select3({
         message: `Select the App or Lib or Pkg name`,
         choices: [...appNames, ...libNames, ...pkgNames]
       });
@@ -10566,18 +11114,18 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
   } else if (sysType === "app") {
     if (value && appNames.includes(value))
       return AppExecutor.from(workspace, value);
-    const appName = await select2({ message: `Select the ${sysType} name`, choices: appNames });
+    const appName = await select3({ message: `Select the ${sysType} name`, choices: appNames });
     return AppExecutor.from(workspace, appName);
   } else if (sysType === "lib") {
     if (value && libNames.includes(value))
       return LibExecutor.from(workspace, value);
-    const libName = await select2({ message: `Select the ${sysType} name`, choices: libNames });
+    const libName = await select3({ message: `Select the ${sysType} name`, choices: libNames });
     return LibExecutor.from(workspace, libName);
   } else if (sysType === "pkg") {
     const pkgs = await workspace.getPkgs();
     if (value && pkgs.includes(value))
       return PkgExecutor.from(workspace, value);
-    const pkgName = await select2({ message: `Select the ${sysType} name`, choices: pkgs });
+    const pkgName = await select3({ message: `Select the ${sysType} name`, choices: pkgs });
     return PkgExecutor.from(workspace, pkgName);
   } else if (sysType === "module") {
     if (value) {
@@ -10599,7 +11147,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
       } else
         throw new Error(`Invalid system name: ${sysName}`);
     }
-    const { type, name } = await select2({
+    const { type, name } = await select3({
       message: `select the App or Lib name`,
       choices: [
         ...appNames.map((name2) => ({ name: name2, value: { type: "app", name: name2 } })),
@@ -10608,7 +11156,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     });
     const executor = type === "app" ? AppExecutor.from(workspace, name) : LibExecutor.from(workspace, name);
     const modules = await executor.getModules();
-    const moduleName = await select2({
+    const moduleName = await select3({
       message: `Select the module name`,
       choices: modules.map((name2) => ({ name: `${executor.name}:${name2}`, value: name2 }))
     });
@@ -11046,7 +11594,7 @@ var getRelatedCnsts = (constantFilePath) => {
 };
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";
-import { input as input3, select as select3 } from "@inquirer/prompts";
+import { input as input3, select as select4 } from "@inquirer/prompts";
 class Prompter {
   static async#getGuidelineRoot() {
     const dirname2 = getDirname(import.meta.url);
@@ -11062,7 +11610,7 @@ class Prompter {
   static async selectGuideline() {
     const guidelineRoot = await Prompter.#getGuidelineRoot();
     const guideNames = await Prompter.listGuidelines();
-    return await select3({
+    return await select4({
       message: "Select a guideline",
       choices: guideNames.map((name) => ({ name, value: name }))
     });
@@ -11118,7 +11666,7 @@ ${document}
   }
 }
 // pkgs/@akanjs/devkit/selectModel.ts
-import { select as select4 } from "@inquirer/prompts";
+import { select as select5 } from "@inquirer/prompts";
 // pkgs/@akanjs/devkit/streamAi.ts
 import { PromptTemplate } from "@langchain/core/prompts";
 import { RunnableSequence } from "@langchain/core/runnables";