React Native v0.88 released
updated 0.88
React Native 0.88 makes Web-based event dispatching the default, adds fontVariationSettings to Text and TextInput on Android and iOS, and adds SceneDelegate lifecycle support on iOS. It syncs React 19.3.0 and moves to Metro 0.87. Like 0.83 and 0.86, it has no user-facing breaking changes, so apps on 0.87 should upgrade without app code changes. 0.85.x is now unsupported.
Highlights
- Web-based event dispatching by default: Events now go through the W3C EventTarget API, with real capture and bubble paths. Event props, synthetic event objects and ordering are unchanged. On the Canary channel, native refs expose
addEventListener,removeEventListeneranddispatchEvent. - Variable fonts with fontVariationSettings:
fontVariationSettingsnow works on<Text>and<TextInput>on Android and iOS. It accepts the CSS string form ("'wght' 700, 'slnt' -10") or an object form with four-character axis tags. - iOS: SceneDelegate lifecycle support:
RCTReactNativeFactoryadds SceneDelegate entry points such asstartReactNativeWithModuleName:inWindow:connectionOptions:. The AppDelegate path keeps working. Support is limited to a single scene, andDimensions.get()anduseWindowDimensions()update when the window is resized. - Android: ArrayBuffer for Java TurboModules: Java TurboModules can take and return JS
ArrayBuffervalues, which Codegen maps tocom.facebook.react.bridge.ArrayBuffer. Borrowed bytes in synchronous methods are valid only during the call. UseArrayBuffer.arrayBufferWithCopiedBytesto keep them. - iOS: Swift Package Manager hardening (experimental): SwiftPM is still opt-in, and CocoaPods remains fully supported. Manifests now use the app's deployment target, builds are more stable and machine-independent, and libraries can configure SwiftPM via
swiftpmConfigin package.json. SwiftPM is planned as the default in 0.89. - Stable background styles and dependency updates:
backgroundSize,backgroundPositionandbackgroundRepeatlose theirexperimental_prefix. React 19.3.0 is synced, Metro moves to 0.87 (minimum 0.87.1) and Hermes moves to 260318099.0.4.
Upgrading
- Event props work as before. Test any code that reaches past the public API into React Native's event internals. The legacy path is still behind an internal flag but is expected to be removed, so report anything that only works the old way.
- iOS: UIKit apps built with Xcode 27 require the UIScene lifecycle. Move the entry point to a SceneDelegate, forward URL and user-activity callbacks to
RCTLinkingManager, addUIApplicationSceneManifestto Info.plist and keepUIApplicationSupportsMultipleScenesset to false. react-native/babel-presetnow requires theinlinePlatformoption in addition toplatformto inlinePlatform.OSandPlatform.select(...). Android: the defaultUser-Agentnow includes the app name and version, so check any server logic that relies on the old value.- Migrate deprecated APIs: use
react-native/setup-envinstead ofInitializeCoreand unprefixed background styles. DropReactFragment.fabricEnabled(Android). ReplaceInputAccessoryViewwith an alternative such asKeyboardStickyView. - Android: the
String?overloads ofReactImageManagersetDefaultSourceandsetLoadingIndicatorSourceare deprecated in favor ofDynamic. Pass the prop value through instead of pre-resolving it. - iOS SwiftPM users (0.88.1): settings now live in
ReactNativeSPM/ReactNativeSPM.xcconfig. Custom xcconfigs must#includeit, and overriding target settings must add$(inherited). Runnpx react-native spm updateonce to rewrite existing schemes. - Compare template changes in the Upgrade Helper.
Patch releases
| Version | Released |
|---|---|
| 0.88.1 | 2026-10-27 |
| 0.88.0 | 2026-10-15 |