@tamagui/native-ci 2.0.0-rc.9 → 2.1.0

package/dist/metro.mjs

@@ -9,15 +9,20 @@ async function waitForMetro(options) {
   console.info("Waiting for Metro to start...");
   for (let i = 1; i <= maxAttempts; i++) {
     try {
-      if ((await fetch(`${METRO_URL}/`, {
+      const response = await fetch(`${METRO_URL}/`, {
         headers: {
           "Expo-Platform": platform
         }
-      })).ok) return console.info("Metro is responding!"), !0;
+      });
+      if (response.ok) {
+        console.info("Metro is responding!");
+        return true;
+      }
     } catch {}
-    console.info(`Waiting for Metro... (${i}/${maxAttempts})`), await Bun.sleep(intervalMs);
+    console.info(`Waiting for Metro... (${i}/${maxAttempts})`);
+    await Bun.sleep(intervalMs);
   }
-  return !1;
+  return false;
 }
 async function prewarmBundle(platform) {
   console.info("Pre-warming bundle...");
@@ -28,19 +33,47 @@ async function prewarmBundle(platform) {
       }
     });
     if (response.ok) {
-      const bundleUrl = (await response.json())?.launchAsset?.url;
-      bundleUrl ? (console.info(`Fetching bundle from: ${bundleUrl}`), await fetch(bundleUrl), console.info("Bundle pre-warmed!")) : console.info("No bundle URL found in manifest, skipping pre-warm");
+      const manifest = await response.json();
+      const bundleUrl = manifest?.launchAsset?.url;
+      if (bundleUrl) {
+        console.info(`Fetching bundle from: ${bundleUrl}`);
+        await fetch(bundleUrl);
+        console.info("Bundle pre-warmed!");
+      } else {
+        console.info("No bundle URL found in manifest, skipping pre-warm");
+      }
     }
-  } catch {
+  } catch (error) {
     console.info("Bundle pre-warm completed (with error, continuing)");
   }
 }
