@callstack/react-native-brownfield 5.0.1 → 5.1.0

package/CHANGELOG.md

@@ -0,0 +1,381 @@
+# @callstack/react-native-brownfield
+
+## 5.1.0
+
+### Minor Changes
+
+- [#450](https://github.com/callstack/react-native-brownfield/pull/450) [`4846a05`](https://github.com/callstack/react-native-brownfield/commit/4846a055eb06f8c8dea08b33d0bb0d1b2a2f2f86) Thanks [@borisyankov](https://github.com/borisyankov)! - Add `preloadBundle` to `startReactNative` on iOS. Without a preload, `startReactNative` only makes the factory, and React Native loads the JavaScript bundle when it creates the first React Native view. `startReactNative(launchOptions:preloadBundle:onBundleLoaded:)` moves that work to the app launch: the call starts the React Host, and React Native evaluates the bundle on the JavaScript thread, in parallel with the remainder of the app launch. On Android, `ReactNativeBrownfield.initialize` does the same operation. This shape of `startReactNative` also takes the launch options for the React Host.
+
+  `onBundleLoaded` now runs on the main thread, and not on the JavaScript thread. A callback that you add after React Native loaded the bundle runs in the next turn of the main run loop.
+
+### Patch Changes
+
+- [#381](https://github.com/callstack/react-native-brownfield/pull/381) [`b8e8da5`](https://github.com/callstack/react-native-brownfield/commit/b8e8da50fbf20058c5c2745981c7deb5cb33061a) Thanks [@alpharius-ck](https://github.com/alpharius-ck)! - e2e tests for android
+- Updated dependencies []:
+  - @callstack/brownfield-cli@5.1.0
+
+## 5.0.2
+
+### Patch Changes
+
+- [#449](https://github.com/callstack/react-native-brownfield/pull/449) [`83657e7`](https://github.com/callstack/react-native-brownfield/commit/83657e7c0d209161561bff39d6e043a154e350d0) Thanks [@hurali97](https://github.com/hurali97)! - Fix npm publishing by upgrading to Changesets v3 (Yarn rewrites `workspace:` ranges on publish) and correcting package `repository` metadata required for npm provenance.
+- Updated dependencies [[`83657e7`](https://github.com/callstack/react-native-brownfield/commit/83657e7c0d209161561bff39d6e043a154e350d0)]:
+  - @callstack/brownfield-cli@5.0.2
+
+## 5.0.1
+
+### Patch Changes
+
+- [#442](https://github.com/callstack/react-native-brownfield/pull/442) [`7898f8a`](https://github.com/callstack/react-native-brownfield/commit/7898f8a4921a725dd4143516a0d187f0605540c2) Thanks [@janicduplessis](https://github.com/janicduplessis)! - feat: allow extending the list of .so files kept out of the AAR
+
+  Adds a `reactBrownfield.ignoreEmbeddedLibs` option so a project can name additional native libraries that should not be embedded, next to the built-in `IGNORE_EMBEDDED_LIBS` list.
+
+- Updated dependencies []:
+  - @callstack/brownfield-cli@5.0.1
+
+## 5.0.0
+
+### Major Changes
+
+- [#424](https://github.com/callstack/react-native-brownfield/pull/424) [`af2b20c`](https://github.com/callstack/react-native-brownfield/commit/af2b20c8e921f702b4c2ce27bf82cd43cb82d068) Thanks [@hurali97](https://github.com/hurali97)! - feat: drop support for Expo SDK 55
+
+### Patch Changes
+
+- [#434](https://github.com/callstack/react-native-brownfield/pull/434) [`1183202`](https://github.com/callstack/react-native-brownfield/commit/118320245741d337bf9d6202eb27ee60cc7faa47) Thanks [@hurali97](https://github.com/hurali97)! - fix: dependabot alerts
+
+- Updated dependencies [[`1183202`](https://github.com/callstack/react-native-brownfield/commit/118320245741d337bf9d6202eb27ee60cc7faa47)]:
+  - @callstack/brownfield-cli@5.0.0
+
+## 4.3.0
+
+### Minor Changes
+
+- [#422](https://github.com/callstack/react-native-brownfield/pull/422) [`8894482`](https://github.com/callstack/react-native-brownfield/commit/8894482efb68d745dd1f8e7433b7a67d94440f0a) Thanks [@hurali97](https://github.com/hurali97)! - feat: support proguard/R8 minification
+
+### Patch Changes
+
+- Updated dependencies [[`627fcbc`](https://github.com/callstack/react-native-brownfield/commit/627fcbce9811ca12773b3caee319ed4cd610123e), [`8894482`](https://github.com/callstack/react-native-brownfield/commit/8894482efb68d745dd1f8e7433b7a67d94440f0a)]:
+  - @callstack/brownfield-cli@4.3.0
+
+## 4.2.0
+
+### Minor Changes
+
+- [#413](https://github.com/callstack/react-native-brownfield/pull/413) [`39cf6a7`](https://github.com/callstack/react-native-brownfield/commit/39cf6a751c62ee701c96468a5a701c0bdf96463b) Thanks [@hurali97](https://github.com/hurali97)! - feat: add option to use local maven
+
+### Patch Changes
+
+- Updated dependencies [[`39cf6a7`](https://github.com/callstack/react-native-brownfield/commit/39cf6a751c62ee701c96468a5a701c0bdf96463b)]:
+  - @callstack/brownfield-cli@4.2.0
+
+## 4.1.0
+
+### Minor Changes
+
+- [#367](https://github.com/callstack/react-native-brownfield/pull/367) [`dd1082a`](https://github.com/callstack/react-native-brownfield/commit/dd1082a42c83f2cb8fd7f03df05a6e0a13e8833c) Thanks [@hurali97](https://github.com/hurali97)! - refactor: remove deprecated APIs
+
+### Patch Changes
+
+- [#417](https://github.com/callstack/react-native-brownfield/pull/417) [`28b534e`](https://github.com/callstack/react-native-brownfield/commit/28b534ea3f1bfd298b89049a6733eb23b9f7d9fc) Thanks [@hurali97](https://github.com/hurali97)! - fix: merge classes to contain third party libs classes
+
+- Updated dependencies [[`dd1082a`](https://github.com/callstack/react-native-brownfield/commit/dd1082a42c83f2cb8fd7f03df05a6e0a13e8833c)]:
+  - @callstack/brownfield-cli@4.1.0
+
+## 4.0.0
+
+### Major Changes
+
+- [#407](https://github.com/callstack/react-native-brownfield/pull/407) [`dee9559`](https://github.com/callstack/react-native-brownfield/commit/dee9559d6a1a1169c0824542ec8d2ea5ef6475e7) Thanks [@hurali97](https://github.com/hurali97)! - feat: drop support for expo sdk 54
+
+### Patch Changes
+
+- [#414](https://github.com/callstack/react-native-brownfield/pull/414) [`803f8ca`](https://github.com/callstack/react-native-brownfield/commit/803f8ca488515d7589d3b36e4ebb57d77df1d43d) Thanks [@artus9033](https://github.com/artus9033)! - fix: duplicated JNI libs on cold publish
+
+- Updated dependencies [[`dee9559`](https://github.com/callstack/react-native-brownfield/commit/dee9559d6a1a1169c0824542ec8d2ea5ef6475e7)]:
+  - @callstack/brownfield-cli@4.0.0
+
+## 3.15.0
+
+### Minor Changes
+
+- [#410](https://github.com/callstack/react-native-brownfield/pull/410) [`03c2496`](https://github.com/callstack/react-native-brownfield/commit/03c2496989fdafdc0863a97f01df9b7f5cd78a55) Thanks [@hurali97](https://github.com/hurali97)! - bump brownfield-gradle-plugin
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @callstack/brownfield-cli@3.15.0
+
+## 3.14.0
+
+### Minor Changes
+
+- [#360](https://github.com/callstack/react-native-brownfield/pull/360) [`10ff597`](https://github.com/callstack/react-native-brownfield/commit/10ff597c057c04aa093b4e5ae8c5334b169d3d56) Thanks [@adamTrz](https://github.com/adamTrz)! - Expo SDK 56 support
+
+### Patch Changes
+
+- Updated dependencies [[`10ff597`](https://github.com/callstack/react-native-brownfield/commit/10ff597c057c04aa093b4e5ae8c5334b169d3d56)]:
+  - @callstack/brownfield-cli@3.14.0
+
+## 3.13.2
+
+### Patch Changes
+
+- [#401](https://github.com/callstack/react-native-brownfield/pull/401) [`c4410f6`](https://github.com/callstack/react-native-brownfield/commit/c4410f6af4c781cf3513ba55d03fa1b1055a443b) Thanks [@artus9033](https://github.com/artus9033)! - fix: brownfield Gradle Plugin not to depend on \*UpdatesResources task from expo-updates if it is absent
+
+- [#398](https://github.com/callstack/react-native-brownfield/pull/398) [`8e90842`](https://github.com/callstack/react-native-brownfield/commit/8e90842291348dcb0542a6787f5cfbb1017532dd) Thanks [@artus9033](https://github.com/artus9033)! - feat: support brownfield unified config file in Expo
+
+- [#402](https://github.com/callstack/react-native-brownfield/pull/402) [`3475c3d`](https://github.com/callstack/react-native-brownfield/commit/3475c3db375988ebd63ce01bfd93f4dbb1a55e8d) Thanks [@artus9033](https://github.com/artus9033)! - feat: support local BGP in Expo config plugin
+
+- Updated dependencies [[`8e90842`](https://github.com/callstack/react-native-brownfield/commit/8e90842291348dcb0542a6787f5cfbb1017532dd), [`3475c3d`](https://github.com/callstack/react-native-brownfield/commit/3475c3db375988ebd63ce01bfd93f4dbb1a55e8d), [`4088c01`](https://github.com/callstack/react-native-brownfield/commit/4088c01a069306565dd3e279d9132f5dbe861d0b)]:
+  - @callstack/brownfield-cli@3.13.2
+
+## 3.13.1
+
+### Patch Changes
+
+- Updated dependencies [[`89bc23c`](https://github.com/callstack/react-native-brownfield/commit/89bc23c00bb85c036fce6d4ea142fb3ba0846deb)]:
+  - @callstack/brownfield-cli@3.13.1
+
+## 3.13.0
+
+### Minor Changes
+
+- [#359](https://github.com/callstack/react-native-brownfield/pull/359) [`533569b`](https://github.com/callstack/react-native-brownfield/commit/533569b59a4981669dfb738295b505343623bc32) Thanks [@MrMuzyk](https://github.com/MrMuzyk)! - Expose the Brownfield Android Gradle Plugin source from the npm package for opt-in local patching.
+
+- [#339](https://github.com/callstack/react-native-brownfield/pull/339) [`ef835b5`](https://github.com/callstack/react-native-brownfield/commit/ef835b52a130e4cd8770a2db04402cbb066b9c27) Thanks [@Esemesek](https://github.com/Esemesek)! - Added configuration file support for react-native-brownfield packages.
+
+### Patch Changes
+
+- [#391](https://github.com/callstack/react-native-brownfield/pull/391) [`95dbb43`](https://github.com/callstack/react-native-brownfield/commit/95dbb434d4c526b8f75bfd4c54b1d023e349ccf4) Thanks [@adamTrz](https://github.com/adamTrz)! - Fix Expo iOS framework debug bundle packaging so Debug builds load from Metro when it is available and fall back to embedded bundles without dev-server-only runtime code.
+
+- Updated dependencies [[`ef835b5`](https://github.com/callstack/react-native-brownfield/commit/ef835b52a130e4cd8770a2db04402cbb066b9c27)]:
+  - @callstack/brownfield-cli@3.13.0
+
+## 3.12.0
+
+### Minor Changes
+
+- [#237](https://github.com/callstack/react-native-brownfield/pull/237) [`4186cc8`](https://github.com/callstack/react-native-brownfield/commit/4186cc8e2ed2fa7aa41e84cdba7a23f7035ee08d) Thanks [@hurali97](https://github.com/hurali97)! - Bump brownfield-gradle-plugin
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @callstack/brownfield-cli@3.12.0
+
+## 3.11.0
+
+### Minor Changes
+
+- [#317](https://github.com/callstack/react-native-brownfield/pull/317) [`c04301b`](https://github.com/callstack/react-native-brownfield/commit/c04301b79d288ab108aaa44d7c79dd876b8405e9) Thanks [@adamTrz](https://github.com/adamTrz)! - Add an opt-in iOS Debug mode for loading the embedded JavaScript bundle with `preferEmbeddedBundleInDebug`, fix `bundleURLOverride` fallback behavior when the override returns `nil`, and add native bundle-resolution tests.
+
+### Patch Changes
+
+- [#361](https://github.com/callstack/react-native-brownfield/pull/361) [`aa14eb2`](https://github.com/callstack/react-native-brownfield/commit/aa14eb26e26ea1e6075b91027237e4b41b932b57) Thanks [@hurali97](https://github.com/hurali97)! - make EXUpdates as a dependency only when installed
+
+- [#347](https://github.com/callstack/react-native-brownfield/pull/347) [`c19a81b`](https://github.com/callstack/react-native-brownfield/commit/c19a81b7502cc458d742ab947186591bb69cb261) Thanks [@marcinszalski-callstack](https://github.com/marcinszalski-callstack)! - fix: fix method to deallocate reactNativeFactory instance for expo
+
+- Updated dependencies [[`3715ac7`](https://github.com/callstack/react-native-brownfield/commit/3715ac7783000756ef1c66ecfe24a85c5e43abab), [`05c557d`](https://github.com/callstack/react-native-brownfield/commit/05c557da9e2b6fca02e6e1a0b0fe71a909bab15f)]:
+  - @callstack/brownfield-cli@3.11.0
+
+## 3.10.0
+
+### Patch Changes
+
+- [#323](https://github.com/callstack/react-native-brownfield/pull/323) [`3456d3a`](https://github.com/callstack/react-native-brownfield/commit/3456d3aded18002475def4b79889979e76e1db5e) Thanks [@artus9033](https://github.com/artus9033)! - Force `BUILD_LIBRARY_FOR_DISTRIBUTION` / `SWIFT_EMIT_MODULE_INTERFACE` on the CocoaPods ReactBrownfield, Brownie and BrownfieldNavigation targets so Release builds emit `.swiftinterface` files and `xcodebuild -create-xcframework` (brownfield `package:ios`) can merge slices.
+
+- Updated dependencies [[`3456d3a`](https://github.com/callstack/react-native-brownfield/commit/3456d3aded18002475def4b79889979e76e1db5e)]:
+  - @callstack/brownfield-cli@3.10.0
+
+## 3.9.0
+
+### Minor Changes
+
+- [#326](https://github.com/callstack/react-native-brownfield/pull/326) [`80e6364`](https://github.com/callstack/react-native-brownfield/commit/80e6364d405d216b3e84a6297dfe346d2f01444b) Thanks [@artus9033](https://github.com/artus9033)! - feat: strip SO files by default, deprecate experimental option in favor of useStrippedSoFiles
+
+### Patch Changes
+
+- Updated dependencies [[`80e6364`](https://github.com/callstack/react-native-brownfield/commit/80e6364d405d216b3e84a6297dfe346d2f01444b)]:
+  - @callstack/brownfield-cli@3.9.0
+
+## 3.8.1
+
+### Patch Changes
+
+- Updated dependencies [[`e78084d`](https://github.com/callstack/react-native-brownfield/commit/e78084d227a49d39d726b8c778bd56045634678d)]:
+  - @callstack/brownfield-cli@3.8.1
+
+## 3.8.0
+
+### Minor Changes
+
+- [#295](https://github.com/callstack/react-native-brownfield/pull/295) [`d93dcd9`](https://github.com/callstack/react-native-brownfield/commit/d93dcd96e3b90517d718cd42b2cc773fb9795eac) Thanks [@hurali97](https://github.com/hurali97)! - add expo updates support
+
+### Patch Changes
+
+- Updated dependencies [[`d93dcd9`](https://github.com/callstack/react-native-brownfield/commit/d93dcd96e3b90517d718cd42b2cc773fb9795eac)]:
+  - @callstack/brownfield-cli@3.8.0
+
+## 3.7.0
+
+### Patch Changes
+
+- [#315](https://github.com/callstack/react-native-brownfield/pull/315) [`874332b`](https://github.com/callstack/react-native-brownfield/commit/874332b8a4cc58e945adad64cbaebfbe4d6cae88) Thanks [@marcinszalski-callstack](https://github.com/marcinszalski-callstack)! - fix: make sure native libs are loaded for RN >= 0.80
+
+- [#322](https://github.com/callstack/react-native-brownfield/pull/322) [`cbc99cf`](https://github.com/callstack/react-native-brownfield/commit/cbc99cf2bbbb8ba351a2bde3c839dd1b5dcf302b) Thanks [@marcinszalski-callstack](https://github.com/marcinszalski-callstack)! - fix: make sure android libs are loaded for expo apps
+
+- Updated dependencies [[`c153378`](https://github.com/callstack/react-native-brownfield/commit/c1533783c0a93372b3c12f08c1428766c0405226)]:
+  - @callstack/brownfield-cli@3.7.0
+
+## 3.6.1
+
+### Patch Changes
+
+- [#305](https://github.com/callstack/react-native-brownfield/pull/305) [`eab53d9`](https://github.com/callstack/react-native-brownfield/commit/eab53d9f7b93f38e13185020fcf8a7af23df0d05) Thanks [@hurali97](https://github.com/hurali97)! - fix securiy vulnerabilities
+
+- Updated dependencies [[`eab53d9`](https://github.com/callstack/react-native-brownfield/commit/eab53d9f7b93f38e13185020fcf8a7af23df0d05)]:
+  - @callstack/brownfield-cli@3.6.1
+
+## 3.6.0
+
+### Minor Changes
+
+- [#301](https://github.com/callstack/react-native-brownfield/pull/301) [`c8816e9`](https://github.com/callstack/react-native-brownfield/commit/c8816e9418a472e0e8a388db105121381243e496) Thanks [@marcinszalski-callstack](https://github.com/marcinszalski-callstack)! - feat: add method to deallocate reactNativeFactory instance
+
+### Patch Changes
+
+- Updated dependencies [[`5ac357b`](https://github.com/callstack/react-native-brownfield/commit/5ac357bb8802ecf3562d92be191f6681ae94a055)]:
+  - @callstack/brownfield-cli@3.6.0
+
+## 3.5.1
+
+### Patch Changes
+
+- [#288](https://github.com/callstack/react-native-brownfield/pull/288) [`096cc3b`](https://github.com/callstack/react-native-brownfield/commit/096cc3bbf580d9bf22374fa8b67021d2f29e211c) Thanks [@marcinszalski-callstack](https://github.com/marcinszalski-callstack)! - fix: restore back-button propagation from native to RN
+
+- Updated dependencies []:
+  - @callstack/brownfield-cli@3.5.1
+
+## 3.5.0
+
+### Minor Changes
+
+- [#257](https://github.com/callstack/react-native-brownfield/pull/257) [`d0e6203`](https://github.com/callstack/react-native-brownfield/commit/d0e62039c8a080c648abbbeace047e72fadce28b) Thanks [@hurali97](https://github.com/hurali97)! - add brownie android
+
+### Patch Changes
+
+- Updated dependencies [[`d0e6203`](https://github.com/callstack/react-native-brownfield/commit/d0e62039c8a080c648abbbeace047e72fadce28b)]:
+  - @callstack/brownfield-cli@3.5.0
+
+## 3.4.0
+
+### Minor Changes
+
+- [#268](https://github.com/callstack/react-native-brownfield/pull/268) [`e174e50`](https://github.com/callstack/react-native-brownfield/commit/e174e5018593f689f950b17241c528f53fb71500) Thanks [@artus9033](https://github.com/artus9033)! - feat: support linking in Expo and vanilla
+
+### Patch Changes
+
+- [#246](https://github.com/callstack/react-native-brownfield/pull/246) [`5484065`](https://github.com/callstack/react-native-brownfield/commit/5484065da9dc86a420af2be692fcdefa32fbb2af) Thanks [@artus9033](https://github.com/artus9033)! - chore: upgrade dependencies
+
+- [#275](https://github.com/callstack/react-native-brownfield/pull/275) [`dd8b8a0`](https://github.com/callstack/react-native-brownfield/commit/dd8b8a0b532fe779c1f2ce018577ad748b887ee0) Thanks [@artus9033](https://github.com/artus9033)! - fix: support custom app project name in Gradle plugin via extension's appProjectName config field
+
+- [#275](https://github.com/callstack/react-native-brownfield/pull/275) [`dd8b8a0`](https://github.com/callstack/react-native-brownfield/commit/dd8b8a0b532fe779c1f2ce018577ad748b887ee0) Thanks [@artus9033](https://github.com/artus9033)! - chore: bump up Gradle plugin version
+
+- [#246](https://github.com/callstack/react-native-brownfield/pull/246) [`5484065`](https://github.com/callstack/react-native-brownfield/commit/5484065da9dc86a420af2be692fcdefa32fbb2af) Thanks [@artus9033](https://github.com/artus9033)! - chore: upgrade dependencies
+
+- Updated dependencies [[`5484065`](https://github.com/callstack/react-native-brownfield/commit/5484065da9dc86a420af2be692fcdefa32fbb2af), [`dd8b8a0`](https://github.com/callstack/react-native-brownfield/commit/dd8b8a0b532fe779c1f2ce018577ad748b887ee0), [`54ab7ab`](https://github.com/callstack/react-native-brownfield/commit/54ab7ab01bd6f95439cc8b702d4124552e22ad55), [`5484065`](https://github.com/callstack/react-native-brownfield/commit/5484065da9dc86a420af2be692fcdefa32fbb2af)]:
+  - @callstack/brownfield-cli@3.4.0
+
+## 3.3.0
+
+### Minor Changes
+
+- [#248](https://github.com/callstack/react-native-brownfield/pull/248) [`b0a6f41`](https://github.com/callstack/react-native-brownfield/commit/b0a6f4185aad4e8759b90ccaf9867be493a979ec) Thanks [@artus9033](https://github.com/artus9033)! - feat: support Expo 55
+
+### Patch Changes
+
+- Updated dependencies [[`b0a6f41`](https://github.com/callstack/react-native-brownfield/commit/b0a6f4185aad4e8759b90ccaf9867be493a979ec)]:
+  - @callstack/brownfield-cli@3.3.0
+
+## 3.2.1
+
+### Patch Changes
+
+- [#265](https://github.com/callstack/react-native-brownfield/pull/265) [`7e114e6`](https://github.com/callstack/react-native-brownfield/commit/7e114e676fc290a54912b4d99bd22952b2f7380d) Thanks [@hurali97](https://github.com/hurali97)! - version bump
+
+- Updated dependencies [[`7e114e6`](https://github.com/callstack/react-native-brownfield/commit/7e114e676fc290a54912b4d99bd22952b2f7380d)]:
+  - @callstack/brownfield-cli@3.2.1
+
+## 3.2.0
+
+### Minor Changes
+
+- [#263](https://github.com/callstack/react-native-brownfield/pull/263) [`b7dfa7e`](https://github.com/callstack/react-native-brownfield/commit/b7dfa7e30e1a921bb7ac0952e23481ee081fb9ed) Thanks [@hurali97](https://github.com/hurali97)! - version bump for release
+
+### Patch Changes
+
+- Updated dependencies [[`b7dfa7e`](https://github.com/callstack/react-native-brownfield/commit/b7dfa7e30e1a921bb7ac0952e23481ee081fb9ed)]:
+  - @callstack/brownfield-cli@3.2.0
+
+## 3.1.0
+
+### Minor Changes
+
+- [#252](https://github.com/callstack/react-native-brownfield/pull/252) [`d5c8609`](https://github.com/callstack/react-native-brownfield/commit/d5c8609485b072eb73be0158d49908fa399d8950) Thanks [@artus9033](https://github.com/artus9033)! - feat: added postMessage API
+
+- [#236](https://github.com/callstack/react-native-brownfield/pull/236) [`3e33b89`](https://github.com/callstack/react-native-brownfield/commit/3e33b890e6f647f6bbebe32f8068a38b1ed85ea0) Thanks [@hurali97](https://github.com/hurali97)! - add brownfield navigation
+
+### Patch Changes
+
+- Updated dependencies [[`3e33b89`](https://github.com/callstack/react-native-brownfield/commit/3e33b890e6f647f6bbebe32f8068a38b1ed85ea0)]:
+  - @callstack/brownfield-cli@3.1.0
+
+## 3.0.0
+
+### Patch Changes
+
+- [#255](https://github.com/callstack/react-native-brownfield/pull/255) [`48358b2`](https://github.com/callstack/react-native-brownfield/commit/48358b2dcce578aa5052e66cc3454524da8c7992) Thanks [@artus9033](https://github.com/artus9033)! - chore: release stable v3
+
+- [#239](https://github.com/callstack/react-native-brownfield/pull/239) [`828bda3`](https://github.com/callstack/react-native-brownfield/commit/828bda32f39153085f5053becc7e9de16d284be5) Thanks [@hurali97](https://github.com/hurali97)! - fix: autodetect iOS app target name for Expo pre-55 patch script phase
+
+- Updated dependencies [[`48358b2`](https://github.com/callstack/react-native-brownfield/commit/48358b2dcce578aa5052e66cc3454524da8c7992)]:
+  - @callstack/brownfield-cli@3.0.0
+
+## 2.2.0
+
+### Minor Changes
+
+- [#212](https://github.com/callstack/react-native-brownfield/pull/212) [`4728945`](https://github.com/callstack/react-native-brownfield/commit/47289457b9bdbe50cf3c65a78c7f1d9d555dca9c) Thanks [@gronxb](https://github.com/gronxb)! - feat(ios): add bundleURL provider for dynamic bundle loading
+
+### Patch Changes
+
+- [#216](https://github.com/callstack/react-native-brownfield/pull/216) [`8ce3ea1`](https://github.com/callstack/react-native-brownfield/commit/8ce3ea10e0719adac7396dea8f171753e901b31d) Thanks [@thymikee](https://github.com/thymikee)! - chore: remove release-it
+
+- Updated dependencies [[`8ce3ea1`](https://github.com/callstack/react-native-brownfield/commit/8ce3ea10e0719adac7396dea8f171753e901b31d)]:
+  - @callstack/brownfield-cli@1.0.4
+
+## 2.1.1
+
+### Patch Changes
+
+- Updated dependencies [[`2347775`](https://github.com/callstack/react-native-brownfield/commit/23477753b16ee189b82c1aee3eac98a56c79f52a)]:
+  - @callstack/brownfield-cli@1.0.3
+
+## 2.1.0
+
+### Minor Changes
+
+- [#207](https://github.com/callstack/react-native-brownfield/pull/207) [`feb7ed2`](https://github.com/callstack/react-native-brownfield/commit/feb7ed2e821112576ec89d6eb17e8ea411aeaa02) Thanks [@artus9033](https://github.com/artus9033)! - feat(android): allow bundle file path
+
+### Patch Changes
+
+- Updated dependencies [[`2a8563f`](https://github.com/callstack/react-native-brownfield/commit/2a8563f65ed152054ad1290caf963791a368ee9a)]:
+  - @callstack/brownfield-cli@1.0.2
+
+## 2.0.2
+
+### Patch Changes
+
+- [#198](https://github.com/callstack/react-native-brownfield/pull/198) [`c8c903d`](https://github.com/callstack/react-native-brownfield/commit/c8c903d0d2b78a8c06a41213dfbe781a2daf3d25) Thanks [@artus9033](https://github.com/artus9033)! - docs: added README files to all packages
+
+- Updated dependencies [[`c8c903d`](https://github.com/callstack/react-native-brownfield/commit/c8c903d0d2b78a8c06a41213dfbe781a2daf3d25)]:
+  - @callstack/brownfield-cli@1.0.1

package/android/src/main/java/com/callstack/reactnativebrownfield/ReactNativeBrownfield.kt

@@ -65,6 +65,8 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
             if (!initialized.getAndSet(true)) {
                 loadNativeLibs(application)
                 installAndPreload(reactHost, onJSBundleLoaded)
+            } else {
+                invokeWhenJSBundleLoaded(onJSBundleLoaded)
             }
         }
 
@@ -77,6 +79,8 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
             if (!initialized.getAndSet(true)) {
                 loadNativeLibs(application)
                 installAndPreload(reactHostFactory(), onJSBundleLoaded)
+            } else {
+                invokeWhenJSBundleLoaded(onJSBundleLoaded)
             }
         }
         
@@ -102,6 +106,8 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
                     jsRuntimeFactory = null
                 )
                 installAndPreload(reactHost, onJSBundleLoaded)
+            } else {
+                invokeWhenJSBundleLoaded(onJSBundleLoaded)
             }
         }
 
@@ -134,6 +140,25 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
                 onJSBundleLoaded?.invoke(true)
             }
         }
+
+        private fun invokeWhenJSBundleLoaded(onJSBundleLoaded: OnJSBundleLoaded?) {
+            if (onJSBundleLoaded == null || !::instance.isInitialized) {
+                return
+            }
+
+            val reactHost = instance.reactHost
+            reactHost.currentReactContext?.let {
+                onJSBundleLoaded.invoke(true)
+                return
+            }
+
+            reactHost.addReactInstanceEventListener(object : ReactInstanceEventListener {
+                override fun onReactContextInitialized(context: ReactContext) {
+                    onJSBundleLoaded.invoke(true)
+                    reactHost.removeReactInstanceEventListener(this)
+                }
+            })
+        }
     }
 
     /**

package/android/src/main/java/com/callstack/reactnativebrownfield/ReactNativeFragment.kt

@@ -69,6 +69,26 @@ class ReactNativeFragment : ReactFragment(), PermissionAwareActivity {
         }
     }
 
+    override fun onPause() {
+        try {
+            super.onPause()
+        } catch (error: AssertionError) {
+            if (
+                error.message?.contains(
+                    "Pausing an activity that is not the current activity"
+                ) == true
+            ) {
+                Log.w(
+                    "ReactNativeFragment",
+                    "Ignoring stale onHostPause for ${activity?.javaClass?.simpleName}",
+                    error
+                )
+                return
+            }
+            throw error
+        }
+    }
+
     override fun onRequestPermissionsResult(
         requestCode: Int,
         permissions: Array<String>,

package/ios/BrownfieldReactHostPreloader.h

@@ -0,0 +1,30 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Creates and starts the React Host, but does not create a view. React Native loads and evaluates
+ * the JavaScript bundle immediately, and not when it mounts the first React Native view.
+ * `viewWithModuleName:` makes the same call internally, thus a view that you create later uses the
+ * host that is ready.
+ *
+ * This class is in Objective-C, because Swift cannot make this call:
+ * `RCTReactNativeFactory.devMenuConfiguration` is nullable, but the related parameter is not
+ * nullable.
+ */
+@interface BrownfieldReactHostPreloader : NSObject
+
+/**
+ * Call this method on the main thread. If a host is already available, this method does nothing.
+ *
+ * @param reactNativeFactory An `RCTReactNativeFactory`, or a subclass, for example
+ *   `ExpoReactNativeFactory`. The type is `id`, because this header must stay free of the React
+ *   Native imports.
+ * @param launchOptions The launch options for the React Host.
+ */
++ (void)preloadWithReactNativeFactory:(id)reactNativeFactory
+                        launchOptions:(nullable NSDictionary *)launchOptions;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/BrownfieldReactHostPreloader.m

@@ -0,0 +1,113 @@
+#import "BrownfieldReactHostPreloader.h"
+
+// This file is plain Objective-C, and not Objective-C++. The umbrella header of
+// React-RCTAppDelegate imports the Hermes and JSI headers if `__cplusplus` is set. This pod does
+// not have the necessary search paths for those headers. Without C++, the compiler ignores those
+// imports. The compiler then builds the module in the same way that Swift imports it.
+//
+// The name of the pod changes if the build makes it a framework. Thus you must try each possible
+// name. Expo uses the same method in `RCTAppDelegateUmbrella.h`.
+#if __has_include(<React_RCTAppDelegate/RCTRootViewFactory.h>)
+#import <React_RCTAppDelegate/RCTReactNativeFactory.h>
+#import <React_RCTAppDelegate/RCTRootViewFactory.h>
+#elif __has_include(<React-RCTAppDelegate/RCTRootViewFactory.h>)
+#import <React-RCTAppDelegate/RCTReactNativeFactory.h>
+#import <React-RCTAppDelegate/RCTRootViewFactory.h>
+#else
+#import <React/RCTReactNativeFactory.h>
+#import <React/RCTRootViewFactory.h>
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+// `RCTBundleConfiguration` first exists in React Native 0.84. React Native 0.83 does not declare
+// the class. This forward declaration lets the file name the type with both versions.
+@class RCTBundleConfiguration;
+
+/**
+ * The two shapes of `initializeReactHostWithLaunchOptions:...`. React Native 0.83 has the shape
+ * without `bundleConfiguration:`. React Native 0.84 added that parameter and removed the earlier
+ * shape. No header tells the two versions apart at compile time, thus this file declares both
+ * shapes and `respondsToSelector:` selects one at run time. The declarations are equal to the
+ * React Native declarations. The compiler then accepts the file with both versions.
+ */
+@protocol BrownfieldReactHostInitializing <NSObject>
+
+- (void)initializeReactHostWithLaunchOptions:(NSDictionary *__nullable)launchOptions
+                         bundleConfiguration:(RCTBundleConfiguration *)bundleConfiguration
+                        devMenuConfiguration:(RCTDevMenuConfiguration *)devMenuConfiguration;
+
+- (void)initializeReactHostWithLaunchOptions:(NSDictionary *__nullable)launchOptions
+                        devMenuConfiguration:(RCTDevMenuConfiguration *)devMenuConfiguration;
+
+@end
+
+/**
+ * `RCTReactNativeFactory.bundleConfiguration` also first exists in React Native 0.84.
+ */
+@protocol BrownfieldBundleConfigurationProviding <NSObject>
+
+@property (nonatomic, readonly) RCTBundleConfiguration *bundleConfiguration;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+@implementation BrownfieldReactHostPreloader
+
++ (void)preloadWithReactNativeFactory:(id)reactNativeFactory
+                        launchOptions:(NSDictionary *_Nullable)launchOptions
+{
+  RCTReactNativeFactory *factory = (RCTReactNativeFactory *)reactNativeFactory;
+  RCTRootViewFactory *rootViewFactory = factory.rootViewFactory;
+
+  // `initializeReactHostWithLaunchOptions:...` returns early if a view, or an earlier preload,
+  // created a host. Thus this method makes no other check. React Native declares
+  // `rootViewFactory` as not nullable, and this guard is only a protection.
+  if (rootViewFactory == nil) {
+    return;
+  }
+
+  id<BrownfieldReactHostInitializing> hostInitializer = (id)rootViewFactory;
+  SEL initializeWithBundleConfiguration =
+      @selector(initializeReactHostWithLaunchOptions:bundleConfiguration:devMenuConfiguration:);
+  SEL initializeWithDevMenuConfiguration =
+      @selector(initializeReactHostWithLaunchOptions:devMenuConfiguration:);
+
+  // Get the configurations from the factory. Do not make new configurations from the default
+  // values. The Expo runtime sends `RCTReactNativeFactory.devMenuConfiguration` from
+  // `ExpoReactNativeFactory.recreateRootView:`, thus the factory value keeps the two runtimes
+  // equal.
+  //
+  // The preloaded host is equal to a host that a view creates later, but the two paths send
+  // different objects. The bare runtime creates the view with
+  // `viewWithModuleName:initialProperties:launchOptions:`, and that method sends
+  // `[RCTBundleConfiguration defaultConfiguration]` and `[RCTDevMenuConfiguration
+  // defaultConfiguration]`. The values are equal:
+  //   - `RCTReactNativeFactory.bundleConfiguration` gives `[RCTBundleConfiguration
+  //     defaultConfiguration]` while nobody sets another value.
+  //   - `RCTReactNativeFactory.devMenuConfiguration` is nil by default.
+  //     `RCTDevMenuConfigurationDecorator` does nothing with nil, and `RCTDevMenu` and
+  //     `RCTDevSettings` keep their own default values. Those values are equal to
+  //     `[RCTDevMenuConfiguration defaultConfiguration]`, because the two sides read `RCT_DEV_MENU`.
+  if ([hostInitializer respondsToSelector:initializeWithBundleConfiguration]) {
+    id<BrownfieldBundleConfigurationProviding> configurationProvider = (id)factory;
+
+    [hostInitializer initializeReactHostWithLaunchOptions:launchOptions
+                                      bundleConfiguration:configurationProvider.bundleConfiguration
+                                     devMenuConfiguration:factory.devMenuConfiguration];
+  } else if ([hostInitializer respondsToSelector:initializeWithDevMenuConfiguration]) {
+    [hostInitializer initializeReactHostWithLaunchOptions:launchOptions
+                                     devMenuConfiguration:factory.devMenuConfiguration];
+  } else {
+    // A React Native version with a third shape of the method. Do not crash. The first React
+    // Native view creates the host, as without a preload.
+    NSLog(
+        @"%@",
+        @"ReactNativeBrownfield: startReactNative did not preload the JavaScript bundle, because "
+        @"this React Native version has no known initializeReactHostWithLaunchOptions: method. The "
+        @"first React Native view loads the bundle.");
+  }
+}
+
+@end

package/ios/Expo/ExpoHostRuntime.swift

@@ -11,7 +11,7 @@ internal import EXUpdates
 final class ExpoHostRuntime {
   static let shared = ExpoHostRuntime()
 
-  private let jsBundleLoadObserver = JSBundleLoadObserver()
+  let preloadState = ReactHostPreloadState()
   private var delegate = ExpoHostRuntimeDelegate()
   private var reactNativeFactory: RCTReactNativeFactory?
   private var expoDelegate: ExpoAppDelegate?
@@ -35,9 +35,15 @@ final class ExpoHostRuntime {
   /**
    * Starts React Native with optional callback when bundle is loaded.
    *
-   * @param onBundleLoaded Optional callback invoked after JS bundle is fully loaded.
+   * @param onBundleLoaded Optional callback invoked on the main thread after JS bundle is fully loaded.
    */
   public func startReactNative(onBundleLoaded: (() -> Void)?) {
+    // The callback registration is outside of the guard below. An earlier `startReactNative` call
+    // can already have made the factory, and the callback must still run.
+    if let onBundleLoaded {
+      preloadState.jsBundleLoadObserver.observe(onBundleLoaded: onBundleLoaded)
+    }
+
     guard reactNativeFactory == nil else { return }
 
     let appDelegate = ExpoAppDelegate()
@@ -50,10 +56,6 @@ final class ExpoHostRuntime {
     appDelegate.bindReactNativeFactory(reactNativeFactory)
     #endif
     expoDelegate = appDelegate
-
-    if let onBundleLoaded {
-      jsBundleLoadObserver.observeOnce(onBundleLoaded: onBundleLoaded)
-    }
   }
 
   /**
@@ -70,6 +72,7 @@ final class ExpoHostRuntime {
     }
     reactNativeFactory = nil
     expoDelegate = nil
+    preloadState.reset()
   }
 
   /**
@@ -169,6 +172,8 @@ final class ExpoHostRuntime {
     let bundleURL = delegate.bundleURL()
     configureDevLoadingView(with: bundleURL)
 
+    let resolvedLaunchOptions = preloadState.launchOptions(overriddenBy: launchOptions)
+
     // below: https://github.com/expo/expo/commit/2013760c46cde1404872d181a691da72fbf207a4
     // has moved the recreateRootView method to ExpoReactNativeFactory
     #if EXPO_SDK_GTE_55  // this define comes from the Brownfield Expo config plugin
@@ -176,19 +181,51 @@ final class ExpoHostRuntime {
       withBundleURL: bundleURL,
       moduleName: moduleName,
       initialProps: initialProps,
-      launchOptions: launchOptions
+      launchOptions: resolvedLaunchOptions
     )
     #else
     return expoDelegate?.recreateRootView(
       withBundleURL: bundleURL,
       moduleName: moduleName,
       initialProps: initialProps,
-      launchOptions: launchOptions
+      launchOptions: resolvedLaunchOptions
     )
     #endif
   }
 }
 
+extension ExpoHostRuntime: ReactHostPreloading {
+  var reactNativeFactoryForPreload: AnyObject? {
+    return reactNativeFactory
+  }
+
+  /**
+   * expo-dev-launcher finds the Metro URL only after the user selects an app in the launcher. This
+   * is a Debug behavior. In Release the class is in the binary, but it does nothing. Thus this
+   * check is also only in Debug.
+   *
+   * The check reads the class name, because this pod has no dependency on expo-dev-launcher.
+   * `EXDevLauncherController` is the name in expo-dev-launcher 56 and 57. If a later version
+   * changes the name, this method gives `true`, and a preload can keep a bundle of the launcher
+   * screen. Examine the name again when you add a new Expo SDK.
+   *
+   * `ExpoHostRuntimeDelegate.isBundleURLStable` covers the other conditions.
+   */
+  func canPreloadReactNative() -> Bool {
+    #if DEBUG
+    if NSClassFromString("EXDevLauncherController") != nil {
+      return false
+    }
+    #endif
+
+    return delegate.isBundleURLStable
+  }
+
+  func prepareDevLoadingView() {
+    configureDevLoadingView()
+  }
+}
+
 class ExpoHostRuntimeDelegate: ExpoReactNativeFactoryDelegate {
   var entryFile = ".expo/.virtual-metro-entry"
   var bundlePath = "main.jsbundle"
@@ -242,5 +279,30 @@ class ExpoHostRuntimeDelegate: ExpoReactNativeFactoryDelegate {
       return nil
     }
   }
+
+  /**
+   * `true` if `bundleURL()` gives now the same result as a later resolution. This property follows
+   * the steps of `bundleURL()`, and it must change together with them.
+   *
+   * The override wins over every other step, thus an override makes the URL stable.
+   *
+   * expo-updates selects the launch asset while `AppController` starts. `ReactNativeViewController`
+   * starts `AppController`. Before this operation is complete, `launchAssetUrl()` is nil, and
+   * `bundleURL()` gives the embedded bundle. A host from that time keeps the embedded bundle, and
+   * Expo never applies the update. Thus the URL is stable only after `launchAssetUrl()` has a
+   * value. The class can be in the binary while the app does not use it, thus this check reads the
+   * state and not the class.
+   */
+  var isBundleURLStable: Bool {
+    if bundleURLOverride?() != nil {
+      return true
+    }
+
+    #if canImport(EXUpdates) && !DEBUG
+    return AppController.isInitialized() && AppController.sharedInstance.launchAssetUrl() != nil
+    #else
+    return true
+    #endif
+  }
 }
 #endif

package/ios/JSBundleLoadObserver.swift

@@ -1,38 +1,85 @@
 import Foundation
-internal import React
 
+/**
+ * Watches the `RCTInstanceDidLoadBundle` notification, and calls the callback that waits for it.
+ *
+ * React Native sends the notification from the JavaScript thread. This class always calls the
+ * callback on the main thread, because the callback changes the user interface.
+ *
+ * The class starts to watch at the initialization, and not at the first callback. The class then
+ * knows that React Native loaded the bundle, also if nobody waited for the notification.
+ */
 final class JSBundleLoadObserver {
-  private var onBundleLoaded: (() -> Void)?
+  private var pendingCallback: (() -> Void)?
+  private var didLoadBundle = false
   private var observerToken: NSObjectProtocol?
 
-  func observeOnce(onBundleLoaded: @escaping () -> Void) {
-    removeObserverIfNeeded()
-    self.onBundleLoaded = onBundleLoaded
-
+  init() {
     observerToken = NotificationCenter.default.addObserver(
       forName: NSNotification.Name("RCTInstanceDidLoadBundle"),
       object: nil,
-      queue: nil
+      queue: .main
     ) { [weak self] _ in
-      self?.notifyAndClear()
+      self?.bundleDidLoad()
     }
   }
 
   deinit {
-    removeObserverIfNeeded()
+    if let observerToken {
+      NotificationCenter.default.removeObserver(observerToken)
+    }
+  }
+
+  /**
+   * Keeps one callback, and calls it one time. A new callback replaces the callback that waits. If
+   * React Native already loaded the bundle, the class calls the callback in the next turn of the
+   * main run loop.
+   *
+   * @param onBundleLoaded The class always calls this callback on the main thread.
+   */
+  func observe(onBundleLoaded: @escaping () -> Void) {
+    onMainThread { [weak self] in
+      self?.register(onBundleLoaded)
+    }
+  }
+
+  /**
+   * Removes the callback that waits, and forgets the bundle of the earlier session. Call this
+   * method when you stop React Native. A callback of the earlier session must not run in the next
+   * session.
+   */
+  func reset() {
+    onMainThread { [weak self] in
+      self?.pendingCallback = nil
+      self?.didLoadBundle = false
+    }
   }
 
-  private func notifyAndClear() {
-    let callback = onBundleLoaded
-    onBundleLoaded = nil
-    removeObserverIfNeeded()
+  // MARK: - Main thread only
+
+  private func register(_ onBundleLoaded: @escaping () -> Void) {
+    guard !didLoadBundle else {
+      DispatchQueue.main.async(execute: onBundleLoaded)
+      return
+    }
+
+    pendingCallback = onBundleLoaded
+  }
+
+  private func bundleDidLoad() {
+    didLoadBundle = true
+
+    let callback = pendingCallback
+    pendingCallback = nil
+
     callback?()
   }
 
-  private func removeObserverIfNeeded() {
-    if let observerToken {
-      NotificationCenter.default.removeObserver(observerToken)
-      self.observerToken = nil
+  private func onMainThread(_ work: @escaping () -> Void) {
+    if Thread.isMainThread {
+      work()
+    } else {
+      DispatchQueue.main.async(execute: work)
     }
   }
 }

package/ios/ReactHostPreloading.swift

@@ -0,0 +1,177 @@
+import Foundation
+
+/**
+ * The preload state that `startReactNative`, `view` and `stopReactNative` share.
+ */
+final class ReactHostPreloadState {
+  let jsBundleLoadObserver = JSBundleLoadObserver()
+
+  private let lock = NSLock()
+  private var storedLaunchOptions: [AnyHashable: Any]?
+  private var hasPreloadRequest = false
+
+  /**
+   * Keeps the launch options of a `startReactNative` call.
+   *
+   * `startReactNative` can move its preload work to the main thread. A view on the main thread can
+   * create the React Host before that. Thus this method must run at the call, and not after the
+   * change of thread. The view then finds the options.
+   */
+  func storeLaunchOptions(_ launchOptions: [AnyHashable: Any]?) {
+    guard let launchOptions else { return }
+
+    lock.lock()
+    defer { lock.unlock() }
+
+    storedLaunchOptions = launchOptions
+  }
+
+  /**
+   * Records that a `startReactNative` call must preload the bundle. `consumePreloadRequest` reads
+   * the request one time, and `reset` cancels it.
+   */
+  func requestPreload() {
+    lock.lock()
+    defer { lock.unlock() }
+
+    hasPreloadRequest = true
+  }
+
+  /**
+   * `true` if a preload request waits. The method also removes the request.
+   *
+   * `startReactNative` can move its preload work to the main thread. `stopReactNative` on the main
+   * thread can run before that work. The stop cancels the request, thus this method then gives
+   * `false`, and React Native stays stopped.
+   */
+  func consumePreloadRequest() -> Bool {
+    lock.lock()
+    defer { lock.unlock() }
+
+    let hadRequest = hasPreloadRequest
+    hasPreloadRequest = false
+
+    return hadRequest
+  }
+
+  /**
+   * The launch options for a call that can create the React Host. The options of the caller win
+   * over the options of an earlier `startReactNative` call.
+   */
+  func launchOptions(
+    overriddenBy explicitLaunchOptions: [AnyHashable: Any]? = nil
+  ) -> [AnyHashable: Any]? {
+    lock.lock()
+    defer { lock.unlock() }
+
+    return explicitLaunchOptions ?? storedLaunchOptions
+  }
+
+  /**
+   * Removes the state of the session. Call this method when you stop React Native.
+   */
+  func reset() {
+    jsBundleLoadObserver.reset()
+
+    lock.lock()
+    defer { lock.unlock() }
+
+    storedLaunchOptions = nil
+    hasPreloadRequest = false
+  }
+}
+
+/**
+ * The preload sequence that the two host runtimes share. Only one runtime is in a build. The
+ * shared sequence keeps the behavior of the two runtimes equal.
+ */
+protocol ReactHostPreloading: AnyObject {
+  var preloadState: ReactHostPreloadState { get }
+
+  /**
+   * The React Native factory, or nil while React Native did not start. The type is `AnyObject`,
+   * because `BrownfieldReactHostPreloader` also takes the factory as `id`. This file then needs no
+   * React Native import, and it builds with both runtimes.
+   */
+  var reactNativeFactoryForPreload: AnyObject? { get }
+
+  func startReactNative()
+
+  /**
+   * `false` while the bundle URL can still change. The runtime must not create the host in this
+   * condition, because the host keeps the first bundle that it evaluates.
+   */
+  func canPreloadReactNative() -> Bool
+
+  func prepareDevLoadingView()
+}
+
+extension ReactHostPreloading {
+  /**
+   * The implementation of
+   * `ReactNativeBrownfield.startReactNative(launchOptions:preloadBundle:onBundleLoaded:)`, which
+   * holds the contract.
+   */
+  func startReactNative(
+    launchOptions: [AnyHashable: Any]?,
+    preloadBundle: Bool,
+    onBundleLoaded: (() -> Void)?
+  ) {
+    preloadState.storeLaunchOptions(launchOptions)
+
+    if let onBundleLoaded {
+      preloadState.jsBundleLoadObserver.observe(onBundleLoaded: onBundleLoaded)
+    }
+
+    guard preloadBundle else {
+      startReactNative()
+      return
+    }
+
+    preloadState.requestPreload()
+
+    if Thread.isMainThread {
+      createReactHost()
+    } else {
+      DispatchQueue.main.async { [weak self] in
+        self?.createReactHost()
+      }
+    }
+  }
+
+  private func createReactHost() {
+    // `stopReactNative` can run between the request and this method, because a caller that is not
+    // on the main thread moves the work to the main thread. The stop cancels the request, and
+    // React Native must then stay stopped.
+    guard preloadState.consumePreloadRequest() else { return }
+
+    startReactNative()
+
+    guard let factory = reactNativeFactoryForPreload else {
+      logSkippedPreload("React Native did not make the factory")
+      return
+    }
+
+    guard canPreloadReactNative() else {
+      logSkippedPreload("the bundle URL can still change")
+      return
+    }
+
+    // You must configure the dev loading view before React Native loads the bundle. Usually the
+    // `view` method does this.
+    prepareDevLoadingView()
+
+    BrownfieldReactHostPreloader.preload(
+      withReactNativeFactory: factory,
+      launchOptions: preloadState.launchOptions()
+    )
+  }
+
+  private func logSkippedPreload(_ reason: String) {
+    NSLog(
+      "%@",
+      "ReactNativeBrownfield: startReactNative did not preload the JavaScript bundle, because "
+        + reason + ". The first React Native view loads the bundle."
+    )
+  }
+}

package/ios/ReactNativeBrownfield.swift

@@ -192,7 +192,9 @@ internal import Expo
   /**
    * Starts React Native with optional callback when bundle is loaded.
    *
-   * @param onBundleLoaded Optional callback invoked after JS bundle is fully loaded.
+   * @param onBundleLoaded Optional callback invoked on the main thread after the JS bundle is
+   *   fully loaded. It runs in the next turn of the main run loop when the bundle is already
+   *   loaded. A new callback replaces the callback that waits.
    */
   @objc public func startReactNative(onBundleLoaded: (() -> Void)?) {
     #if canImport(Expo)
@@ -202,6 +204,39 @@ internal import Expo
     #endif
   }
 
+  /**
+   * Starts React Native, and optionally loads the JavaScript bundle immediately. Without a
+   * preload, React Native loads the bundle when it creates the first React Native view. On
+   * Android, `ReactNativeBrownfield.initialize` does the same operation.
+   *
+   * @param launchOptions The launch options for the React Host. Only the call that creates the
+   *   host reads these options. This method keeps the options. A view that creates the host later
+   *   uses them, also if this method cannot create the host. Options that you give to `view` win
+   *   over these options.
+   * @param preloadBundle `true` loads and evaluates the JavaScript bundle now. A preload adds
+   *   work to the section of the caller, but the first React Native screen appears faster.
+   * @param onBundleLoaded An optional callback, with the rules of `startReactNative`.
+   */
+  @objc public func startReactNative(
+    launchOptions: [AnyHashable: Any]?,
+    preloadBundle: Bool,
+    onBundleLoaded: (() -> Void)?
+  ) {
+    #if canImport(Expo)
+    ExpoHostRuntime.shared.startReactNative(
+      launchOptions: launchOptions,
+      preloadBundle: preloadBundle,
+      onBundleLoaded: onBundleLoaded
+    )
+    #else
+    ReactNativeHostRuntime.shared.startReactNative(
+      launchOptions: launchOptions,
+      preloadBundle: preloadBundle,
+      onBundleLoaded: onBundleLoaded
+    )
+    #endif
+  }
+
   /**
    * Send a serialized JSON message to the React Native JS application.
    * The message is delivered as a `brownfieldMessage` DeviceEventEmitter event.

package/ios/Vanilla/ReactNativeHostRuntime.swift

@@ -46,7 +46,7 @@ class ReactNativeBrownfieldDelegate: RCTDefaultReactNativeFactoryDelegate {
 
 final class ReactNativeHostRuntime {
   public static let shared = ReactNativeHostRuntime()
-  private let jsBundleLoadObserver = JSBundleLoadObserver()
+  let preloadState = ReactHostPreloadState()
   private var delegate = ReactNativeBrownfieldDelegate()
 
   private func configureDevLoadingView() {
@@ -133,6 +133,7 @@ final class ReactNativeHostRuntime {
     }
 
     reactNativeFactory = nil
+    preloadState.reset()
   }
 
   public func view(
@@ -145,7 +146,7 @@ final class ReactNativeHostRuntime {
     return reactNativeFactory?.rootViewFactory.view(
       withModuleName: moduleName,
       initialProperties: initialProps,
-      launchOptions: launchOptions
+      launchOptions: preloadState.launchOptions(overriddenBy: launchOptions)
     )
   }
 
@@ -188,17 +189,38 @@ final class ReactNativeHostRuntime {
   /**
    * Starts React Native with optional callback when bundle is loaded.
    *
-   * @param onBundleLoaded Optional callback invoked after JS bundle is fully loaded.
+   * @param onBundleLoaded Optional callback invoked on the main thread after JS bundle is fully loaded.
    */
   public func startReactNative(onBundleLoaded: (() -> Void)?) {
+    // The callback registration is outside of the guard below. An earlier `startReactNative` call
+    // can already have made the factory, and the callback must still run.
+    if let onBundleLoaded {
+      preloadState.jsBundleLoadObserver.observe(onBundleLoaded: onBundleLoaded)
+    }
+
     guard reactNativeFactory == nil else { return }
 
     delegate.dependencyProvider = RCTAppDependencyProvider()
     reactNativeFactory = RCTReactNativeFactory(delegate: delegate)
+  }
+}
 
-    if let onBundleLoaded {
-      jsBundleLoadObserver.observeOnce(onBundleLoaded: onBundleLoaded)
-    }
+extension ReactNativeHostRuntime: ReactHostPreloading {
+  var reactNativeFactoryForPreload: AnyObject? {
+    return reactNativeFactory
+  }
+
+  /**
+   * The bare React Native delegate resolves the bundle URL from the override, from Metro, or from
+   * the embedded bundle. No step waits for an asynchronous operation. Thus a preload uses the same
+   * bundle as the first view.
+   */
+  func canPreloadReactNative() -> Bool {
+    return true
+  }
+
+  func prepareDevLoadingView() {
+    configureDevLoadingView()
   }
 }
 #endif

package/lib/commonjs/expo-config-plugin/template/android/ReactNativeHostManager.post55.kt

@@ -7,10 +7,15 @@ import com.callstack.reactnativebrownfield.ReactNativeBrownfield
 import com.facebook.react.PackageList
 import expo.modules.ApplicationLifecycleDispatcher
 import expo.modules.ExpoReactHostFactory
+import java.util.concurrent.atomic.AtomicBoolean
 
 object ReactNativeHostManager {
+    private val applicationCreateDispatched = AtomicBoolean()
+
     fun initialize(application: Application, onJSBundleLoaded: OnJSBundleLoaded? = null) {
-        ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        if (applicationCreateDispatched.compareAndSet(false, true)) {
+            ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        }
 
         ReactNativeBrownfield.initialize(application, onJSBundleLoaded) {
             ExpoReactHostFactory.getDefaultReactHost(

package/lib/module/expo-config-plugin/template/android/ReactNativeHostManager.post55.kt

@@ -7,10 +7,15 @@ import com.callstack.reactnativebrownfield.ReactNativeBrownfield
 import com.facebook.react.PackageList
 import expo.modules.ApplicationLifecycleDispatcher
 import expo.modules.ExpoReactHostFactory
+import java.util.concurrent.atomic.AtomicBoolean
 
 object ReactNativeHostManager {
+    private val applicationCreateDispatched = AtomicBoolean()
+
     fun initialize(application: Application, onJSBundleLoaded: OnJSBundleLoaded? = null) {
-        ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        if (applicationCreateDispatched.compareAndSet(false, true)) {
+            ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        }
 
         ReactNativeBrownfield.initialize(application, onJSBundleLoaded) {
             ExpoReactHostFactory.getDefaultReactHost(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callstack/react-native-brownfield",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "license": "MIT",
   "author": "Michal Chudziak <mike.chudziak@callstack.com>",
   "bin": {
@@ -89,7 +89,7 @@
     "@expo/config-plugins": ">=54 <100"
   },
   "dependencies": {
-    "@callstack/brownfield-cli": "workspace:^"
+    "@callstack/brownfield-cli": "^5.1.0"
   },
   "devDependencies": {
     "@babel/core": "^7.29.6",
@@ -121,4 +121,4 @@
   "engines": {
     "node": ">=20"
   }
-}
+}

package/src/expo-config-plugin/template/android/ReactNativeHostManager.post55.kt

@@ -7,10 +7,15 @@ import com.callstack.reactnativebrownfield.ReactNativeBrownfield
 import com.facebook.react.PackageList
 import expo.modules.ApplicationLifecycleDispatcher
 import expo.modules.ExpoReactHostFactory
+import java.util.concurrent.atomic.AtomicBoolean
 
 object ReactNativeHostManager {
+    private val applicationCreateDispatched = AtomicBoolean()
+
     fun initialize(application: Application, onJSBundleLoaded: OnJSBundleLoaded? = null) {
-        ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        if (applicationCreateDispatched.compareAndSet(false, true)) {
+            ApplicationLifecycleDispatcher.onApplicationCreate(application)
+        }
 
         ReactNativeBrownfield.initialize(application, onJSBundleLoaded) {
             ExpoReactHostFactory.getDefaultReactHost(