Breaking: React Native 0.82 Drops Legacy Architecture Support
The React Native team has released version 0.82, making it the first release to run exclusively on the New Architecture. This move signals the end of the Legacy Architecture as the framework moves toward a streamlined future.
“This is a monumental step for React Native. We believe it marks the beginning of a new era,” said a Meta spokesperson. Developers must now ensure their projects are fully compatible with the New Architecture before upgrading.
Key Features in 0.82
- New Architecture Only: Legacy architecture cannot be re-enabled via flags.
- Experimental Hermes V1: An opt-in upgrade for improved performance.
- React 19.1.1: Includes the latest React features and optimizations.
- DOM Node APIs: Native support for DOM-like operations.
Background: The Road to Exclusive New Architecture
React Native 0.76 made the New Architecture the default setting, but developers could still opt back to Legacy. Over the subsequent releases, the team refined stability and performance.
“We’ve thoroughly tested the New Architecture and are confident in its reliability for all production use cases,” the spokesperson added. Version 0.82 enforces it as the only option—any attempt to enable Legacy Architecture via newArchEnabled=false on Android or RCT_NEW_ARCH_ENABLED=0 on iOS will be ignored.
Migration Path
Teams still on Legacy Architecture must first migrate to React Native 0.81 or Expo SDK 54—the last releases supporting Legacy. Enable the New Architecture in 0.81 and verify everything works, then upgrade safely to 0.82.
If an incompatible third-party library blocks migration, the team advises reaching out to the library maintainers directly. For core bugs, developers are directed to the official issue tracker.
Interop Layers Remain for Now
The interop layers—compatibility shims for third-party libraries—will stay in the codebase for the foreseeable future. All classes and functions required by these layers will not be removed immediately. The team will share removal plans later.
What This Means for Developers
React Native 0.82 is a mandatory upgrade for any project that has not yet adopted the New Architecture. Legacy-only libraries will break unless they support the new system via the interop layers.
Looking ahead, Legacy Architecture classes will be removed starting in the next version, significantly reducing bundle size. This aligns with RFC0929: Removal of the Legacy Architecture.
Legacy Code Removal Scheduled
To minimize breaking changes, no Legacy Architecture APIs have been removed in 0.82. However, the team plans to strip out the remaining Legacy code from version 0.83 onward to save size and simplify the codebase.
“We are committed to making React Native leaner and faster. Removing Legacy Architecture is a key part of that,” the spokesperson concluded.
For full details, review RFC0929.