React Native New Architecture Working Group

February 6, 2025 · View on GitHub

The intention of this repository is to coordinate and support the rollout of the React Native New Architecture. We have provided guides and a discussion space for this purpose.

You can find New Architecture updates here.

Guides

Caution

These guides are deprecated.

You can find the most updated versions of them in the React Native website.

How to enable the New Architecture
- For Apps
  - Enable the New Architecture for Apps
- For Libraries
  - Make your library compatible with the New Architecture
  - Convert Library to TurboModules/Fabric APIs
    - Additional information for Android
    - Additional information for iOS
New Architecture Workflows
- Create a Fabric Native Component
- Create a Turbo Native Module
- Using Codegen to write type-safe Fabric Components and Turbo Modules
- Writing cross-platform TurboModules with C++
  - Supporting custom C++ types
- Using React 18 features
- Backwards compatibility
  - For Legacy Native Modules
  - For Legacy Native Components
Troubleshooting
Appendix

Discussion

This repository is also a place for discussion and feedback on the New Architecture. You can access it by heading over to the Discussions Tab on Github.

Sections

We've created some sections to keep the discussion focused.

Title	Topic
Announcements 📣	General announcements about this working group.
Deep Dive 🐳	Sharing deep dives and technical-specific topics
Documentation 📚	A place to chat about the New Architecture documentation and migration material
Libraries 🛠	A place to chat about 3rd party libraries and their migration story to the New Architecture
Q&A 🤝	A place to ask the community for help on the New Architecture topics
Releases 🏁	Updates on New Architecture in each release