+function projectUsesDevClient() {
+  try {
+    const pkg = JSON.parse(require("fs").readFileSync("package.json", "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    if (deps["expo-dev-client"]) return true;
+    if (typeof pkg.scripts?.start === "string" && pkg.scripts.start.includes("--dev-client")) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
 function startMetro() {
-  console.info(`
---- Starting Metro bundler ---`);
-  const isCI = !!process.env.CI,
-    args = ["bun", "expo", "start", "--dev-client", "--offline"];
-  isCI && (args.push("--clear"), console.info("CI detected: clearing Metro cache"));
+  console.info("\n--- Starting Metro bundler ---");
+  const isCI = !!process.env.CI;
+  const useDevClient = projectUsesDevClient();
+  const args = ["bun", "expo", "start", "--offline"];
+  if (useDevClient) {
+    args.splice(3, 0, "--dev-client");
+    console.info("Dev client detected");
+  }
+  if (isCI) {
+    args.push("--clear");
+    console.info("CI detected: clearing Metro cache");
+  }
   const proc = Bun.spawn(args, {
     env: {
       ...process.env,
@@ -53,32 +86,39 @@ function startMetro() {
     proc,
     kill: async () => {
       const pid = proc.pid;
-      if (pid) try {
-        await Bun.spawn(["pkill", "-P", String(pid)], {
-          stdout: "ignore",
-          stderr: "ignore"
-        }).exited;
-      } catch {}
-      proc.kill("SIGKILL"), console.info("Metro stopped");
+      if (pid) {
+        try {
+          await Bun.spawn(["pkill", "-P", String(pid)], {
+            stdout: "ignore",
+            stderr: "ignore"
+          }).exited;
+        } catch {}
+      }
+      proc.kill("SIGKILL");
+      console.info("Metro stopped");
     }
   };
 }
 function setupSignalHandlers(metro) {
   const cleanup = async signal => {
     console.info(`
-Received ${signal}, cleaning up...`), await metro.kill(), process.exit(signal === "SIGINT" ? 130 : 143);
+Received ${signal}, cleaning up...`);
+    await metro.kill();
+    process.exit(signal === "SIGINT" ? 130 : 143);
   };
-  process.on("SIGINT", () => cleanup("SIGINT")), process.on("SIGTERM", () => cleanup("SIGTERM"));
+  process.on("SIGINT", () => cleanup("SIGINT"));
+  process.on("SIGTERM", () => cleanup("SIGTERM"));
 }
 async function isMetroRunning(platform) {
   try {
-    return (await fetch(`${METRO_URL}/`, {
+    const response = await fetch(`${METRO_URL}/`, {
       headers: {
         "Expo-Platform": platform
       }
-    })).ok;
+    });
+    return response.ok;
   } catch {
-    return !1;
+    return false;
   }
 }
 function killPortProcess() {
@@ -86,20 +126,31 @@ function killPortProcess() {
     const pid = execSync(`lsof -ti tcp:${METRO_PORT} -sTCP:LISTEN`, {
       encoding: "utf-8"
     }).trim();
-    pid && (console.info(`Killing process ${pid} on port ${METRO_PORT}...`), process.kill(Number(pid), "SIGTERM"));
+    if (pid) {
+      console.info(`Killing process ${pid} on port ${METRO_PORT}...`);
+      process.kill(Number(pid), "SIGTERM");
+    }
   } catch {}
 }
 async function withMetro(platform, fn) {
-  if (await isMetroRunning(platform)) return console.info(`
---- Metro already running, reusing existing instance ---`), await prewarmBundle(platform), await fn();
+  const alreadyRunning = await isMetroRunning(platform);
+  if (alreadyRunning) {
+    console.info("\n--- Metro already running, reusing existing instance ---");
+    await prewarmBundle(platform);
+    return await fn();
+  }
   killPortProcess();
   const metro = startMetro();
   setupSignalHandlers(metro);
   try {
-    if (!(await waitForMetro({
+    const metroReady = await waitForMetro({
       platform
-    }))) throw new Error("Metro failed to start within timeout");
-    return await prewarmBundle(platform), await fn();
+    });
+    if (!metroReady) {
+      throw new Error("Metro failed to start within timeout");
+    }
+    await prewarmBundle(platform);
+    return await fn();
   } finally {
     await metro.kill();
   }

package/dist/metro.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["execSync","METRO_URL","METRO_PORT","DEFAULT_METRO_WAIT_ATTEMPTS","DEFAULT_METRO_WAIT_INTERVAL_MS","waitForMetro","options","platform","maxAttempts","intervalMs","console","info","i","fetch","headers","ok","Bun","sleep","prewarmBundle","response","bundleUrl","json","launchAsset","url","startMetro","isCI","process","env","CI","args","push","proc","spawn","EXPO_NO_TELEMETRY","stdout","stderr","kill","pid","String","exited","setupSignalHandlers","metro","cleanup","signal","exit","on","isMetroRunning","killPortProcess","encoding","trim","Number","withMetro","fn","Error"],"sources":["../src/metro.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["execSync","METRO_URL","METRO_PORT","DEFAULT_METRO_WAIT_ATTEMPTS","DEFAULT_METRO_WAIT_INTERVAL_MS","waitForMetro","options","platform","maxAttempts","intervalMs","console","info","i","response","fetch","headers","ok","Bun","sleep","prewarmBundle","manifest","json","bundleUrl","launchAsset","url","error","projectUsesDevClient","pkg","JSON","parse","require","readFileSync","deps","dependencies","devDependencies","scripts","start","includes","startMetro","isCI","process","env","CI","useDevClient","args","splice","push","proc","spawn","EXPO_NO_TELEMETRY","stdout","stderr","kill","pid","String","exited","setupSignalHandlers","metro","cleanup","signal","exit","on","isMetroRunning","killPortProcess","encoding","trim","Number","withMetro","fn","alreadyRunning","metroReady","Error"],"sources":["../src/metro.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/runner.mjs

@@ -4,14 +4,14 @@ import { createCacheKey, loadCache, saveCache } from "./cache.mjs";
 import { generateFingerprint } from "./fingerprint.mjs";
 async function runWithCache(options) {
   const {
-      platform,
-      buildCommand,
-      outputPaths,
-      projectRoot = process.cwd(),
-      cachePrefix = "native-build",
-      debug = !1
-    } = options,
-    log = debug ? console.log : () => {};
+    platform,
+    buildCommand,
+    outputPaths,
+    projectRoot = process.cwd(),
+    cachePrefix = "native-build",
+    debug = false
+  } = options;
+  const log = debug ? console.log : () => {};
   log(`Generating ${platform} fingerprint...`);
   const {
     hash: fingerprint
@@ -28,12 +28,15 @@ async function runWithCache(options) {
   });
   log(`Cache key: ${cacheKey}`);
   const cached = loadCache(cacheKey);
-  if (cached && cached.fingerprint === fingerprint) return log("Cache hit! Skipping build."), {
-    cacheHit: !0,
-    fingerprint,
-    cacheKey,
-    outputPaths
-  };
+  if (cached && cached.fingerprint === fingerprint) {
+    log("Cache hit! Skipping build.");
+    return {
+      cacheHit: true,
+      fingerprint,
+      cacheKey,
+      outputPaths
+    };
+  }
   log(`Running build: ${buildCommand}`);
   const execOptions = {
     cwd: projectRoot,
@@ -46,13 +49,14 @@ async function runWithCache(options) {
     throw new Error(`Build failed: ${err.message}${err.stderr ? `
 ${err.stderr}` : ""}`);
   }
-  return saveCache(cacheKey, {
+  saveCache(cacheKey, {
     fingerprint,
     timestamp: (/* @__PURE__ */new Date()).toISOString(),
     platform,
     outputPaths
-  }), {
-    cacheHit: !1,
+  });
+  return {
+    cacheHit: false,
     fingerprint,
     cacheKey,
     outputPaths
@@ -60,8 +64,12 @@ ${err.stderr}` : ""}`);
 }
 function setGitHubOutput(name, value) {
   const outputFile = process.env.GITHUB_OUTPUT;
-  outputFile ? appendFileSync(outputFile, `${name}=${value}
-`) : console.info(`[GitHub Output] ${name}=${value}`);
+  if (outputFile) {
+    appendFileSync(outputFile, `${name}=${value}
+`);
+  } else {
+    console.info(`[GitHub Output] ${name}=${value}`);
+  }
 }
 function isGitHubActions() {
   return !!process.env.GITHUB_ACTIONS;

package/dist/runner.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["execSync","appendFileSync","createCacheKey","loadCache","saveCache","generateFingerprint","runWithCache","options","platform","buildCommand","outputPaths","projectRoot","process","cwd","cachePrefix","debug","log","console","hash","fingerprint","cacheKey","prefix","cached","cacheHit","execOptions","stdio","error","err","Error","message","stderr","timestamp","Date","toISOString","setGitHubOutput","name","value","outputFile","env","GITHUB_OUTPUT","info","isGitHubActions","GITHUB_ACTIONS","isCI","CI"],"sources":["../src/runner.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAsC;AAC/C,SAASC,cAAA,QAAsB;AAC/B,SAASC,cAAA,EAAgBC,SAAA,EAAWC,SAAA,QAAiB;AACrD,SAASC,mBAAA,QAA2B;AAwBpC,eAAsBC,aACpBC,OAAA,EAC6B;EAC7B,MAAM;MACJC,QAAA;MACAC,YAAA;MACAC,WAAA;MACAC,WAAA,GAAcC,OAAA,CAAQC,GAAA,CAAI;MAC1BC,WAAA,GAAc;MACdC,KAAA,GAAQ;IACV,IAAIR,OAAA;IAEES,GAAA,GAAMD,KAAA,GAAQE,OAAA,CAAQD,GAAA,GAAM,MAAM,CAAC;EAGzCA,GAAA,CAAI,cAAcR,QAAQ,iBAAiB;EAC3C,MAAM;IAAEU,IAAA,EAAMC;EAAY,IAAI,MAAMd,mBAAA,CAAoB;IACtDG,QAAA;IACAG,WAAA;IACAI;EACF,CAAC;EACDC,GAAA,CAAI,gBAAgBG,WAAW,EAAE;EAGjC,MAAMC,QAAA,GAAWlB,cAAA,CAAe;IAAEM,QAAA;IAAUW,WAAA;IAAaE,MAAA,EAAQP;EAAY,CAAC;EAC9EE,GAAA,CAAI,cAAcI,QAAQ,EAAE;EAE5B,MAAME,MAAA,GAASnB,SAAA,CAAsDiB,QAAQ;EAE7E,IAAIE,MAAA,IAAUA,MAAA,CAAOH,WAAA,KAAgBA,WAAA,EACnC,OAAAH,GAAA,CAAI,4BAA4B,GACzB;IACLO,QAAA,EAAU;IACVJ,WAAA;IACAC,QAAA;IACAV;EACF;EAIFM,GAAA,CAAI,kBAAkBP,YAAY,EAAE;EACpC,MAAMe,WAAA,GAA+B;IACnCX,GAAA,EAAKF,WAAA;IACLc,KAAA,EAAOV,KAAA,GAAQ,YAAY,CAAC,QAAQ,QAAQ,MAAM;EACpD;EAEA,IAAI;IACFf,QAAA,CAASS,YAAA,EAAce,WAAW;EACpC,SAASE,KAAA,EAAO;IACd,MAAMC,GAAA,GAAMD,KAAA;IACZ,MAAM,IAAIE,KAAA,CAAM,iBAAiBD,GAAA,CAAIE,OAAO,GAAGF,GAAA,CAAIG,MAAA,GAAS;AAAA,EAAKH,GAAA,CAAIG,MAAM,KAAK,EAAE,EAAE;EACtF;EAGA,OAAA1B,SAAA,CAAUgB,QAAA,EAAU;IAClBD,WAAA;IACAY,SAAA,GAAW,mBAAIC,IAAA,CAAK,GAAEC,WAAA,CAAY;IAClCzB,QAAA;IACAE;EACF,CAAC,GAEM;IACLa,QAAA,EAAU;IACVJ,WAAA;IACAC,QAAA;IACAV;EACF;AACF;AAMO,SAASwB,gBAAgBC,IAAA,EAAcC,KAAA,EAAqB;EACjE,MAAMC,UAAA,GAAazB,OAAA,CAAQ0B,GAAA,CAAIC,aAAA;EAC3BF,UAAA,GACFpC,cAAA,CAAeoC,UAAA,EAAY,GAAGF,IAAI,IAAIC,KAAK;AAAA,CAAI,IAG/CnB,OAAA,CAAQuB,IAAA,CAAK,mBAAmBL,IAAI,IAAIC,KAAK,EAAE;AAEnD;AAKO,SAASK,gBAAA,EAA2B;EACzC,OAAO,CAAC,CAAC7B,OAAA,CAAQ0B,GAAA,CAAII,cAAA;AACvB;AAKO,SAASC,KAAA,EAAgB;EAC9B,OAAO,CAAC,CAAC/B,OAAA,CAAQ0B,GAAA,CAAIM,EAAA;AACvB","ignoreList":[]}
+{"version":3,"names":["execSync","appendFileSync","createCacheKey","loadCache","saveCache","generateFingerprint","runWithCache","options","platform","buildCommand","outputPaths","projectRoot","process","cwd","cachePrefix","debug","log","console","hash","fingerprint","cacheKey","prefix","cached","cacheHit","execOptions","stdio","error","err","Error","message","stderr","timestamp","Date","toISOString","setGitHubOutput","name","value","outputFile","env","GITHUB_OUTPUT","info","isGitHubActions","GITHUB_ACTIONS","isCI","CI"],"sources":["../src/runner.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAsC;AAC/C,SAASC,cAAA,QAAsB;AAC/B,SAASC,cAAA,EAAgBC,SAAA,EAAWC,SAAA,QAAiB;AACrD,SAASC,mBAAA,QAA2B;AAwBpC,eAAsBC,aACpBC,OAAA,EAC6B;EAC7B,MAAM;IACJC,QAAA;IACAC,YAAA;IACAC,WAAA;IACAC,WAAA,GAAcC,OAAA,CAAQC,GAAA,CAAI;IAC1BC,WAAA,GAAc;IACdC,KAAA,GAAQ;EACV,IAAIR,OAAA;EAEJ,MAAMS,GAAA,GAAMD,KAAA,GAAQE,OAAA,CAAQD,GAAA,GAAM,MAAM,CAAC;EAGzCA,GAAA,CAAI,cAAcR,QAAQ,iBAAiB;EAC3C,MAAM;IAAEU,IAAA,EAAMC;EAAY,IAAI,MAAMd,mBAAA,CAAoB;IACtDG,QAAA;IACAG,WAAA;IACAI;EACF,CAAC;EACDC,GAAA,CAAI,gBAAgBG,WAAW,EAAE;EAGjC,MAAMC,QAAA,GAAWlB,cAAA,CAAe;IAAEM,QAAA;IAAUW,WAAA;IAAaE,MAAA,EAAQP;EAAY,CAAC;EAC9EE,GAAA,CAAI,cAAcI,QAAQ,EAAE;EAE5B,MAAME,MAAA,GAASnB,SAAA,CAAsDiB,QAAQ;EAE7E,IAAIE,MAAA,IAAUA,MAAA,CAAOH,WAAA,KAAgBA,WAAA,EAAa;IAChDH,GAAA,CAAI,4BAA4B;IAChC,OAAO;MACLO,QAAA,EAAU;MACVJ,WAAA;MACAC,QAAA;MACAV;IACF;EACF;EAGAM,GAAA,CAAI,kBAAkBP,YAAY,EAAE;EACpC,MAAMe,WAAA,GAA+B;IACnCX,GAAA,EAAKF,WAAA;IACLc,KAAA,EAAOV,KAAA,GAAQ,YAAY,CAAC,QAAQ,QAAQ,MAAM;EACpD;EAEA,IAAI;IACFf,QAAA,CAASS,YAAA,EAAce,WAAW;EACpC,SAASE,KAAA,EAAO;IACd,MAAMC,GAAA,GAAMD,KAAA;IACZ,MAAM,IAAIE,KAAA,CAAM,iBAAiBD,GAAA,CAAIE,OAAO,GAAGF,GAAA,CAAIG,MAAA,GAAS;AAAA,EAAKH,GAAA,CAAIG,MAAM,KAAK,EAAE,EAAE;EACtF;EAGA1B,SAAA,CAAUgB,QAAA,EAAU;IAClBD,WAAA;IACAY,SAAA,GAAW,mBAAIC,IAAA,CAAK,GAAEC,WAAA,CAAY;IAClCzB,QAAA;IACAE;EACF,CAAC;EAED,OAAO;IACLa,QAAA,EAAU;IACVJ,WAAA;IACAC,QAAA;IACAV;EACF;AACF;AAMO,SAASwB,gBAAgBC,IAAA,EAAcC,KAAA,EAAqB;EACjE,MAAMC,UAAA,GAAazB,OAAA,CAAQ0B,GAAA,CAAIC,aAAA;EAC/B,IAAIF,UAAA,EAAY;IACdpC,cAAA,CAAeoC,UAAA,EAAY,GAAGF,IAAI,IAAIC,KAAK;AAAA,CAAI;EACjD,OAAO;IAELnB,OAAA,CAAQuB,IAAA,CAAK,mBAAmBL,IAAI,IAAIC,KAAK,EAAE;EACjD;AACF;AAKO,SAASK,gBAAA,EAA2B;EACzC,OAAO,CAAC,CAAC7B,OAAA,CAAQ0B,GAAA,CAAII,cAAA;AACvB;AAKO,SAASC,KAAA,EAAgB;EAC9B,OAAO,CAAC,CAAC/B,OAAA,CAAQ0B,GAAA,CAAIM,EAAA;AACvB","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamagui/native-ci",
-  "version": "2.0.0-rc.9",
+  "version": "2.1.0",
   "description": "Native CI/CD helpers for React Native apps with Expo - fingerprinting, caching, and build optimization",
   "license": "MIT",
   "repository": {
@@ -24,6 +24,7 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./types/index.d.ts",
+      "browser": "./dist/index.mjs",
       "module": "./dist/index.mjs",
       "import": "./dist/index.mjs"
     }
@@ -38,10 +39,10 @@
     "clean:build": "tamagui-build clean:build"
   },
   "dependencies": {
-    "@expo/fingerprint": "^0.15.3"
+    "@expo/fingerprint": "~0.16.6"
   },
   "devDependencies": {
-    "@tamagui/build": "2.0.0-rc.9",
+    "@tamagui/build": "2.1.0",
     "@types/bun": "^1.1.0",
     "@types/node": "^22.1.0"
   },

package/src/cli.ts

@@ -26,7 +26,14 @@ import {
 } from './deps'
 import { withMetro } from './metro'
 import { parseDetoxArgs, runDetoxTests } from './detox'
-import { ensureIOSFolder, ensureIOSApp } from './ios'
+import {
+  ensureIOSFolder,
+  ensureIOSApp,
+  ensureBootedSimulator,
+  ensureAppInstalled,
+  getBootedSimulatorUDID,
+  getMaestroBundleId,
+} from './ios'
 import { setupAndroidDevice, ensureAndroidFolder } from './android'
 import type { Platform } from './constants'
 
@@ -196,6 +203,8 @@ try {
       const platform = subcommand || 'ios'
 
       if (platform === 'ios') {
+        ensureBootedSimulator()
+
         // Ensure iOS dependencies
         await ensureIosDeps()
 
@@ -244,6 +253,8 @@ try {
         })
         process.exit(exitCode)
       } else if (platform === 'maestro') {
+        ensureBootedSimulator()
+
         // Ensure Maestro is installed
         await ensureMaestro()
 
@@ -254,17 +265,28 @@ try {
 
         process.chdir(options.projectRoot)
 
+        // resolve the target simulator UDID once and use it consistently
+        const udid = getBootedSimulatorUDID()!
+
+        // ensure the app is built and installed on the target simulator
+        const bundleId = getMaestroBundleId(options.projectRoot)
+        await ensureAppInstalled({ projectRoot: options.projectRoot, bundleId, udid })
+
         // Run Maestro with Metro for development builds
         const exitCode = await withMetro('ios', async () => {
           const { $ } = await import('bun')
           // Flows are at ./flows/ in kitchen-sink, not .maestro/flows/
           const flowArg = flow ? `./flows/${flow}` : './flows'
+          const udidArgs = ['--udid', udid]
+          const debugDir = `${options.projectRoot}/.maestro-debug`
           const result =
-            await $`maestro test ${flowArg} --exclude-tags=util --no-ansi`.nothrow()
+            await $`maestro test ${flowArg} --exclude-tags=util --no-ansi --debug-output=${debugDir} ${udidArgs}`.nothrow()
           return result.exitCode
         })
         process.exit(exitCode)
       } else if (platform === 'all') {
+        ensureBootedSimulator()
+
         console.info('=== Running All Native Tests ===\n')
 
         // Run iOS tests

package/src/detox.ts

@@ -21,6 +21,8 @@ export interface DetoxRunnerOptions {
   headless?: boolean
   /** Number of parallel workers (default: 1) */
   workers?: number
+  /** Specific test files to run (passed as positional args to detox) */
+  testFiles?: string[]
 }
 
 /**
@@ -29,7 +31,7 @@ export interface DetoxRunnerOptions {
 export function parseDetoxArgs(platform: Platform) {
   const defaultConfig = platform === 'ios' ? 'ios.sim.debug' : 'android.emu.ci.debug'
 
-  const { values } = parseArgs({
+  const { values, positionals } = parseArgs({
     options: {
       config: { type: 'string', default: defaultConfig },
       'project-root': { type: 'string', default: process.cwd() },
@@ -38,6 +40,7 @@ export function parseDetoxArgs(platform: Platform) {
       retries: { type: 'string', default: '0' },
       workers: { type: 'string', default: '1' },
     },
+    allowPositionals: true,
   })
 
   // Validate and convert retries to number
@@ -61,6 +64,7 @@ export function parseDetoxArgs(platform: Platform) {
     recordLogs: values['record-logs']!,
     retries: retriesNum,
     workers: workersNum,
+    testFiles: positionals.length > 0 ? positionals : undefined,
   }
 }
 
@@ -90,11 +94,18 @@ export function buildDetoxArgs(options: DetoxRunnerOptions): string[] {
     args.push('--workers', String(options.workers))
   }
 
+  // append specific test files if provided (for CI sharding)
+  if (options.testFiles && options.testFiles.length > 0) {
+    args.push(...options.testFiles)
+  }
+
   return args
 }
 
-// 45 min timeout for detox tests (in ms) - allows room within 60 min CI job timeout
-const DETOX_TIMEOUT_MS = 45 * 60 * 1000
+// 60 min timeout for detox tests (in ms). the heaviest shard's real work is ~38min
+// (cold metro bundle + per-test app reloads), so 45min left too little margin; the
+// workflow job timeout is 90min, leaving room for setup + this run.
+const DETOX_TIMEOUT_MS = 60 * 60 * 1000
 
 /**
  * Reset Detox lock file to prevent ECOMPROMISED errors in CI

package/src/ios.ts

@@ -9,6 +9,187 @@ import { $ } from 'bun'
 import { isCI } from './runner'
 import { generateFingerprint } from './fingerprint'
 
+/**
+ * Check if any iOS simulator is booted and available for testing.
+ * Returns true if at least one simulator is booted.
+ */
+export function hasBootedSimulator(): boolean {
+  return !!getBootedSimulatorUDID()
+}
+
+/**
+ * Get the UDID of the first booted iOS simulator, or null if none.
+ */
+export function getBootedSimulatorUDID(): string | null {
+  try {
+    const output = execSync('xcrun simctl list devices booted', {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+    const match = output.match(/\(([A-F0-9-]{36})\)/i)
+    return match ? match[1] : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Boot an iOS simulator. Picks the first available iPhone device.
+ */
+export function ensureBootedSimulator(): void {
+  if (hasBootedSimulator()) return
+
+  console.info('No booted iOS simulator found, booting one...')
+  try {
+    const output = execSync('xcrun simctl list devices available', {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+    // find first available iPhone
+    const match = output.match(/iPhone[^\n]*\(([A-F0-9-]{36})\)/i)
+    if (!match) {
+      throw new Error('No available iPhone simulator found. Install one via Xcode.')
+    }
+    const udid = match[1]
+    console.info(`Booting simulator ${udid}...`)
+    execSync(`xcrun simctl boot ${udid}`, { stdio: 'inherit' })
+    console.info('Simulator booted.')
+  } catch (err) {
+    throw new Error(
+      `Failed to boot iOS simulator: ${err instanceof Error ? err.message : err}`
+    )
+  }
+}
+
+/**
+ * Check if an app is installed on the booted simulator.
+ */
+function isAppInstalled(bundleId: string, udid: string): boolean {
+  try {
+    execSync(`xcrun simctl get_app_container "${udid}" "${bundleId}"`, {
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Ensure the app is installed on a specific simulator.
+ * For dev client apps, builds if needed then installs.
+ * For Expo Go apps, ensures Expo Go is present.
+ */
+export async function ensureAppInstalled(opts: {
+  projectRoot: string
+  bundleId: string
+  udid?: string
+}): Promise<void> {
+  const { projectRoot, bundleId } = opts
+  const udid = opts.udid || getBootedSimulatorUDID() || 'booted'
+
+  // check if app is already installed
+  if (isAppInstalled(bundleId, udid)) {
+    console.info(`App ${bundleId} already installed on simulator ${udid}`)
+    return
+  }
+
+  if (bundleId === 'host.exp.Exponent') {
+    await installExpoGo(udid)
+    return
+  }
+
+  // custom dev client - build and install
+  console.info(`App ${bundleId} not installed, building...`)
+  await ensureIOSFolder()
+
+  const appPath =
+    process.env.DETOX_IOS_APP_PATH ||
+    'ios/build/Build/Products/Debug-iphonesimulator/tamaguikitchensink.app'
+  const fullAppPath = join(projectRoot, appPath)
+
+  if (!existsSync(fullAppPath)) {
+    await ensureIOSApp('ios.sim.debug')
+  }
+
+  console.info(`Installing app on simulator ${udid}...`)
+  execSync(`xcrun simctl install "${udid}" "${fullAppPath}"`, { stdio: 'inherit' })
+  console.info('App installed.')
+}
+
+/**
+ * Get the bundle ID needed for maestro tests.
+ * Checks flow files first (they declare appId), falls back to app.json.
+ */
+export function getMaestroBundleId(projectRoot: string): string {
+  // check flow files for appId
+  const flowsDir = join(projectRoot, 'flows')
+  if (existsSync(flowsDir)) {
+    try {
+      const files = require('fs').readdirSync(flowsDir) as string[]
+      for (const f of files) {
+        if (!f.endsWith('.yaml')) continue
+        const content = readFileSync(join(flowsDir, f), 'utf-8')
+        const match = content.match(/^appId:\s*(.+)$/m)
+        if (match) return match[1].trim()
+      }
+    } catch {}
+  }
+
+  // fall back to app.json
+  try {
+    const appJson = JSON.parse(readFileSync(join(projectRoot, 'app.json'), 'utf-8'))
+    return appJson.expo?.ios?.bundleIdentifier || 'host.exp.Exponent'
+  } catch {
+    return 'host.exp.Exponent'
+  }
+}
+
+/**
+ * Download and install Expo Go on the booted simulator.
+ */
+async function installExpoGo(udid: string): Promise<void> {
+  const tmpDir = join(require('os').tmpdir(), 'expo-go-install')
+  const appPath = join(tmpDir, 'Expo Go.app')
+
+  // skip download if already cached
+  if (existsSync(appPath)) {
+    console.info(`Installing cached Expo Go on simulator ${udid}...`)
+    execSync(`xcrun simctl install "${udid}" "${appPath}"`, { stdio: 'inherit' })
+    console.info('Expo Go installed.')
+    return
+  }
+
+  console.info('Downloading Expo Go...')
+  mkdirSync(tmpDir, { recursive: true })
+
+  // get the download URL from expo's version API
+  const { getVersionsAsync } =
+    // @ts-ignore - no type declarations for internal expo module
+    require('@expo/cli/build/src/api/getVersions') as {
+      getVersionsAsync: () => Promise<any>
+    }
+  const versions = await getVersionsAsync()
+
+  // find the latest SDK version that has an iOS client URL
+  const sdkVersions = Object.entries(versions.sdkVersions || {})
+    .filter(([, v]: [string, any]) => v.iosClientUrl)
+    .sort(([a], [b]) => b.localeCompare(a, undefined, { numeric: true }))
+  const clientUrl = (sdkVersions[0]?.[1] as any)?.iosClientUrl
+
+  if (!clientUrl) {
+    throw new Error('Could not find Expo Go download URL')
+  }
+
+  execSync(`curl -fsSL "${clientUrl}" -o "${tmpDir}/ExpoGo.tar.gz"`, { stdio: 'inherit' })
+  // archive contains .app contents directly, extract into .app bundle
+  mkdirSync(appPath, { recursive: true })
+  execSync(`tar -xzf "${tmpDir}/ExpoGo.tar.gz" -C "${appPath}"`, { stdio: 'inherit' })
+
+  execSync(`xcrun simctl install "${udid}" "${appPath}"`, { stdio: 'inherit' })
+  console.info('Expo Go installed.')
+}
+
 /**
  * Shutdown all simulators and clean up zombie simulator processes.
  * macOS doesn't properly clean up simulators between test runs, leading to

package/src/metro.ts

@@ -95,6 +95,26 @@ export async function prewarmBundle(platform: Platform): Promise<void> {
   }
 }
 
+/**
+ * Detect if the current project uses expo-dev-client by checking package.json.
+ */
+function projectUsesDevClient(): boolean {
+  try {
+    const pkg = JSON.parse(require('fs').readFileSync('package.json', 'utf-8'))
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+    // check for expo-dev-client dep, or --dev-client in the start script
+    if (deps['expo-dev-client']) return true
+    if (
+      typeof pkg.scripts?.start === 'string' &&
+      pkg.scripts.start.includes('--dev-client')
+    )
+      return true
+    return false
+  } catch {
+    return false
+  }
+}
+
 /**
  * Start Metro bundler as a background process.
  *
@@ -105,7 +125,12 @@ export function startMetro(): MetroProcess {
 
   // Only clear cache in CI - locally we want fast startup using cached transforms
   const isCI = !!process.env.CI
-  const args = ['bun', 'expo', 'start', '--dev-client', '--offline']
+  const useDevClient = projectUsesDevClient()
+  const args = ['bun', 'expo', 'start', '--offline']
+  if (useDevClient) {
+    args.splice(3, 0, '--dev-client')
+    console.info('Dev client detected')
+  }
   if (isCI) {
     args.push('--clear')
     console.info('CI detected: clearing Metro cache')