React Native v0.82 released
updated 0.82
React Native 0.82 is the first release that runs entirely on the New Architecture. Legacy Architecture opt-outs are now ignored on Android and iOS. The release also updates React to 19.1.1 and exposes DOM-like node APIs on native component refs. It adds an experimental opt-in to Hermes V1 and a faster debugOptimized build type on Android.
Highlights
- New Architecture only:
newArchEnabled=falseon Android andRCT_NEW_ARCH_ENABLED=0on iOS are ignored. Your app runs on the New Architecture. Interop layers remain, and no Legacy Architecture APIs are removed from core in this version. Removal is scheduled to start from the next version. - Experimental Hermes V1 opt-in: Hermes V1 brings compiler and VM improvements. On the Expensify app it gave faster bundle load and TTI on both Android and iOS. While experimental, it requires building React Native from source and is not compatible with precompiled builds.
- React 19.1.1: Owner stacks are now fully supported, including with
@babel/plugin-transform-function-name.useDeferredValueandstartTransitionno longer wrongly show the fallback inside a Suspense boundary, which aligns their behavior with Web. - DOM Node APIs on refs: Native component refs now return DOM-like nodes. They support
parentNode,children,childNodesandgetBoundingClientRect(), and expose text and document nodes. Legacy methods such asmeasurestill work. - Android: debugOptimized build type: Run
npx react-native run-android --mode debugOptimizedornpx expo run:android --variant debugOptimized. This variant enables C++ optimizations for faster animations and re-renders, and React Native DevTools still works. The C++ debugger needsdebug. Also backported to 0.81 and Expo SDK 54. - Web Performance APIs (canary only): The canary release level adds
performance.now(),performance.timeOrigin,PerformanceObserver,performance.mark/measure, and Event Timing and Long Tasks entries. These APIs are not yet stable. - Deprecations:
StyleSheet.absoluteFillObjectis deprecated in favor of the equivalentStyleSheet.absoluteFill. Legacy JavaScript APIs and many Legacy Architecture classes on Android, iOS and C++ are deprecated ahead of removal. Deprecation messages were also added forRCTAppDelegateAPIs on iOS.
Breaking changes
- Unhandled promise rejections are now reported through
ExceptionsManager.handleExceptionand raiseconsole.errorinstead of being swallowed. Previously hidden errors may surface, including in errors reported to your backend. Appearance.setColorScheme()no longer accepts null or undefined. Use'unspecified'to reset the color scheme.InteractionManageris deprecated and no longer respects interaction handles. Break long-running JS tasks into smaller ones scheduled withrequestIdleCallback().- The Legacy Architecture opt-out is removed on Android and iOS. On iOS, a warning is shown if
RCT_NEW_ARCH_ENABLEDis set to 0. - Android: Gradle is bumped to 9.0.0 (no impact expected) and AGP to 8.12.0.
ReactApplication.reactNativeHostnow throws if it is not overridden. - Android:
ViewManagerInterfaceswere migrated to Kotlin and enforce parameter nullability.TextAttributePropsandReactBaseTextShadowNodeproperties may need camelCase access. - Android:
com.facebook.react.bridge.JSONArguments, theInspectorclass and the deprecatedDefaultReactHost.getDefaultReactHost()overloads are removed.MessageQueueThreadPerfStatsis now a stub. - Android:
DevSupportManager::openDebuggermethods now accept apanel: String?parameter. Frameworks that implementDevSupportManagerdirectly must update their signatures. - C++: the old
<ReactCommon/….h>includes forCallbackWrapper.handLongLivedObject.hare deleted; use<react/bridging/CallbackWrapper.h>and<react/bridging/LongLivedObject.h>instead.CxxSharedModuleWrapper,deepCopyJSIObjectanddeepCopyJSIArrayare also removed. ReactNativeFeatureFlagsmoved tosrc/private. It is a private API and should not be depended on.
Upgrading
- If you still use the Legacy Architecture, first upgrade to React Native 0.81 or Expo SDK 54. Enable the New Architecture there and verify your app before moving to 0.82.
- Watch your error reporting after upgrading: previously swallowed promise rejections may cause a surge of new reports.
- To try Hermes V1, pin
hermes-compilerto250829098.0.1. SethermesV1Enabled=trueon Android and build from source. On iOS, runRCT_HERMES_V1_ENABLED=1 bundle exec pod installwithoutRCT_USE_PREBUILT_RNCORE. - Expo users can try 0.82 via
expo@canary. SDK 55 will ship with React Native 0.83. - 0.79.x is now unsupported.
- Compare template changes in the Upgrade Helper.
Patch releases
| Version | Released |
|---|---|
| 0.82.1 | 2025-10-20 |
| 0.82.0 | 2025-10-08 |