@nx/expo 23.1.0-beta.2 → 23.1.0-beta.3

package/dist/plugins/metro-resolver.js

@@ -12,15 +12,25 @@ const devkit_1 = require("@nx/devkit");
 // Cache for metro-resolver module
 let metroResolver = null;
 /**
- * Lazily require metro-resolver to handle cases where it might not be installed
+ * Lazily require the Metro resolver.
+ *
+ * Expo SDK 55+ ships Metro through `@expo/metro`, so the resolver must come
+ * from the same Metro instance Expo uses. Older SDKs (53/54) use the standalone
+ * `metro-resolver` package. We prefer `@expo/metro` and fall back to the
+ * standalone package to stay compatible with both.
  */
 function getMetroResolver() {
     if (!metroResolver) {
         try {
-            metroResolver = require('metro-resolver');
+            metroResolver = require('@expo/metro/metro-resolver');
         }
-        catch (error) {
-            throw new Error('metro-resolver is required but not installed. Please install metro-resolver >= 0.82.0');
+        catch {
+            try {
+                metroResolver = require('metro-resolver');
+            }
+            catch (error) {
+                throw new Error('Unable to load Metro resolver. Install `@expo/metro` (Expo SDK 55+) or `metro-resolver` (>= 0.82.0).');
+            }
         }
     }
     return metroResolver;

package/dist/plugins/with-nx-metro.js

@@ -7,15 +7,26 @@ const path_1 = require("path");
 // Cache for metro-config module
 let metroConfig = null;
 /**
- * Lazily require metro-config to handle cases where it might not be installed
+ * Lazily require the Metro config helpers.
+ *
+ * Expo SDK 55+ ships Metro through the `@expo/metro` package family, so the
+ * `mergeConfig` used here must come from the same Metro instance that
+ * `@expo/metro-config`'s `getDefaultConfig` is built against. Older SDKs
+ * (53/54) use the standalone `metro-config` package. We prefer `@expo/metro`
+ * and fall back to the standalone package to stay compatible with both.
  */
 function getMetroConfig() {
     if (!metroConfig) {
         try {
-            metroConfig = require('metro-config');
+            metroConfig = require('@expo/metro/metro-config');
         }
-        catch (error) {
-            throw new Error('metro-config is required but not installed. Please install metro-config >= 0.82.0');
+        catch {
+            try {
+                metroConfig = require('metro-config');
+            }
+            catch (error) {
+                throw new Error('Unable to load Metro config. Install `@expo/metro` (Expo SDK 55+) or `metro-config` (>= 0.82.0).');
+            }
         }
     }
     return metroConfig;
@@ -35,10 +46,24 @@ function withNxMetro(userConfig, opts = {}) {
         watchFolders = watchFolders.concat(opts.watchFolders);
     }
     watchFolders = [...new Set(watchFolders)].filter((folder) => (0, node_fs_1.existsSync)(folder));
+    // Expo SDK 55+ ships Metro via `@expo/metro` and resolves the project's
+    // Babel config relative to `projectRoot`. Forcing `projectRoot` to the
+    // workspace root breaks that lookup, because the app's `.babelrc.js` lives in
+    // the project directory, not the workspace root (Metro's babel transformer
+    // does `path.resolve(projectRoot, '.babelrc.js')`). So only override
+    // `projectRoot` for older SDKs (53/54). Workspace libraries remain resolvable
+    // via `watchFolders`, `nodeModulesPaths`, and the custom `resolveRequest`.
+    // `@expo/metro` has no root entry point (only subpath exports), so resolve a
+    // known subpath to detect it — `require.resolve('@expo/metro')` would throw
+    // ERR_PACKAGE_PATH_NOT_EXPORTED even when the package is installed.
+    let usesExpoMetro = false;
+    try {
+        require.resolve('@expo/metro/metro-config');
+        usesExpoMetro = true;
+    }
+    catch { }
     const nxConfig = {
-        // Set projectRoot to workspaceRoot to ensure originModulePath is
-        // workspace-relative. This is required for Expo SDK 54+ compatibility.
-        projectRoot: devkit_1.workspaceRoot,
+        ...(usesExpoMetro ? {} : { projectRoot: devkit_1.workspaceRoot }),
         resolver: {
             resolveRequest: (0, metro_resolver_1.getResolveRequest)(extensions, opts.exportsConditionNames, opts.mainFields),
             nodeModulesPaths: [(0, path_1.join)(devkit_1.workspaceRoot, 'node_modules')],

package/dist/src/executors/export/export.impl.js

@@ -7,6 +7,7 @@ const internal_1 = require("@nx/devkit/internal");
 const child_process_1 = require("child_process");
 const path_1 = require("path");
 const deprecation_1 = require("../../utils/deprecation");
+const resolve_expo_cli_1 = require("../../utils/resolve-expo-cli");
 let childProcess;
 async function* exportExecutor(options, context) {
     (0, deprecation_1.warnExpoExecutorDeprecation)('export');
@@ -25,7 +26,7 @@ async function* exportExecutor(options, context) {
 }
 function exportAsync(workspaceRoot, projectRoot, options) {
     return new Promise((resolve, reject) => {
-        childProcess = (0, child_process_1.fork)(require.resolve('@expo/cli/build/bin/cli'), [`export`, ...createExportOptions(options, projectRoot)], {
+        childProcess = (0, child_process_1.fork)((0, resolve_expo_cli_1.resolveExpoCliPath)(), [`export`, ...createExportOptions(options, projectRoot)], {
             cwd: (0, path_1.resolve)(workspaceRoot, projectRoot),
             env: process.env,
         });

package/dist/src/executors/prebuild/prebuild.impl.js

@@ -5,6 +5,7 @@ exports.prebuildAsync = prebuildAsync;
 const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const child_process_1 = require("child_process");
+const resolve_expo_cli_1 = require("../../utils/resolve-expo-cli");
 const path_1 = require("path");
 const pod_install_task_1 = require("../../utils/pod-install-task");
 const deprecation_1 = require("../../utils/deprecation");
@@ -33,7 +34,7 @@ async function* prebuildExecutor(options, context) {
 }
 function prebuildAsync(workspaceRoot, projectRoot, options) {
     return new Promise((resolve, reject) => {
-        childProcess = (0, child_process_1.fork)(require.resolve('@expo/cli/build/bin/cli'), ['prebuild', ...createPrebuildOptions(options), '--no-install'], {
+        childProcess = (0, child_process_1.fork)((0, resolve_expo_cli_1.resolveExpoCliPath)(), ['prebuild', ...createPrebuildOptions(options), '--no-install'], {
             cwd: (0, path_1.join)(workspaceRoot, projectRoot),
             env: process.env,
         });

package/dist/src/executors/run/run.impl.js

@@ -4,6 +4,7 @@ exports.default = runExecutor;
 const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const child_process_1 = require("child_process");
+const resolve_expo_cli_1 = require("../../utils/resolve-expo-cli");
 const node_fs_1 = require("node:fs");
 const os_1 = require("os");
 const path_1 = require("path");
@@ -43,7 +44,7 @@ async function* runExecutor(options, context) {
 }
 function runCliRun(workspaceRoot, projectRoot, options) {
     return new Promise((resolve, reject) => {
-        childProcess = (0, child_process_1.fork)(require.resolve('@expo/cli/build/bin/cli'), ['run:' + options.platform, ...createRunOptions(options), '--no-install'], // pass in no-install to prevent node_modules install
+        childProcess = (0, child_process_1.fork)((0, resolve_expo_cli_1.resolveExpoCliPath)(), ['run:' + options.platform, ...createRunOptions(options), '--no-install'], // pass in no-install to prevent node_modules install
         {
             cwd: (0, path_1.resolve)(workspaceRoot, projectRoot),
             env: process.env,

package/dist/src/executors/serve/serve.impl.js

@@ -5,6 +5,7 @@ exports.runCliServe = runCliServe;
 const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const child_process_1 = require("child_process");
+const resolve_expo_cli_1 = require("../../utils/resolve-expo-cli");
 const path_1 = require("path");
 const is_packager_running_1 = require("./lib/is-packager-running");
 const deprecation_1 = require("../../utils/deprecation");
@@ -54,7 +55,7 @@ async function runCliServe(workspaceRoot, projectRoot, options) {
 }
 function serveAsync(workspaceRoot, projectRoot, options) {
     return new Promise((resolve, reject) => {
-        const childProcess = (0, child_process_1.fork)(require.resolve('@expo/cli/build/bin/cli'), ['start', '--web', ...createServeOptions(options)], {
+        const childProcess = (0, child_process_1.fork)((0, resolve_expo_cli_1.resolveExpoCliPath)(), ['start', '--web', ...createServeOptions(options)], {
             cwd: (0, path_1.resolve)(workspaceRoot, projectRoot),
             env: process.env,
             stdio: ['inherit', 'pipe', 'pipe', 'ipc'],

package/dist/src/executors/start/start.impl.js

@@ -6,6 +6,7 @@ const pc = tslib_1.__importStar(require("picocolors"));
 const devkit_1 = require("@nx/devkit");
 const internal_1 = require("@nx/devkit/internal");
 const child_process_1 = require("child_process");
+const resolve_expo_cli_1 = require("../../utils/resolve-expo-cli");
 const path_1 = require("path");
 const deprecation_1 = require("../../utils/deprecation");
 let childProcess;
@@ -29,7 +30,7 @@ async function* startExecutor(options, context) {
 }
 function startAsync(workspaceRoot, projectRoot, options) {
     return new Promise((resolve, reject) => {
-        childProcess = (0, child_process_1.fork)(require.resolve('@expo/cli/build/bin/cli'), ['start', ...createStartOptions(options)], {
+        childProcess = (0, child_process_1.fork)((0, resolve_expo_cli_1.resolveExpoCliPath)(), ['start', ...createStartOptions(options)], {
             cwd: (0, path_1.resolve)(workspaceRoot, projectRoot),
             env: {
                 RCT_METRO_PORT: options.port.toString(),

package/dist/src/generators/application/files/base/metro.config.js.template

@@ -1,6 +1,9 @@
 const { withNxMetro } = require('@nx/expo');
-const { getDefaultConfig } = require('@expo/metro-config');
-const { mergeConfig } = require('metro-config');
+<% if (usesExpoMetro) { %>// Expo SDK 55+ ships Metro via `@expo/metro`. `getDefaultConfig` and
+// `mergeConfig` must come from the Expo-provided Metro instance.
+const { getDefaultConfig } = require('expo/metro-config');
+const { mergeConfig } = require('@expo/metro/metro-config');<% } else { %>const { getDefaultConfig } = require('@expo/metro-config');
+const { mergeConfig } = require('metro-config');<% } %>
 
 const defaultConfig = getDefaultConfig(__dirname);
 const { assetExts, sourceExts } = defaultConfig.resolver;

package/dist/src/generators/application/files/base/package.json.template

@@ -3,15 +3,17 @@
   "version": "0.0.1",
   "private": true,
   "dependencies": {
-    "@expo/metro-config": "*",
+    "@expo/vector-icons": "*",<% if (usesExpoMetro) { %>
+    "@expo/metro": "*",<% } else { %>
+    "@expo/metro-config": "*",<% } %>
     "@testing-library/react-native": "*",
     "expo": "*",
     "expo-splash-screen": "*",
     "expo-status-bar": "*",
     "expo-system-ui": "*",
-    "jest-expo": "*",
+    "jest-expo": "*",<% if (!usesExpoMetro) { %>
     "metro-config": "*",
-    "metro-resolver": "*",
+    "metro-resolver": "*",<% } %>
     "react": "*",
     "react-native": "*",
     "react-native-svg": "*",

package/dist/src/generators/application/lib/create-application-files.js

@@ -4,8 +4,14 @@ exports.createApplicationFiles = createApplicationFiles;
 const devkit_1 = require("@nx/devkit");
 const onboarding_1 = require("nx/src/nx-cloud/utilities/onboarding");
 const path_1 = require("path");
+const version_utils_1 = require("../../../utils/version-utils");
 async function createApplicationFiles(host, options) {
     const packageManager = (0, devkit_1.detectPackageManager)(host.root);
+    // Expo SDK 55+ ships Metro via `@expo/metro` instead of the standalone
+    // `metro`/`metro-config`/`metro-resolver` packages. When null (no Expo
+    // installed yet), default to the latest behavior (v56).
+    const installedExpoMajor = await (0, version_utils_1.getInstalledExpoMajor)(host);
+    const usesExpoMetro = installedExpoMajor === null || installedExpoMajor >= 55;
     const onBoardingStatus = await (0, onboarding_1.createNxCloudOnboardingURLForWelcomeApp)(host, options.nxCloudToken);
     const connectCloudUrl = onBoardingStatus === 'unclaimed' &&
         (await (0, onboarding_1.getNxCloudAppOnBoardingUrl)(options.nxCloudToken));
@@ -13,6 +19,7 @@ async function createApplicationFiles(host, options) {
         ...options,
         offsetFromRoot: (0, devkit_1.offsetFromRoot)(options.appProjectRoot),
         packageManager,
+        usesExpoMetro,
     });
     (0, devkit_1.generateFiles)(host, (0, path_1.join)(__dirname, `../files/nx-welcome/${onBoardingStatus}`), options.appProjectRoot, {
         ...options,

package/dist/src/generators/init/init.js

@@ -5,6 +5,7 @@ exports.expoInitGeneratorInternal = expoInitGeneratorInternal;
 exports.updateDependencies = updateDependencies;
 const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
+const semver_1 = require("semver");
 const plugin_1 = require("../../../plugins/plugin");
 const versions_1 = require("../../utils/versions");
 const version_utils_1 = require("../../utils/version-utils");
@@ -58,6 +59,12 @@ async function expoInitGeneratorInternal(host, schema) {
 }
 async function updateDependencies(host, schema) {
     const versions = await (0, version_utils_1.getExpoDependenciesVersionsToInstall)(host);
+    // Expo SDK 55+ provides Metro through `@expo/metro` (a transitive dependency
+    // of `expo`). Installing the standalone `metro-config`/`metro-resolver`
+    // packages alongside it pulls in a second, incompatible Metro instance and
+    // breaks bundling, so only add them for older SDKs (53/54).
+    const expoMajor = (0, semver_1.major)((0, semver_1.coerce)(versions.expo) ?? '0.0.0');
+    const usesExpoMetro = expoMajor >= 55;
     return (0, devkit_1.addDependenciesToPackageJson)(host, {
         react: versions.react,
         'react-dom': versions.reactDom,
@@ -66,8 +73,12 @@ async function updateDependencies(host, schema) {
     }, {
         '@nx/expo': versions_1.nxVersion,
         '@expo/cli': versions.expoCli,
-        'metro-config': versions.metro,
-        'metro-resolver': versions.metro,
+        ...(usesExpoMetro
+            ? {}
+            : {
+                'metro-config': versions.metro,
+                'metro-resolver': versions.metro,
+            }),
     }, undefined, schema.keepExistingVersions ?? true);
 }
 function moveDependency(host) {

package/dist/src/migrations/update-23-1-0/ai-instructions-for-expo-56.md

@@ -0,0 +1,148 @@
+# Expo SDK 56 Migration Instructions for LLM
+
+## Overview
+
+These instructions guide you through migrating an Nx workspace containing Expo projects to Expo SDK 56. The most common starting points are Expo SDK 54 and SDK 55. Work systematically through each breaking change category and validate after every step.
+
+## Pre-Migration Checklist
+
+1. **Identify all Expo projects**:
+
+   ```bash
+   nx show projects --with-target start
+   ```
+
+2. **Locate all Expo configuration files**:
+   - Search for `app.json` or `app.config.{js,ts}`
+   - Search for `metro.config.{js,ts}`
+   - Search for `babel.config.{js,ts}`
+   - Check `project.json` files for Expo-related configuration
+
+3. **Record the current SDK** for each project (read `expo` in each app's `package.json`).
+
+4. **Check for Detox E2E testing projects**:
+   - Search for `detox` in package.json dependencies
+   - Look for `detox.config.js` or `.detoxrc.js` files
+
+## Target Versions (Expo SDK 56)
+
+When updating an app's `package.json`, align to these versions:
+
+- `expo`: `~56.0.0`
+- `@expo/cli`: `~56.1.14`
+- `react`: `^19.2.0`
+- `react-dom`: `^19.2.0`
+- `@types/react`: `^19.2.0`
+- `react-native`: `0.85.3`
+- `react-native-web`: `~0.21.0`
+- `@expo/metro`: `~56.0.0`
+- `@expo/metro-runtime`: `~56.0.14`
+- `babel-preset-expo`: `~56.0.14`
+- `jest-expo`: `~56.0.4`
+- `expo-splash-screen`: `~56.0.10`
+- `expo-status-bar`: `~56.0.4`
+- `expo-system-ui`: `~56.0.5`
+
+> Prefer `npx expo install --fix` inside each project to let Expo resolve the exact compatible native module versions for SDK 56, then reconcile the workspace root `package.json`.
+
+## Migration Steps by Category
+
+### 1. React 19.2 and React Native 0.85
+
+Expo SDK 56 uses React 19.2 and React Native 0.85.
+
+**Action Items**:
+
+- [ ] Update `@types/react` to `^19.2.0`
+- [ ] Verify third-party libraries are compatible with React 19.2 / RN 0.85
+- [ ] Re-run typecheck: `nx run-many -t typecheck`
+
+### 2. Metro is now provided through `@expo/metro`
+
+Starting with SDK 55, Expo bundles Metro through the `@expo/metro` package family rather than depending on the standalone `metro`, `metro-config`, and `metro-resolver` packages directly.
+
+**Search Pattern**: `metro.config.{js,ts}`, direct imports of `metro-config` / `metro-resolver`
+
+**Action Items**:
+
+- [ ] Add `@expo/metro` (`~56.0.0`) as a direct dependency — the generated `metro.config.js` and `withNxMetro` require `@expo/metro/metro-config`, which package managers like pnpm won't resolve from a transitive dependency
+- [ ] Source the Metro config from the Expo-provided instance: `getDefaultConfig` from `expo/metro-config` and `mergeConfig` from `@expo/metro/metro-config`
+- [ ] Remove direct dependencies on standalone `metro` / `metro-config` / `metro-resolver`, and do not install `@expo/metro-config` directly (expo-doctor flags it) — `@expo/metro` replaces them
+- [ ] If you wrap config with `withNxMetro` from `@nx/expo`, leave it in place — it continues to merge Nx workspace resolution
+- [ ] Clear the Metro cache after upgrading: `npx expo start --clear`
+
+### 3. Babel preset
+
+SDK 56 updates `babel-preset-expo` to `~56.0.14`.
+
+**Action Items**:
+
+- [ ] Update `babel-preset-expo` to `~56.0.14`
+- [ ] Remove deprecated Babel plugins
+- [ ] Clear Metro cache after Babel changes: `npx expo start --clear`
+
+### 4. Jest configuration
+
+Expo v54+ (including SDK 56) relies on the winter runtime. New projects generated by `@nx/expo` no longer use the custom `jest.resolver.js`; instead `src/test-setup.ts` mocks `expo/src/winter/ImportMetaRegistry` and polyfills `structuredClone`.
+
+**Action Items**:
+
+- [ ] If migrating from SDK 53, remove `jest.resolver.js` and the `resolver:` line from `jest.config.ts`
+- [ ] Ensure `src/test-setup.ts` mocks `ImportMetaRegistry` and polyfills `structuredClone`
+- [ ] Update `jest-expo` to `~56.0.4`
+
+### 5. Detox E2E Testing
+
+**Verify Detox supports Expo SDK 56 before migrating.** If your workspace includes Detox projects and Detox has not yet published SDK 56 support, ask the user:
+
+> "Your workspace contains Detox E2E tests. Confirm Detox supports Expo SDK 56 before proceeding, or these tests may not run after migrating."
+
+Consider [Maestro](https://maestro.mobile.dev/) as an alternative if Detox support lags.
+
+## Post-Migration Validation
+
+### 1. Clear All Caches
+
+```bash
+npx expo start --clear
+rm -rf node_modules/.cache/metro-*
+nx reset
+```
+
+### 2. Run Tests Per Project
+
+```bash
+nx run-many -t test -p PROJECT_NAME
+```
+
+### 3. Run All Affected Tests
+
+```bash
+nx affected -t test,lint,typecheck
+```
+
+### 4. Test on Device/Simulator
+
+```bash
+nx run PROJECT_NAME:run-ios
+nx run PROJECT_NAME:run-android
+```
+
+### 5. Review Migration Checklist
+
+- [ ] All Expo apps pinned to SDK 56 versions
+- [ ] React 19.2 / React Native 0.85 compatibility verified
+- [ ] Metro provided via `@expo/metro`; caches cleared
+- [ ] Babel and Jest configurations updated
+- [ ] All tests pass
+- [ ] App runs on iOS simulator/device
+- [ ] App runs on Android emulator/device
+
+## Notes for LLM Execution
+
+1. **Work systematically**: Complete one category before moving to the next.
+2. **Test after each change**: Don't batch all changes without validation.
+3. **Prefer `npx expo install --fix`** per project to resolve native module versions.
+4. **Keep the user informed** and create meaningful, grouped commits.
+5. **Use the TodoWrite tool** to track migration progress.
+6. **Test on both platforms** — Expo changes often affect iOS and Android differently.

package/dist/src/migrations/update-23-1-0/lib/expo-apps.d.ts

@@ -0,0 +1,7 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Returns the project roots of every Expo application in the workspace.
+ * An Expo project is detected by an `expo` entry in its (or the root)
+ * package.json.
+ */
+export declare function getExpoAppRoots(tree: Tree): string[];

package/dist/src/migrations/update-23-1-0/lib/expo-apps.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpoAppRoots = getExpoAppRoots;
+const devkit_1 = require("@nx/devkit");
+/**
+ * Returns the project roots of every Expo application in the workspace.
+ * An Expo project is detected by an `expo` entry in its (or the root)
+ * package.json.
+ */
+function getExpoAppRoots(tree) {
+    const roots = [];
+    for (const [, config] of (0, devkit_1.getProjects)(tree)) {
+        if (config.projectType !== 'application') {
+            continue;
+        }
+        if (isExpoProject(tree, config.root)) {
+            roots.push(config.root);
+        }
+    }
+    return roots;
+}
+function isExpoProject(tree, projectRoot) {
+    // Newer Expo apps declare deps as `*` and pin them at the workspace root, so
+    // check both the project package.json and the root package.json.
+    for (const dir of [projectRoot, '']) {
+        const packageJsonPath = (0, devkit_1.joinPathFragments)(dir, 'package.json');
+        if (!tree.exists(packageJsonPath)) {
+            continue;
+        }
+        try {
+            const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+            if (packageJson.dependencies?.expo || packageJson.devDependencies?.expo) {
+                return true;
+            }
+        }
+        catch {
+            // ignore malformed package.json
+        }
+    }
+    return false;
+}

package/dist/src/migrations/update-23-1-0/replace-standalone-metro-for-expo-56.d.ts

@@ -0,0 +1,10 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Expo SDK 55+ provides Metro through `@expo/metro`. Installing the standalone
+ * `metro-config`/`metro-resolver` packages alongside it pulls in a second,
+ * incompatible Metro instance that breaks bundling. Replace them with
+ * `@expo/metro` (a direct dependency is required so `withNxMetro` and the
+ * generated `metro.config.js` can `require('@expo/metro/metro-config')` under
+ * pnpm).
+ */
+export default function update(tree: Tree): void;

package/dist/src/migrations/update-23-1-0/replace-standalone-metro-for-expo-56.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const versions_1 = require("../../utils/versions");
+const expo_apps_1 = require("./lib/expo-apps");
+/**
+ * Expo SDK 55+ provides Metro through `@expo/metro`. Installing the standalone
+ * `metro-config`/`metro-resolver` packages alongside it pulls in a second,
+ * incompatible Metro instance that breaks bundling. Replace them with
+ * `@expo/metro` (a direct dependency is required so `withNxMetro` and the
+ * generated `metro.config.js` can `require('@expo/metro/metro-config')` under
+ * pnpm).
+ */
+function update(tree) {
+    const appRoots = (0, expo_apps_1.getExpoAppRoots)(tree);
+    if (appRoots.length === 0) {
+        return;
+    }
+    // Root package.json holds the pinned versions in the integrated layout.
+    swapMetro(tree, 'package.json', versions_1.expoV56MetroVersion);
+    // App package.jsons declare deps as `*` (resolved from the root).
+    for (const projectRoot of appRoots) {
+        swapMetro(tree, (0, devkit_1.joinPathFragments)(projectRoot, 'package.json'), '*');
+    }
+}
+function swapMetro(tree, packageJsonPath, expoMetroVersion) {
+    if (!tree.exists(packageJsonPath)) {
+        return;
+    }
+    const packageJson = (0, devkit_1.readJson)(tree, packageJsonPath);
+    const hasStandaloneMetro = packageJson.dependencies?.['metro-config'] ||
+        packageJson.dependencies?.['metro-resolver'] ||
+        packageJson.devDependencies?.['metro-config'] ||
+        packageJson.devDependencies?.['metro-resolver'];
+    // Only touch workspaces/apps that still carry the standalone packages.
+    if (!hasStandaloneMetro) {
+        return;
+    }
+    (0, devkit_1.removeDependenciesFromPackageJson)(tree, ['metro-config', 'metro-resolver'], ['metro-config', 'metro-resolver'], packageJsonPath);
+    const alreadyHasExpoMetro = packageJson.dependencies?.['@expo/metro'] ||
+        packageJson.devDependencies?.['@expo/metro'];
+    if (!alreadyHasExpoMetro) {
+        (0, devkit_1.addDependenciesToPackageJson)(tree, { '@expo/metro': expoMetroVersion }, {}, packageJsonPath);
+    }
+}

package/dist/src/migrations/update-23-1-0/update-jest-winter-runtime-for-expo-56.d.ts

@@ -0,0 +1,8 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Expo SDK 56's winter runtime installs lazy globals that Jest rejects as
+ * "outside of the scope of the test code" in a monorepo. Add the winter-globals
+ * neutralization block to the generated test-setup files that mock
+ * `ImportMetaRegistry` but don't yet have it.
+ */
+export default function update(tree: Tree): void;

package/dist/src/migrations/update-23-1-0/update-jest-winter-runtime-for-expo-56.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const expo_apps_1 = require("./lib/expo-apps");
+const WINTER_GLOBALS_BLOCK = `
+// Expo SDK 55+ installs lazy winter-runtime globals (fetch, URL, etc.) that
+// require files Jest treats as "outside of the scope of the test code" in a
+// monorepo. Replace them with the runtime's own globals so the lazy getters
+// never fire during tests.
+const defineGlobal = (name, value) => {
+  try {
+    Object.defineProperty(global, name, {
+      value,
+      configurable: true,
+      writable: true,
+    });
+  } catch {
+    // Ignore environments that don't allow redefining these globals.
+  }
+};
+defineGlobal('fetch', globalThis.fetch);
+defineGlobal('Headers', globalThis.Headers);
+defineGlobal('Request', globalThis.Request);
+defineGlobal('Response', globalThis.Response);
+defineGlobal('FormData', globalThis.FormData);
+defineGlobal('URL', globalThis.URL);
+defineGlobal('URLSearchParams', globalThis.URLSearchParams);
+`;
+/**
+ * Expo SDK 56's winter runtime installs lazy globals that Jest rejects as
+ * "outside of the scope of the test code" in a monorepo. Add the winter-globals
+ * neutralization block to the generated test-setup files that mock
+ * `ImportMetaRegistry` but don't yet have it.
+ */
+function update(tree) {
+    for (const projectRoot of (0, expo_apps_1.getExpoAppRoots)(tree)) {
+        for (const ext of ['ts', 'js']) {
+            const setupPath = (0, devkit_1.joinPathFragments)(projectRoot, `src/test-setup.${ext}`);
+            if (!tree.exists(setupPath)) {
+                continue;
+            }
+            const content = tree.read(setupPath, 'utf-8');
+            // Only update the generated winter-runtime setup, and only once.
+            if (!content ||
+                !content.includes('expo/src/winter/ImportMetaRegistry') ||
+                content.includes('defineGlobal(')) {
+                continue;
+            }
+            const anchor = '}));\n';
+            const idx = content.indexOf(anchor);
+            const updated = idx === -1
+                ? `${content}\n${WINTER_GLOBALS_BLOCK}`
+                : content.slice(0, idx + anchor.length) +
+                    WINTER_GLOBALS_BLOCK +
+                    content.slice(idx + anchor.length);
+            tree.write(setupPath, updated);
+            devkit_1.logger.info(`Updated ${setupPath} for the Expo SDK 56 winter runtime in Jest.`);
+        }
+    }
+}

package/dist/src/migrations/update-23-1-0/update-metro-config-for-expo-56.d.ts

@@ -0,0 +1,9 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Expo SDK 55+ ships Metro via the `@expo/metro` package family. Update the
+ * generated `metro.config.js` to source `getDefaultConfig`/`mergeConfig` from
+ * `expo/metro-config` and `@expo/metro/metro-config` instead of the standalone
+ * `metro-config`. Only files matching the generated form are rewritten;
+ * customized configs are left untouched.
+ */
+export default function update(tree: Tree): void;

package/dist/src/migrations/update-23-1-0/update-metro-config-for-expo-56.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const expo_apps_1 = require("./lib/expo-apps");
+const REPLACEMENTS = [
+    [
+        "const { getDefaultConfig } = require('@expo/metro-config');",
+        "const { getDefaultConfig } = require('expo/metro-config');",
+    ],
+    [
+        "const { mergeConfig } = require('metro-config');",
+        "const { mergeConfig } = require('@expo/metro/metro-config');",
+    ],
+];
+/**
+ * Expo SDK 55+ ships Metro via the `@expo/metro` package family. Update the
+ * generated `metro.config.js` to source `getDefaultConfig`/`mergeConfig` from
+ * `expo/metro-config` and `@expo/metro/metro-config` instead of the standalone
+ * `metro-config`. Only files matching the generated form are rewritten;
+ * customized configs are left untouched.
+ */
+function update(tree) {
+    for (const projectRoot of (0, expo_apps_1.getExpoAppRoots)(tree)) {
+        const metroConfigPath = (0, devkit_1.joinPathFragments)(projectRoot, 'metro.config.js');
+        if (!tree.exists(metroConfigPath)) {
+            continue;
+        }
+        let content = tree.read(metroConfigPath, 'utf-8');
+        if (!content) {
+            continue;
+        }
+        const original = content;
+        for (const [from, to] of REPLACEMENTS) {
+            if (content.includes(from)) {
+                content = content.replace(from, to);
+            }
+        }
+        if (content !== original) {
+            tree.write(metroConfigPath, content);
+            devkit_1.logger.info(`Updated ${metroConfigPath} to use @expo/metro for Expo SDK 56.`);
+        }
+    }
+}

package/dist/src/utils/ensure-dependencies.js

@@ -2,9 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureDependencies = ensureDependencies;
 const devkit_1 = require("@nx/devkit");
+const semver_1 = require("semver");
 const version_utils_1 = require("./version-utils");
+const versions_1 = require("./versions");
 async function ensureDependencies(host, unitTestRunner) {
     const versions = await (0, version_utils_1.getExpoDependenciesVersionsToInstall)(host);
+    // Expo SDK 55+ ships Metro via `@expo/metro` and exposes its config through
+    // the `expo/metro-config` sub-export, so `@expo/metro-config` should not be
+    // installed directly (expo-doctor flags it). Instead `@expo/metro` must be a
+    // direct dependency, because the generated `metro.config.js` and `withNxMetro`
+    // require `@expo/metro/metro-config` — package managers like pnpm don't allow
+    // requiring into transitive dependencies. Older SDKs (53/54) keep the
+    // standalone `@expo/metro-config`.
+    const usesExpoMetro = (0, semver_1.major)((0, semver_1.coerce)(versions.expo) ?? '0.0.0') >= 55;
+    const metroDeps = usesExpoMetro
+        ? versions.expoMetro
+            ? { '@expo/metro': versions.expoMetro }
+            : {}
+        : { '@expo/metro-config': versions.expoMetroConfig };
     const devDependencies = {
         '@types/react': versions.typesReact,
         'babel-preset-expo': versions.babelPresetExpo,
@@ -20,11 +35,12 @@ async function ensureDependencies(host, unitTestRunner) {
         devDependencies['jest-expo'] = versions.jestExpo;
     }
     return (0, devkit_1.addDependenciesToPackageJson)(host, {
+        '@expo/vector-icons': versions_1.expoVectorIconsVersion,
         'expo-splash-screen': versions.expoSplashScreen,
         'expo-status-bar': versions.expoStatusBar,
         'expo-system-ui': versions.expoSystemUi,
         'react-native-web': versions.reactNativeWeb,
-        '@expo/metro-config': versions.expoMetroConfig,
+        ...metroDeps,
         '@expo/metro-runtime': versions.expoMetroRuntime,
         'react-native-svg-transformer': versions.reactNativeSvgTransformer,
         'react-native-svg': versions.reactNativeSvg,

package/dist/src/utils/jest/add-jest.js

@@ -68,6 +68,29 @@ module.exports = {
   },
 }));
 
+// Expo SDK 55+ installs lazy winter-runtime globals (fetch, URL, etc.) that
+// require files Jest treats as "outside of the scope of the test code" in a
+// monorepo. Replace them with the runtime's own globals so the lazy getters
+// never fire during tests.
+const defineGlobal = (name, value) => {
+  try {
+    Object.defineProperty(global, name, {
+      value,
+      configurable: true,
+      writable: true,
+    });
+  } catch {
+    // Ignore environments that don't allow redefining these globals.
+  }
+};
+defineGlobal('fetch', globalThis.fetch);
+defineGlobal('Headers', globalThis.Headers);
+defineGlobal('Request', globalThis.Request);
+defineGlobal('Response', globalThis.Response);
+defineGlobal('FormData', globalThis.FormData);
+defineGlobal('URL', globalThis.URL);
+defineGlobal('URLSearchParams', globalThis.URLSearchParams);
+
 if (typeof global.structuredClone === 'undefined') {
   global.structuredClone = (object) => JSON.parse(JSON.stringify(object));
 }

package/dist/src/utils/resolve-expo-cli.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve the path to the Expo CLI entry point.
+ *
+ * Expo SDK 55+ ships `@expo/cli` with an `exports` map where subpaths resolve
+ * to `*.js` (`"./*": "./*.js"`). The CLI bin file is `build/bin/cli` (with no
+ * extension), so `require.resolve('@expo/cli/build/bin/cli')` now fails with
+ * MODULE_NOT_FOUND. The `expo` package's `bin/cli` is the stable entry point
+ * (the same one `npx expo` uses) across all supported SDK versions, so prefer
+ * it and fall back to the legacy `@expo/cli` path for older setups.
+ */
+export declare function resolveExpoCliPath(): string;

package/dist/src/utils/resolve-expo-cli.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExpoCliPath = resolveExpoCliPath;
+/**
+ * Resolve the path to the Expo CLI entry point.
+ *
+ * Expo SDK 55+ ships `@expo/cli` with an `exports` map where subpaths resolve
+ * to `*.js` (`"./*": "./*.js"`). The CLI bin file is `build/bin/cli` (with no
+ * extension), so `require.resolve('@expo/cli/build/bin/cli')` now fails with
+ * MODULE_NOT_FOUND. The `expo` package's `bin/cli` is the stable entry point
+ * (the same one `npx expo` uses) across all supported SDK versions, so prefer
+ * it and fall back to the legacy `@expo/cli` path for older setups.
+ */
+function resolveExpoCliPath() {
+    try {
+        return require.resolve('expo/bin/cli');
+    }
+    catch {
+        return require.resolve('@expo/cli/build/bin/cli');
+    }
+}

package/dist/src/utils/version-utils.d.ts

@@ -6,6 +6,7 @@ export type ExpoDependenciesVersions = {
     expoSystemUi: string;
     expoCli: string;
     babelPresetExpo: string;
+    expoMetro?: string;
     expoMetroConfig: string;
     expoMetroRuntime: string;
     jestExpo: string;
@@ -23,9 +24,16 @@ export type ExpoDependenciesVersions = {
 };
 /**
  * Get the appropriate dependency versions based on the installed Expo version.
- * Returns v53 or v54 versions when those are detected, otherwise v55 (latest).
+ * Returns the matching lane for v53/v54/v55 when detected, otherwise v56
+ * (latest).
  */
 export declare function getExpoDependenciesVersionsToInstall(tree: Tree): Promise<ExpoDependenciesVersions>;
+/**
+ * Resolve the installed Expo major version. Prefers the resolved version from
+ * the project graph, falling back to the declared package.json version.
+ * Returns null when Expo isn't installed.
+ */
+export declare function getInstalledExpoMajor(tree: Tree): Promise<number | null>;
 /**
  * Check if the workspace is using Expo v53 — the only SDK that still needs the
  * legacy Jest resolver. SDK 54+ use the winter-runtime mock instead.

package/dist/src/utils/version-utils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getExpoDependenciesVersionsToInstall = getExpoDependenciesVersionsToInstall;
+exports.getInstalledExpoMajor = getInstalledExpoMajor;
 exports.isExpoV53 = isExpoV53;
 exports.getInstalledExpoVersion = getInstalledExpoVersion;
 exports.getInstalledExpoVersionFromGraph = getInstalledExpoVersionFromGraph;
@@ -14,8 +15,8 @@ const sharedVersions = {
     testingLibraryReactNative: versions_1.testingLibraryReactNativeVersion,
     babelRuntime: versions_1.babelRuntimeVersion,
 };
-// Per-major Expo install lanes. 55 is the latest/default; 53 and 54 are kept
-// for existing workspaces. Anything outside this window routes to 55 — the
+// Per-major Expo install lanes. 56 is the latest/default; 53, 54 and 55 are
+// kept for existing workspaces. Anything outside this window routes to 56 — the
 // below-floor throw is assertSupportedExpoVersion's job, not the router's.
 const expoVersionsByMajor = {
     53: {
@@ -63,6 +64,7 @@ const expoVersionsByMajor = {
         expoSystemUi: versions_1.expoV55SystemUiVersion,
         expoCli: versions_1.expoV55CliVersion,
         babelPresetExpo: versions_1.babelPresetExpoV55Version,
+        expoMetro: versions_1.expoV55MetroVersion,
         expoMetroConfig: versions_1.expoV55MetroConfigVersion,
         expoMetroRuntime: versions_1.expoV55MetroRuntimeVersion,
         jestExpo: versions_1.jestExpoV55Version,
@@ -75,17 +77,38 @@ const expoVersionsByMajor = {
         reactTestRenderer: versions_1.reactTestRendererV55Version,
         ...sharedVersions,
     },
+    56: {
+        expo: versions_1.expoV56Version,
+        expoSplashScreen: versions_1.expoV56SplashScreenVersion,
+        expoStatusBar: versions_1.expoV56StatusBarVersion,
+        expoSystemUi: versions_1.expoV56SystemUiVersion,
+        expoCli: versions_1.expoV56CliVersion,
+        babelPresetExpo: versions_1.babelPresetExpoV56Version,
+        expoMetro: versions_1.expoV56MetroVersion,
+        expoMetroConfig: versions_1.expoV56MetroConfigVersion,
+        expoMetroRuntime: versions_1.expoV56MetroRuntimeVersion,
+        jestExpo: versions_1.jestExpoV56Version,
+        react: versions_1.reactV56Version,
+        reactDom: versions_1.reactDomV56Version,
+        typesReact: versions_1.typesReactV56Version,
+        reactNative: versions_1.reactNativeV56Version,
+        metro: versions_1.metroV56Version,
+        reactNativeWeb: versions_1.reactNativeWebV56Version,
+        reactTestRenderer: versions_1.reactTestRendererV56Version,
+        ...sharedVersions,
+    },
 };
 /**
  * Get the appropriate dependency versions based on the installed Expo version.
- * Returns v53 or v54 versions when those are detected, otherwise v55 (latest).
+ * Returns the matching lane for v53/v54/v55 when detected, otherwise v56
+ * (latest).
  */
 async function getExpoDependenciesVersionsToInstall(tree) {
     const installedMajor = await getInstalledExpoMajor(tree);
-    if (installedMajor === 53 || installedMajor === 54) {
+    if (installedMajor === 53 || installedMajor === 54 || installedMajor === 55) {
         return expoVersionsByMajor[installedMajor];
     }
-    return expoVersionsByMajor[55];
+    return expoVersionsByMajor[56];
 }
 /**
  * Resolve the installed Expo major version. Prefers the resolved version from

package/dist/src/utils/versions.d.ts

@@ -2,12 +2,30 @@ import { type Tree } from '@nx/devkit';
 export declare const nxVersion: any;
 export declare const minSupportedExpoVersion = "53.0.0";
 export declare function assertSupportedExpoVersion(tree: Tree): void;
+export declare const expoV56Version = "~56.0.0";
+export declare const expoV56SplashScreenVersion = "~56.0.10";
+export declare const expoV56StatusBarVersion = "~56.0.4";
+export declare const expoV56SystemUiVersion = "~56.0.5";
+export declare const expoV56CliVersion = "~56.1.14";
+export declare const babelPresetExpoV56Version = "~56.0.14";
+export declare const expoV56MetroVersion = "~56.0.0";
+export declare const expoV56MetroConfigVersion = "~56.0.13";
+export declare const expoV56MetroRuntimeVersion = "~56.0.14";
+export declare const jestExpoV56Version = "~56.0.4";
+export declare const reactV56Version = "^19.2.0";
+export declare const reactDomV56Version = "^19.2.0";
+export declare const typesReactV56Version = "^19.2.0";
+export declare const reactNativeV56Version = "0.85.3";
+export declare const metroV56Version = "~0.84.3";
+export declare const reactNativeWebV56Version = "~0.21.0";
+export declare const reactTestRendererV56Version = "^19.2.0";
 export declare const expoV55Version = "~55.0.26";
 export declare const expoV55SplashScreenVersion = "~55.0.21";
 export declare const expoV55StatusBarVersion = "~55.0.6";
 export declare const expoV55SystemUiVersion = "~55.0.18";
 export declare const expoV55CliVersion = "~55.0.11";
 export declare const babelPresetExpoV55Version = "~55.0.7";
+export declare const expoV55MetroVersion = "~55.0.0";
 export declare const expoV55MetroConfigVersion = "~55.0.8";
 export declare const expoV55MetroRuntimeVersion = "~55.0.11";
 export declare const jestExpoV55Version = "~55.0.18";
@@ -50,22 +68,23 @@ export declare const reactNativeV53Version = "0.79.3";
 export declare const metroV53Version = "~0.82.4";
 export declare const reactNativeWebV53Version = "~0.20.0";
 export declare const reactTestRendererV53Version = "^19.0.0";
-export declare const expoVersion = "~55.0.26";
-export declare const expoSplashScreenVersion = "~55.0.21";
-export declare const expoStatusBarVersion = "~55.0.6";
-export declare const expoSystemUiVersion = "~55.0.18";
-export declare const expoCliVersion = "~55.0.11";
-export declare const babelPresetExpoVersion = "~55.0.7";
-export declare const expoMetroConfigVersion = "~55.0.8";
-export declare const expoMetroRuntimeVersion = "~55.0.11";
-export declare const jestExpoVersion = "~55.0.18";
+export declare const expoVersion = "~56.0.0";
+export declare const expoSplashScreenVersion = "~56.0.10";
+export declare const expoStatusBarVersion = "~56.0.4";
+export declare const expoSystemUiVersion = "~56.0.5";
+export declare const expoCliVersion = "~56.1.14";
+export declare const babelPresetExpoVersion = "~56.0.14";
+export declare const expoMetroConfigVersion = "~56.0.13";
+export declare const expoMetroRuntimeVersion = "~56.0.14";
+export declare const jestExpoVersion = "~56.0.4";
 export declare const reactVersion = "^19.2.0";
 export declare const reactDomVersion = "^19.2.0";
 export declare const typesReactVersion = "^19.2.0";
-export declare const reactNativeVersion = "0.83.6";
-export declare const metroVersion = "~0.83.0";
+export declare const reactNativeVersion = "0.85.3";
+export declare const metroVersion = "~0.84.3";
 export declare const reactNativeWebVersion = "~0.21.0";
 export declare const reactNativeSvgTransformerVersion = "~1.5.1";
 export declare const reactNativeSvgVersion = "15.12.1";
 export declare const testingLibraryReactNativeVersion = "~13.2.0";
 export declare const babelRuntimeVersion = "~7.27.6";
+export declare const expoVectorIconsVersion = "~15.1.0";

package/dist/src/utils/versions.js

@@ -1,25 +1,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reactTestRendererV53Version = exports.reactNativeWebV53Version = exports.metroV53Version = exports.reactNativeV53Version = exports.typesReactV53Version = exports.reactDomV53Version = exports.reactV53Version = exports.jestExpoV53Version = exports.expoV53MetroRuntimeVersion = exports.expoV53MetroConfigVersion = exports.babelPresetExpoV53Version = exports.expoV53CliVersion = exports.expoV53SystemUiVersion = exports.expoV53StatusBarVersion = exports.expoV53SplashScreenVersion = exports.expoV53Version = exports.reactTestRendererV54Version = exports.reactNativeWebV54Version = exports.metroV54Version = exports.reactNativeV54Version = exports.typesReactV54Version = exports.reactDomV54Version = exports.reactV54Version = exports.jestExpoV54Version = exports.expoV54MetroRuntimeVersion = exports.expoV54MetroConfigVersion = exports.babelPresetExpoV54Version = exports.expoV54CliVersion = exports.expoV54SystemUiVersion = exports.expoV54StatusBarVersion = exports.expoV54SplashScreenVersion = exports.expoV54Version = exports.reactTestRendererV55Version = exports.reactNativeWebV55Version = exports.metroV55Version = exports.reactNativeV55Version = exports.typesReactV55Version = exports.reactDomV55Version = exports.reactV55Version = exports.jestExpoV55Version = exports.expoV55MetroRuntimeVersion = exports.expoV55MetroConfigVersion = exports.babelPresetExpoV55Version = exports.expoV55CliVersion = exports.expoV55SystemUiVersion = exports.expoV55StatusBarVersion = exports.expoV55SplashScreenVersion = exports.expoV55Version = exports.minSupportedExpoVersion = exports.nxVersion = void 0;
-exports.babelRuntimeVersion = exports.testingLibraryReactNativeVersion = exports.reactNativeSvgVersion = exports.reactNativeSvgTransformerVersion = exports.reactNativeWebVersion = exports.metroVersion = exports.reactNativeVersion = exports.typesReactVersion = exports.reactDomVersion = exports.reactVersion = exports.jestExpoVersion = exports.expoMetroRuntimeVersion = exports.expoMetroConfigVersion = exports.babelPresetExpoVersion = exports.expoCliVersion = exports.expoSystemUiVersion = exports.expoStatusBarVersion = exports.expoSplashScreenVersion = exports.expoVersion = void 0;
+exports.metroV54Version = exports.reactNativeV54Version = exports.typesReactV54Version = exports.reactDomV54Version = exports.reactV54Version = exports.jestExpoV54Version = exports.expoV54MetroRuntimeVersion = exports.expoV54MetroConfigVersion = exports.babelPresetExpoV54Version = exports.expoV54CliVersion = exports.expoV54SystemUiVersion = exports.expoV54StatusBarVersion = exports.expoV54SplashScreenVersion = exports.expoV54Version = exports.reactTestRendererV55Version = exports.reactNativeWebV55Version = exports.metroV55Version = exports.reactNativeV55Version = exports.typesReactV55Version = exports.reactDomV55Version = exports.reactV55Version = exports.jestExpoV55Version = exports.expoV55MetroRuntimeVersion = exports.expoV55MetroConfigVersion = exports.expoV55MetroVersion = exports.babelPresetExpoV55Version = exports.expoV55CliVersion = exports.expoV55SystemUiVersion = exports.expoV55StatusBarVersion = exports.expoV55SplashScreenVersion = exports.expoV55Version = exports.reactTestRendererV56Version = exports.reactNativeWebV56Version = exports.metroV56Version = exports.reactNativeV56Version = exports.typesReactV56Version = exports.reactDomV56Version = exports.reactV56Version = exports.jestExpoV56Version = exports.expoV56MetroRuntimeVersion = exports.expoV56MetroConfigVersion = exports.expoV56MetroVersion = exports.babelPresetExpoV56Version = exports.expoV56CliVersion = exports.expoV56SystemUiVersion = exports.expoV56StatusBarVersion = exports.expoV56SplashScreenVersion = exports.expoV56Version = exports.minSupportedExpoVersion = exports.nxVersion = void 0;
+exports.expoVectorIconsVersion = exports.babelRuntimeVersion = exports.testingLibraryReactNativeVersion = exports.reactNativeSvgVersion = exports.reactNativeSvgTransformerVersion = exports.reactNativeWebVersion = exports.metroVersion = exports.reactNativeVersion = exports.typesReactVersion = exports.reactDomVersion = exports.reactVersion = exports.jestExpoVersion = exports.expoMetroRuntimeVersion = exports.expoMetroConfigVersion = exports.babelPresetExpoVersion = exports.expoCliVersion = exports.expoSystemUiVersion = exports.expoStatusBarVersion = exports.expoSplashScreenVersion = exports.expoVersion = exports.reactTestRendererV53Version = exports.reactNativeWebV53Version = exports.metroV53Version = exports.reactNativeV53Version = exports.typesReactV53Version = exports.reactDomV53Version = exports.reactV53Version = exports.jestExpoV53Version = exports.expoV53MetroRuntimeVersion = exports.expoV53MetroConfigVersion = exports.babelPresetExpoV53Version = exports.expoV53CliVersion = exports.expoV53SystemUiVersion = exports.expoV53StatusBarVersion = exports.expoV53SplashScreenVersion = exports.expoV53Version = exports.reactTestRendererV54Version = exports.reactNativeWebV54Version = void 0;
 exports.assertSupportedExpoVersion = assertSupportedExpoVersion;
 const path_1 = require("path");
 const internal_1 = require("@nx/devkit/internal");
 exports.nxVersion = require((0, path_1.join)('@nx/expo', 'package.json')).version;
 // Lowest supported Expo SDK. Below this, generators throw via
 // assertSupportedExpoVersion. Expo Go only supports the latest SDK, but the
-// plugin keeps install lanes for the recent SDKs it has constants for (53–55).
+// plugin keeps install lanes for the recent SDKs it has constants for (53–56).
 exports.minSupportedExpoVersion = '53.0.0';
 function assertSupportedExpoVersion(tree) {
     (0, internal_1.assertSupportedPackageVersion)(tree, 'expo', exports.minSupportedExpoVersion);
 }
-// Expo v55 versions (default for new projects) — RN 0.83, React 19.2
+// Expo v56 versions (default for new projects) — RN 0.85, React 19.2
+exports.expoV56Version = '~56.0.0';
+exports.expoV56SplashScreenVersion = '~56.0.10';
+exports.expoV56StatusBarVersion = '~56.0.4';
+exports.expoV56SystemUiVersion = '~56.0.5';
+exports.expoV56CliVersion = '~56.1.14'; // @expo/cli
+exports.babelPresetExpoV56Version = '~56.0.14';
+exports.expoV56MetroVersion = '~56.0.0'; // @expo/metro (SDK 55+ Metro)
+exports.expoV56MetroConfigVersion = '~56.0.13'; // @expo/metro-config
+exports.expoV56MetroRuntimeVersion = '~56.0.14';
+exports.jestExpoV56Version = '~56.0.4';
+exports.reactV56Version = '^19.2.0';
+exports.reactDomV56Version = '^19.2.0';
+exports.typesReactV56Version = '^19.2.0';
+exports.reactNativeV56Version = '0.85.3';
+exports.metroV56Version = '~0.84.3';
+exports.reactNativeWebV56Version = '~0.21.0';
+exports.reactTestRendererV56Version = '^19.2.0';
+// Expo v55 versions (for existing workspaces) — RN 0.83, React 19.2
 exports.expoV55Version = '~55.0.26';
 exports.expoV55SplashScreenVersion = '~55.0.21';
 exports.expoV55StatusBarVersion = '~55.0.6';
 exports.expoV55SystemUiVersion = '~55.0.18';
 exports.expoV55CliVersion = '~55.0.11';
 exports.babelPresetExpoV55Version = '~55.0.7';
+exports.expoV55MetroVersion = '~55.0.0'; // @expo/metro (SDK 55+ Metro)
 exports.expoV55MetroConfigVersion = '~55.0.8';
 exports.expoV55MetroRuntimeVersion = '~55.0.11';
 exports.jestExpoV55Version = '~55.0.18';
@@ -64,24 +83,27 @@ exports.reactNativeV53Version = '0.79.3';
 exports.metroV53Version = '~0.82.4';
 exports.reactNativeWebV53Version = '~0.20.0';
 exports.reactTestRendererV53Version = '^19.0.0';
-// Default exports point to v55 (latest)
-exports.expoVersion = exports.expoV55Version;
-exports.expoSplashScreenVersion = exports.expoV55SplashScreenVersion;
-exports.expoStatusBarVersion = exports.expoV55StatusBarVersion;
-exports.expoSystemUiVersion = exports.expoV55SystemUiVersion;
-exports.expoCliVersion = exports.expoV55CliVersion;
-exports.babelPresetExpoVersion = exports.babelPresetExpoV55Version;
-exports.expoMetroConfigVersion = exports.expoV55MetroConfigVersion;
-exports.expoMetroRuntimeVersion = exports.expoV55MetroRuntimeVersion;
-exports.jestExpoVersion = exports.jestExpoV55Version;
-exports.reactVersion = exports.reactV55Version;
-exports.reactDomVersion = exports.reactDomV55Version;
-exports.typesReactVersion = exports.typesReactV55Version;
-exports.reactNativeVersion = exports.reactNativeV55Version;
-exports.metroVersion = exports.metroV55Version;
-exports.reactNativeWebVersion = exports.reactNativeWebV55Version;
+// Default exports point to v56 (latest)
+exports.expoVersion = exports.expoV56Version;
+exports.expoSplashScreenVersion = exports.expoV56SplashScreenVersion;
+exports.expoStatusBarVersion = exports.expoV56StatusBarVersion;
+exports.expoSystemUiVersion = exports.expoV56SystemUiVersion;
+exports.expoCliVersion = exports.expoV56CliVersion;
+exports.babelPresetExpoVersion = exports.babelPresetExpoV56Version;
+exports.expoMetroConfigVersion = exports.expoV56MetroConfigVersion;
+exports.expoMetroRuntimeVersion = exports.expoV56MetroRuntimeVersion;
+exports.jestExpoVersion = exports.jestExpoV56Version;
+exports.reactVersion = exports.reactV56Version;
+exports.reactDomVersion = exports.reactDomV56Version;
+exports.typesReactVersion = exports.typesReactV56Version;
+exports.reactNativeVersion = exports.reactNativeV56Version;
+exports.metroVersion = exports.metroV56Version;
+exports.reactNativeWebVersion = exports.reactNativeWebV56Version;
 // Shared versions (version-independent)
 exports.reactNativeSvgTransformerVersion = '~1.5.1';
 exports.reactNativeSvgVersion = '15.12.1';
 exports.testingLibraryReactNativeVersion = '~13.2.0';
 exports.babelRuntimeVersion = '~7.27.6';
+// jest-expo's preset maps `react-native-vector-icons` to `@expo/vector-icons`,
+// so it must be installed for the Jest preset to resolve.
+exports.expoVectorIconsVersion = '~15.1.0';

package/migrations.json

@@ -56,6 +56,34 @@
       "description": "Rename imports of `createNodesV2` from `@nx/expo/plugin` to the canonical `createNodes` export.",
       "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
       "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md"
+    },
+    "update-23-1-0-update-metro-config-for-expo-56": {
+      "version": "23.1.0-beta.1",
+      "cli": "nx",
+      "requires": {
+        "expo": ">= 56.0.0"
+      },
+      "description": "Update generated metro.config.js to use @expo/metro for Expo SDK 56",
+      "factory": "./dist/src/migrations/update-23-1-0/update-metro-config-for-expo-56",
+      "prompt": "./dist/src/migrations/update-23-1-0/ai-instructions-for-expo-56.md"
+    },
+    "update-23-1-0-replace-standalone-metro-for-expo-56": {
+      "version": "23.1.0-beta.1",
+      "cli": "nx",
+      "requires": {
+        "expo": ">= 56.0.0"
+      },
+      "description": "Replace standalone metro-config/metro-resolver with @expo/metro for Expo SDK 56",
+      "factory": "./dist/src/migrations/update-23-1-0/replace-standalone-metro-for-expo-56"
+    },
+    "update-23-1-0-update-jest-winter-runtime-for-expo-56": {
+      "version": "23.1.0-beta.1",
+      "cli": "nx",
+      "requires": {
+        "expo": ">= 56.0.0"
+      },
+      "description": "Update Jest test-setup for the Expo SDK 56 winter runtime",
+      "factory": "./dist/src/migrations/update-23-1-0/update-jest-winter-runtime-for-expo-56"
     }
   },
   "packageJsonUpdates": {
@@ -310,6 +338,94 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "23.1.0": {
+      "version": "23.1.0-beta.1",
+      "requires": {
+        "expo": ">=55.0.0 <56.0.0"
+      },
+      "packages": {
+        "expo": {
+          "version": "~56.0.0",
+          "alwaysAddToPackageJson": false
+        },
+        "expo-splash-screen": {
+          "version": "~56.0.10",
+          "alwaysAddToPackageJson": false
+        },
+        "expo-status-bar": {
+          "version": "~56.0.4",
+          "alwaysAddToPackageJson": false
+        },
+        "expo-system-ui": {
+          "version": "~56.0.5",
+          "alwaysAddToPackageJson": false
+        },
+        "@expo/cli": {
+          "version": "~56.1.14",
+          "alwaysAddToPackageJson": false
+        },
+        "babel-preset-expo": {
+          "version": "~56.0.14",
+          "alwaysAddToPackageJson": false
+        },
+        "react": {
+          "version": "^19.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "react-dom": {
+          "version": "^19.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@types/react": {
+          "version": "^19.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "react-native": {
+          "version": "0.85.3",
+          "alwaysAddToPackageJson": false
+        },
+        "react-native-web": {
+          "version": "~0.21.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@expo/metro": {
+          "version": "~56.0.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@expo/metro-config": {
+          "version": "~56.0.13",
+          "alwaysAddToPackageJson": false
+        },
+        "@expo/metro-runtime": {
+          "version": "~56.0.14",
+          "alwaysAddToPackageJson": false
+        },
+        "@expo/vector-icons": {
+          "version": "~15.1.0",
+          "alwaysAddToPackageJson": false
+        },
+        "react-native-svg-transformer": {
+          "version": "~1.5.1",
+          "alwaysAddToPackageJson": false
+        },
+        "react-native-svg": {
+          "version": "15.12.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@testing-library/react-native": {
+          "version": "~13.2.0",
+          "alwaysAddToPackageJson": false
+        },
+        "jest-expo": {
+          "version": "~56.0.4",
+          "alwaysAddToPackageJson": false
+        },
+        "@babel/runtime": {
+          "version": "~7.27.6",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/expo",
-  "version": "23.1.0-beta.2",
+  "version": "23.1.0-beta.3",
   "private": false,
   "description": "The Expo Plugin for Nx contains executors and generators for managing and developing an expo application within your workspace. For example, you can directly build for different target platforms as well as generate projects and publish your code.",
   "keywords": [
@@ -61,27 +61,37 @@
     "semver": "^7.6.3",
     "tsconfig-paths": "^4.1.2",
     "tslib": "^2.3.0",
-    "@nx/devkit": "23.1.0-beta.2",
-    "@nx/eslint": "23.1.0-beta.2",
-    "@nx/js": "23.1.0-beta.2",
-    "@nx/react": "23.1.0-beta.2"
+    "@nx/devkit": "23.1.0-beta.3",
+    "@nx/eslint": "23.1.0-beta.3",
+    "@nx/js": "23.1.0-beta.3",
+    "@nx/react": "23.1.0-beta.3"
   },
   "peerDependencies": {
     "expo": ">=53.0.0",
+    "@expo/metro": ">= 55.0.0",
     "metro-config": ">= 0.82.0",
     "metro-resolver": ">= 0.82.0"
   },
   "peerDependenciesMeta": {
     "expo": {
       "optional": true
+    },
+    "@expo/metro": {
+      "optional": true
+    },
+    "metro-config": {
+      "optional": true
+    },
+    "metro-resolver": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "nx": "23.1.0-beta.2"
+    "nx": "23.1.0-beta.3"
   },
   "optionalDependencies": {
-    "@nx/detox": "23.1.0-beta.2",
-    "@nx/rollup": "23.1.0-beta.2"
+    "@nx/detox": "23.1.0-beta.3",
+    "@nx/rollup": "23.1.0-beta.3"
   },
   "executors": "./executors.json",
   "ng-update": {