@expo/cli

Patch Changes

• Upgrade React Native to 0.88.0.

• Fixed npx expo run:ios and npx expo run:android crashing with ERR_IMPORT_ATTRIBUTE_MISSING when buildCacheProvider is set to eas.

• Drop legacy Node url usage in favor of URL

Patch Changes

• Update minimum required Expo Atlas version to 0.5.0

• Notify about changes to metro.config.{cjs,mjs,ts,cts,mts} and .config/metro.*, not just metro.config.js and metro.config.json.

• Update to @expo/metro@~58.0.0 (promoted to stable for SDK 58).

• [iOS] Added a preview experiments.swiftPackageManager app config setting; when enabled, expo prebuild sets up iOS with Swift Package Manager instead of CocoaPods, and expo run:ios no longer runs pod install.

• Improve error and log coverage in event logs and fix bundle progress, completion, and server lifecycle reporting.

• Bump to 2g@1.0.0 and provide process metadata, such as port for commands like expo start.

• Update to 2g@^1.0.1

• Add expo command:events and expo command:ps sub-commands and updated related help texts to reference these commands.

Patch Changes

• Load externalized modules from the project root during development for static/server rendering.

• Allow interfaces extending UnknownOutputParams to declare optional params, so an omitted query parameter can be typed as optional, e.g. interface MyParams extends UnknownOutputParams { id?: string }.

• [web] Add experimental granular bundle splitting for production exports with async routes.

• Use the streaming renderer for SSG output.

Patch Changes

• expo serve now refuses to start on development exports that include server code.

• Load .env files in the bundle's mode in expo export:embed instead of keeping values loaded by a parent Expo process.

• Fixed tsconfig path normalization, including absolute targets and ${configDir} expansion in extended configs.

• Add @expo/platforms and consume it across tooling.

• removed

  Remove legacy AssetRegistry virtual module in favor of public AssetRegistry API from React Native 0.87+.

Patch Changes

• Fix stack traces for errors thrown in API routes and server data loaders during expo start, which pointed into the server bundle or at the wrong source file.

• [Internal] Bootstrap React Native through react-native/setup-env instead of InitializeCore.

Patch Changes

• Prevent the internal set() object utility from writing to Object.prototype when a path contains __proto__, constructor, or prototype.

• Fix expo start exiting on Node before v22.14.0 when an API route calls console.log. Stack frames whose source map fails to load are printed without source mapping instead of throwing.

• Replace resolve-from with @expo/require-utils for expo/template.tgz resolution to allow for direct file resolution.

• Update @expo/code-signing-certificates to ^0.0.7.

• Bump node-forge to ^1.4.0.

Patch Changes

• Bump @expo/devcert to ^1.2.2, @expo/ws-tunnel to ^2.0.1, and @expo/xcpretty to ^4.4.6.

• Show the call stack of a thrown error in the terminal even when all of its frames are collapsed.

• Keep stack frames from node_modules when logging server rendering errors, so they are symbolicated instead of printed raw.

• Preserve bundled, external, and inline stylesheet order across static and server rendering.

• Fix createJsInspectorMiddleware's Content-Length header to reflect the UTF-8 byte length of the response, instead of its UTF-16 string length, which undersized the header for any inspector app metadata (e.g. a device name) containing non-ASCII characters.

• Bump semver to ^7.7.4.

Patch Changes

• Resolve Android resource names and drawable-* folders with @react-native/asset-utils, matching how React Native resolves embedded assets at runtime. Scales outside the standard set map to a drawable-<n>dpi folder instead of failing the export, and assets referenced through ?unstable_path= drop that prefix from their resource name.

• Resolve Expo Updates runtime version for the dev server in development mode.

• Resolve the legacy react-native/Libraries/Image/AssetRegistry import to the shared asset registry. React Native 0.87 removed this module, which broke libraries that still import it, such as @shopify/react-native-skia on web.

• Fix CorsMiddleware's local-hostname check to require a literal dot between IPv4 octets, instead of an unescaped regex wildcard that let non-loopback hostnames starting with 127 (e.g. 127a1b1c1) bypass the dev server's cross-origin request guard.

Minor Changes

• Emit {scheme}://?__expo_url={manifestUrl} development build launch URLs instead of the legacy {scheme}://expo-development-client/?url={manifestUrl} form.

  Add EXPO_NO_DEV_MENU=1 to append the reserved __expo_* params that keep the dev menu closed to Expo Go and development build launch URLs: the terminal URL, the QR code, /_expo/link, /_expo/open, expo start --ios/--android and expo run:*.

Patch Changes

• Use development for Xcode configurations with Debug in the name and production otherwise in expo run:ios.

• Use React Native's default debuggableVariants to pick the mode in expo run:android.

• Note in expo start --help that setting CI=1 turns off file watching and Fast Refresh, and how to run without the interactive UI instead.

• removed

  Remove EXPO_UNSTABLE_TUNNEL_V2 env flag, and instead make Expo Tunnels the default. --tunnel ngrok may be used to switch to the legacy tunnels.

Patch Changes

• Force-bump all packages, due to migration to changesets.

Breaking changes

• breaking

  web.output: 'server' now renders HTML pages on each request instead of prerendering them during export.

• breaking

  Remove the fallback resolver for packages importing themselves by name. Metro now resolves self-references natively, but, like Node.js, only for packages that declare exports.

New features

• Enable data loaders by default for static and server output

• Enable server rendering by default for web.output: "server"

• Add the apiRoutes config plugin option to support API routes with static rendering.

Bug fixes

• Fix cache pollution in production by inlined environment variable values with a vary-cache approach

