React Native v0.81 released
updated 0.81
React Native 0.81 targets Android 16 (API level 36) by default, bringing required edge-to-edge display and predictive back. It deprecates the built-in <SafeAreaView>, removes built-in JavaScriptCore in favor of a community package, raises the minimum Node.js and Xcode versions, and adds experimental precompiled iOS builds that can cut compile times by up to 10x.
Highlights
- Android 16 (API level 36) by default: Android apps now target Android 16, which requires edge-to-edge display with no opt-out. A new
edgeToEdgeEnabledgradle property enables edge-to-edge on older Android versions. Predictive back gesture is enabled by default for apps targeting Android 16. - SafeAreaView deprecated: The built-in
<SafeAreaView>is iOS-only and incompatible with Android edge-to-edge. It now shows warnings in React Native DevTools and will be removed in a future version. Migrate toreact-native-safe-area-contextor a similar library. - Experimental precompiled iOS builds: Cuts iOS compile times by up to 10x where React Native is the primary dependency. Enable with
RCT_USE_RN_DEP=1 RCT_USE_PREBUILT_RNCORE=1 bundle exec pod install. You cannot step into React Native internals in these builds. 0.81.1 setsSWIFT_ENABLE_EXPLICIT_MODULES=NOto support Xcode 26. - Better uncaught error reporting: React Native DevTools now shows the original message and stack trace of uncaught JavaScript errors, the error's cause if any, and an Owner Stack for errors thrown by components.
- New component capabilities: Android:
onFocus/onBluronViewand views usingBaseViewManager;fadingEdgeLengthcan be set separately forScrollViewstart and end. iOS:Modals can be swiped down interactively; support for differentborderWidths; Hermes GC runs on memory pressure warnings. - Notable patch release changes: 0.81.2 adds a
debugOptimizedbuildType on Android and experimental feature flags aimed at performance issues with Android + Reanimated + New Architecture. 0.81.5 fixes permission requests not always resolving on Android 16.
Breaking changes
- Built-in JavaScriptCore is removed. Apps that require JSC must use the community-maintained package to upgrade. Apps using Hermes are not affected.
- Minimum Node.js is now 20.19.4. Upgrade Node.js in development and CI environments.
- iOS: Xcode 16.1 or higher is now required to build iOS projects.
- Metro in Community CLI projects now respects
resolver.resolveRequestandserializer.getModulesRunBeforeMainModulefrommetro.config.js. Remove custom values to restore previous behavior. - Uncaught error reporting changed; if you send JS errors to a backend or error service, logs may differ (e.g. more thrown errors previously reported via
console.error). Errors no longer have the "js engine" suffix. - Android: library authors with a custom CMakeLists.txt must set the
RN_SERIALIZABLE_STATEmacro, e.g. viatarget_compile_reactnative_options(myLibraryName PRIVATE), or C++ code may fail to compile. - Removed: all
react-native/Libraries/BugReportingAPIs, the shippedflowdirectory, andinfoLog.Viewno longer sets default accessibility props, which may affect snapshot tests. - Android:
MountingManager,TextLayoutManager,FpsDebugFrameCallback,ContextUtilsand NetworkingModule handler APIs are now internal; aFabricUIManager.measureoverload was removed. - Android: codegen ViewManagerInterfaces and
ReactDelegateare now Kotlin; generated types may differ and parameter nullability is enforced. - Fabric C++:
textAlignVerticalmoved from TextAttributes to ParagraphAttribute (JS<Text>API unchanged). iOS:SynchronouslyUpdateViewOnUIThreadnow takesfolly::dynamicinstead ofNSDictionary.
Upgrading
- Expo users: 0.81 will be the default in the upcoming Expo SDK 54.
- Android: test back navigation thoroughly. Custom native back handling (e.g. overriding
onBackPressed()) may need migration or a temporary opt-out of predictive back. - Android: from November 1, 2025, Google Play submissions must meet the 16 KB page size requirement. React Native is compliant; verify your own native code and third-party libraries.
- Android: test responsive UI on large screens; Google expects adaptive layouts, and opting out is only possible for now, before Android 17.
- Replace deprecated APIs:
SafeAreaView,hasTVPreferredFocus,ShadowNode::Shared/Unshared/Weak, iOSRCTFollyConvert.h, and AndroidDefaultNewArchitectureEntryPoint.load(Boolean, Boolean, Boolean). - 0.81 is now the latest stable version and 0.78.x is no longer supported.
- Compare template changes in the Upgrade Helper.
Patch releases
| Version | Released |
|---|---|
| 0.81.6 | 2026-02-05 |
| 0.81.5 | 2025-10-21 |
| 0.81.4 | 2025-09-10 |
| 0.81.3 | 2025-09-10 |
| 0.81.2 | 2025-09-09 |
| 0.81.1 | 2025-08-27 |
| 0.81.0 | 2025-08-12 |