React Native v0.87 released
updated 0.87
React Native 0.87 makes the Strict TypeScript API the default JavaScript API, updates Metro to 0.87 with faster source maps and lower memory use, adds experimental Swift Package Manager support on iOS, and adds AGP 9 support on Android. It raises toolchain minimums (Node.js 22.13.0, Kotlin 2.0+) and removes several long-deprecated APIs, so most apps will need some migration work.
Highlights
- Strict TypeScript API is now the default: Types are now generated from React Native's source and scoped to root
react-nativeexports. Doc comments are included on most symbols, and refs have dedicated*Instancetypes (e.g.ViewInstance,TextInputInstance). A temporary opt-out is available through 0.88. - Faster, leaner Metro 0.87: Source map generation is 2x faster, which speeds up React Native DevTools loads. Metro uses half as much memory. TypeScript and ESM config files (e.g.
metro.config.mts) are now stable. New resolver features include package self-resolve. - iOS: experimental Swift Package Manager support: An opt-in alternative to CocoaPods that only needs Xcode. Set it up with
npx react-native spm --deintegrateand reverse it withnpx react-native spm deinit. CocoaPods remains the default; do not use SwiftPM in production yet. - Android: AGP 9 support: This is the first release supporting Android Gradle Plugin 9. The recommendation is to opt out of AGP 9's built-in Kotlin and new DSL with
android.builtInKotlin=falseandandroid.newDsl=falseinandroid/gradle.properties. - New styling and text features: Adds
textAlign: 'start'/'end'andStatusBarbarStyle="auto". Text decorations now honortextDecorationStyle.backgroundImageloses itsexperimental_prefix. - ArrayBuffer support in TurboModules: C++ TurboModules and iOS ObjC TurboModules now support
ArrayBuffer. - Android: local network permission for SDK 37:
ACCESS_LOCAL_NETWORKis added toPermissionsAndroidand requested so the dev server stays reachable on Android 17 (SDK 37).
Breaking changes
- Node.js >= 22.13.0 is now required.
- Android: minimum Kotlin version is now 2.0+ (bundled Kotlin is 2.2.0).
minCompileSdkis now 34, so libraries must use compileSdk >= 34. compileSdk and buildTools are bumped to 37. - Strict TypeScript API is the default. Deep imports into
react-native/Libraries/*are a type error, deep imports tosrc/private/are removed from types, and*Propertiesaliases are inaccessible (use*Props).NativeMethods/NativeMethodsMixintypes are removed; useHostInstance. - Removed
InteractionManager(userequestIdleCallback), theModalanimatedprop, and theStatusBarbackgroundColor/translucent/networkActivityIndicatorVisibleprops along with their setter methods. ScrollViewkeyboardShouldPersistTapsno longer accepts boolean values.useColorScheme()now returnsColorSchemeName | nulland no longer includes'unspecified'in its type.- Removed the
NativeDialogManagerAndroidexport and the undocumentedTouchableroot export (extendViewPropsinstead). Removed theuseTurboModulesfeature flag; TurboModules are always enabled. - Metro no longer supports YAML config files or
.es6JavaScript config files. - Removed
react-native/rn-get-polyfills(use@react-native/js-polyfills).@react-native/core-cli-utilsis no longer published.@react-native/jest-presetmust now be consumed as a package. Connecting to standalonereact-devtoolsvia WebSocket is removed; use React Native DevTools. - iOS: header imports without a namespace must include it, e.g.
#import <React/RCTAppDelegate.h>instead of#import <RCTAppDelegate.h>.
Upgrading
- Migrate to the Strict API using the migration guide and the ESLint fixers. To temporarily keep the legacy types, add
"react-native-legacy-deep-imports"tocustomConditionsintsconfig.json. The opt-out remains available through 0.88. - Android: add
android.builtInKotlin=falseandandroid.newDsl=falsetoandroid/gradle.properties, as suggested in the Upgrade Helper. - Migrate away from newly deprecated APIs:
InitializeCore(usereact-native/setup-env),@react-native/assets-registry,ImageBackground,Appearance.setColorScheme('unspecified')(use'auto'), AndroidDrawerLayoutAndroidandUIBlock, and iOSTimingModule. - If trying SwiftPM on iOS: libraries without a
Package.swiftneednpx react-native spm scaffold. After a fresh clone and in CI, runnpx react-native spmonce before building. - 0.84.x is now unsupported. For Expo projects, 0.87 will be available via
expo@canaryreleases. - Compare template changes in the Upgrade Helper.
Patch releases
| Version | Released |
|---|---|
| 0.87.1 | 2026-08-26 |
| 0.87.0 | 2026-08-11 |