Skip to content

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=false on Android and RCT_NEW_ARCH_ENABLED=0 on 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. useDeferredValue and startTransition no 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, childNodes and getBoundingClientRect(), and expose text and document nodes. Legacy methods such as measure still work.
  • Android: debugOptimized build type: Run npx react-native run-android --mode debugOptimized or npx 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 needs debug. 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.absoluteFillObject is deprecated in favor of the equivalent StyleSheet.absoluteFill. Legacy JavaScript APIs and many Legacy Architecture classes on Android, iOS and C++ are deprecated ahead of removal. Deprecation messages were also added for RCTAppDelegate APIs on iOS.

Breaking changes

  • Unhandled promise rejections are now reported through ExceptionsManager.handleException and raise console.error instead 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.
  • InteractionManager is deprecated and no longer respects interaction handles. Break long-running JS tasks into smaller ones scheduled with requestIdleCallback().
  • The Legacy Architecture opt-out is removed on Android and iOS. On iOS, a warning is shown if RCT_NEW_ARCH_ENABLED is set to 0.
  • Android: Gradle is bumped to 9.0.0 (no impact expected) and AGP to 8.12.0. ReactApplication.reactNativeHost now throws if it is not overridden.
  • Android: ViewManagerInterfaces were migrated to Kotlin and enforce parameter nullability. TextAttributeProps and ReactBaseTextShadowNode properties may need camelCase access.
  • Android: com.facebook.react.bridge.JSONArguments, the Inspector class and the deprecated DefaultReactHost.getDefaultReactHost() overloads are removed. MessageQueueThreadPerfStats is now a stub.
  • Android: DevSupportManager::openDebugger methods now accept a panel: String? parameter. Frameworks that implement DevSupportManager directly must update their signatures.
  • C++: the old <ReactCommon/….h> includes for CallbackWrapper.h and LongLivedObject.h are deleted; use <react/bridging/CallbackWrapper.h> and <react/bridging/LongLivedObject.h> instead. CxxSharedModuleWrapper, deepCopyJSIObject and deepCopyJSIArray are also removed.
  • ReactNativeFeatureFlags moved to src/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-compiler to 250829098.0.1. Set hermesV1Enabled=true on Android and build from source. On iOS, run RCT_HERMES_V1_ENABLED=1 bundle exec pod install without RCT_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