expo-build-properties 56.0.13 → 56.0.15

package/CHANGELOG.md

@@ -10,6 +10,18 @@
 
 ### 💡 Others
 
+## 56.0.15 — 2026-05-26
+
+### 🐛 Bug fixes
+
+- Fix `useHermesV1` reference to document its current default of `true` (Hermes V1 is the default engine since SDK 56) and that disabling it requires `buildReactNativeFromSource`. ([#46211](https://github.com/expo/expo/pull/46211) by [@yaminyassin](https://github.com/yaminyassin))
+
+## 56.0.14 — 2026-05-23
+
+### 🐛 Bug fixes
+
+- [iOS] Default `ios.usePrecompiledModules` to `true` so the plugin matches the Podfile default (precompiled modules enabled) instead of silently disabling them. ([#46159](https://github.com/expo/expo/pull/46159) by [@vonovak](https://github.com/vonovak))
+
 ## 56.0.13 — 2026-05-21
 
 _This version does not introduce any user-facing changes._

package/build/ios.js

@@ -42,7 +42,7 @@ exports.withIosBuildProperties = createBuildPodfilePropsConfigPlugin([
     },
     {
         propName: 'EXPO_USE_PRECOMPILED_MODULES',
-        propValueGetter: (config) => (config.ios?.usePrecompiledModules ?? false).toString(),
+        propValueGetter: (config) => (config.ios?.usePrecompiledModules ?? true).toString(),
     },
 ], 'withIosBuildProperties');
 /** @deprecated use built-in `ios.deploymentTarget` property instead. */

package/build/pluginConfig.d.ts

@@ -23,12 +23,15 @@ export interface SharedBuildConfigFields {
      */
     reactNativeReleaseLevel?: 'stable' | 'canary' | 'experimental';
     /**
-     * Enable the experimental Hermes V1 engine.
+     * Enable Hermes V1 engine. Turning on will provide faster startup times, improved runtime
+     * performance, and reduced memory usage.
      *
-     * In React Native 0.83, using Hermes V1 requires building React Native from source.
-     * You must set `buildReactNativeFromSource` to `true` when enabling this option.
+     * Hermes V1 is the default JavaScript engine starting in React Native 0.84.
+     * Set this to `false` to use the legacy Hermes engine instead, which also
+     * requires setting `buildReactNativeFromSource` to `true`.
      *
-     * @default false
+     * @default true
+     * @see [Hermes V1 as Default](https://reactnative.dev/blog/2026/02/11/react-native-0.84#hermes-v1-as-default)
      */
     useHermesV1?: boolean;
 }
@@ -372,7 +375,7 @@ export interface PluginConfigTypeIos extends SharedBuildConfigFields {
      * When enabled, sets the `EXPO_USE_PRECOMPILED_MODULES` environment variable to `1`
      * during `pod install`, which causes matching modules to be linked as vendored frameworks.
      *
-     * @default false
+     * @default true
      */
     usePrecompiledModules?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-build-properties",
-  "version": "56.0.13",
+  "version": "56.0.15",
   "description": "Config plugin to customize native build properties on prebuild",
   "main": "build/withBuildProperties.js",
   "types": "build/withBuildProperties.d.ts",
@@ -35,13 +35,13 @@
   "devDependencies": {
     "@types/node": "^22.14.0",
     "@types/semver": "^7.0.0",
-    "expo": "56.0.3",
-    "expo-module-scripts": "56.0.2"
+    "expo-module-scripts": "56.0.2",
+    "expo": "56.0.5"
   },
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "125e8225bf36a4b9b2a159441d9ea724bcf1110f",
+  "gitHead": "f67a101bcbe56114e982184834b93da7bbed00af",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/src/ios.ts

@@ -47,7 +47,7 @@ export const withIosBuildProperties = createBuildPodfilePropsConfigPlugin<Plugin
     },
     {
       propName: 'EXPO_USE_PRECOMPILED_MODULES',
-      propValueGetter: (config) => (config.ios?.usePrecompiledModules ?? false).toString(),
+      propValueGetter: (config) => (config.ios?.usePrecompiledModules ?? true).toString(),
     },
   ],
   'withIosBuildProperties'

package/src/pluginConfig.ts

@@ -53,12 +53,15 @@ export interface SharedBuildConfigFields {
   reactNativeReleaseLevel?: 'stable' | 'canary' | 'experimental';
 
   /**
-   * Enable the experimental Hermes V1 engine.
+   * Enable Hermes V1 engine. Turning on will provide faster startup times, improved runtime
+   * performance, and reduced memory usage.
    *
-   * In React Native 0.83, using Hermes V1 requires building React Native from source.
-   * You must set `buildReactNativeFromSource` to `true` when enabling this option.
+   * Hermes V1 is the default JavaScript engine starting in React Native 0.84.
+   * Set this to `false` to use the legacy Hermes engine instead, which also
+   * requires setting `buildReactNativeFromSource` to `true`.
    *
-   * @default false
+   * @default true
+   * @see [Hermes V1 as Default](https://reactnative.dev/blog/2026/02/11/react-native-0.84#hermes-v1-as-default)
    */
   useHermesV1?: boolean;
 }
@@ -442,7 +445,7 @@ export interface PluginConfigTypeIos extends SharedBuildConfigFields {
    * When enabled, sets the `EXPO_USE_PRECOMPILED_MODULES` environment variable to `1`
    * during `pod install`, which causes matching modules to be linked as vendored frameworks.
    *
-   * @default false
+   * @default true
    */
   usePrecompiledModules?: boolean;
 }