Skip to content

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-native exports. Doc comments are included on most symbols, and refs have dedicated *Instance types (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 --deintegrate and reverse it with npx 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=false and android.newDsl=false in android/gradle.properties.
  • New styling and text features: Adds textAlign: 'start'/'end' and StatusBar barStyle="auto". Text decorations now honor textDecorationStyle. backgroundImage loses its experimental_ prefix.
  • ArrayBuffer support in TurboModules: C++ TurboModules and iOS ObjC TurboModules now support ArrayBuffer.
  • Android: local network permission for SDK 37: ACCESS_LOCAL_NETWORK is added to PermissionsAndroid and 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). minCompileSdk is 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 to src/private/ are removed from types, and *Properties aliases are inaccessible (use *Props). NativeMethods/NativeMethodsMixin types are removed; use HostInstance.
  • Removed InteractionManager (use requestIdleCallback), the Modal animated prop, and the StatusBar backgroundColor/translucent/networkActivityIndicatorVisible props along with their setter methods.
  • ScrollView keyboardShouldPersistTaps no longer accepts boolean values.
  • useColorScheme() now returns ColorSchemeName | null and no longer includes 'unspecified' in its type.
  • Removed the NativeDialogManagerAndroid export and the undocumented Touchable root export (extend ViewProps instead). Removed the useTurboModules feature flag; TurboModules are always enabled.
  • Metro no longer supports YAML config files or .es6 JavaScript config files.
  • Removed react-native/rn-get-polyfills (use @react-native/js-polyfills). @react-native/core-cli-utils is no longer published. @react-native/jest-preset must now be consumed as a package. Connecting to standalone react-devtools via 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" to customConditions in tsconfig.json. The opt-out remains available through 0.88.
  • Android: add android.builtInKotlin=false and android.newDsl=false to android/gradle.properties, as suggested in the Upgrade Helper.
  • Migrate away from newly deprecated APIs: InitializeCore (use react-native/setup-env), @react-native/assets-registry, ImageBackground, Appearance.setColorScheme('unspecified') (use 'auto'), Android DrawerLayoutAndroid and UIBlock, and iOS TimingModule.
  • If trying SwiftPM on iOS: libraries without a Package.swift need npx react-native spm scaffold. After a fresh clone and in CI, run npx react-native spm once before building.
  • 0.84.x is now unsupported. For Expo projects, 0.87 will be available via expo@canary releases.
  • Compare template changes in the Upgrade Helper.

Patch releases

Version Released
0.87.1 2026-08-26
0.87.0 2026-08-11