Others

• Add VaryingCacheStore and embed expoCacheVary fingerprints into transform results so a cache output never holds on to stale values inline

Breaking changes

• breaking

  Bundle source maps served by expo start and written by expo export are now index maps, as Metro now always emits them.

New features

• Enable server middleware by default

Bug fixes

• Remove Expo Router compatibility checks for @react-navigation packages.

• Fix app names in prebuild templates: derive project identifiers from the raw name in XML and plists ('A & B' gave 'AampB' in plists but 'AB' elsewhere), and escape display names for Android resources and plists.

Others

• Bump to @expo/metro@58.0.0-rc.0 and metro@0.87.1

Breaking changes

• breaking

  Remove EXPO_ROUTER_DISABLE_NATIVE_TABS_MD. Uninstall expo-symbols to exclude Material Symbols support from Android apps.

• breaking

  Remove the EXPO_UNSTABLE_WEB_MODAL environment variable and its Expo Router module alias.

• breaking

  Use the Expo command mode to set NODE_ENV and load .env files.

• breaking

  Make browser-based login the default for expo login. Use --no-browser (or pass --username/--password) for username/password login. Non-interactive environments such as CI continue to use username/password login.

• breaking

  Raise minimum Node.js version to ^22.13.0

New features

• Add pageHeaders to exported routes manifests

• Apply pageHeaders when serving static exports with expo serve

• Create pageHeaders rules from loader-declared Cache-Control headers for SSG

• Emit relative asset URLs and bundleUrl in manifest responses conditionally

• Resolve hostUri, debuggerHost, and /_expo/link deep links from forwarded request addresses

• Preserve loader Cache-Control headers in development

• Use default loader Cache-Control header value of no-store for loader responses in development

• Use default Cache-Control header value of public, max-age=0, must-revalidate for SSG loader files and their pages

• Use default Cache-Control header value of no-store for SSR loader responses

• Add experiments.noxcturnalTransformWorker with native transformer experiment

Bug fixes

• Stop writing DOM component source maps into the app binary during expo export:embed, so Android release builds no longer ship www.bundle source maps with the original app source.

• Serve relative manifest URLs only when the client itself sends the RFC 7239 Forwarded header, so that proxied requests from clients without relative-URL support, like released Expo Go versions through the WS tunnel, keep absolute URLs.

• Fail when --private-key-path is passed without updates.codeSigningCertificate in the resolved app config, instead of ignoring the flag and continuing without signing.

• Show the Xcode build log path when run:ios fails.

• Fix iOS asset catalog scale-to-file pairing for assets with non-standard scales.

• [Internal] Fix LogStream.destroy() racing a pending write and dropping log data

• Ignore simulators reported by devicectl and support json version 5 on Xcode 27

• In non-interactive shells, automatically roll over to the next available port when default is busy, unless a specific port is specified with --port or RCT_METRO_PORT

• Ignore a whitespace-only REACT_NATIVE_PACKAGER_HOSTNAME instead of failing to start the dev server

• Fix opening web from the Terminal UI when the dev server was started without --web

• Ignore an invalid --port or an out-of-range RCT_METRO_PORT and start on the preferred port instead of prompting to use port null

• Resolve the signed-in username for partner provisioned actors so Expo Go can verify the account match

• Switch ManifestMiddleware to expo-server's response helpers to avoid cancellations being surfaced as exceptions

• Support npm@12's dictionary-based npm pack --json format

• Fix wirelessly connected iOS 16 and older devices being omitted from expo run:ios --device selection.

• Fix resolution of ESLint failing in expo lint after prerequisites check installs it

• Make Android tooling (avd and adb) handling safer, more reliable, and cancellable

• Serve one virtual Metro asset registry to every consumer on React Native 0.87 — Metro's generated asset modules, react-native/asset-registry and legacy @react-native/assets-registry imports, and React Native core's internal registry imports — so Metro-registered assets and React Native's <Image> share one registry instance.

• Depend on @react-native/js-polyfills directly for the web polyfills instead of the react-native/rn-get-polyfills subpath removed in React Native 0.87.

Others

• [Internal] Use @expo/env to read the EAS config mode and keep older EAS Build versions in production mode.

• Add sandbox detection to telemetry context

• [Internal] Remove the unreachable port fallbacks and increase consistency in port selection logic

• Add experimental tvos and macos autolinking gated by expriments.outOfTreePlatforms

• [Internal] Update logbox imports

• [Internal] Align find-up package.json search utilities

• Bump to dnssd-advertise@^1.1.6

• [Internal] Migrate structured event logging to the 2g package

• [Internal] Migrate an initial set of events to 2g

• [Internal] Resolve the dev server port once instead of re-deriving it, and read the URL environment variables outside the UrlCreator

• Update expo start --private-key-path help text

• Re-enable sextant QR code for Zed

• [Internal] Fix the flaky waitForActionAsync timeout test by driving it with fake timers instead of real time.

• Bump to multitars@1.0.2 to address symlink and unicode bugs

• [Internal] Move static HTML asset injection into getStaticContent().

• Prewarm Metro transform workers while waiting for the first development bundle request

• Discover .ts, .mts, and .cts ESLint configs as well when checking for prerequisites for ESLint

• Bump to @expo/metro@56.0.2 and metro@0.84.5

• [Internal] Align local annotations in the Metro integration with Metro's own types.

• [Internal] Import Expo's Metro type extensions from @expo/metro-config instead of relying on global type augmentations.

• Bump to @expo/metro@56.1.0 and metro@0.84.6

• Remove the unused confirm_account query param from the browser login URL.