React Native Releases

This repository is dedicated to coordinating React Native releases. It contains documentation and information on how React Native is released, which versions are supported, and how to request a new Pick Request.

Pick Requests and Support Policy

What is a pick request?

A pick request is a request for the React Native Release Crew to include a commit into a specific React Native release. As the development of React Native happens on main, you can request for a specific commit or Pull Request to be included in one of the previous version of React Native. We accepts pick requests only for versions of React Native that are currently supported

What versions of React Native are currently supported?

Please refer to the official Support Policy to know which versions are currently supported.

Running a React Native Release

Tip

The recommended way to run a release is the release copilot, a Claude Code skill in this repo. It works out where the release stands, stops at anything that isn't ready and asks you to confirm every step that publishes or pushes. Start Claude Code in this repo on your own machine, with Node 22:

cd react-native-releases
nvm use 22
claude

Then ask it, for example, "check my environment" or "plan the next 0.89 release". The first launch asks whether to trust the folder. Say yes, otherwise Claude Code ignores the project settings. See the copilot's SKILL.md for what it does.

To run a release without an agent, use the rn-release-automator CLI and the guides below. Every guide leads with the relevant CLI command and keeps the manual steps in collapsible sections. Always run mutating commands with --dry-run first.

React Native releases are run by a group of volunteers called the Release Crew. In those docs you can find clarification about the roles of the various members of the Release Crew:

• Roles & Responsibilities of Release Crew
• Release Escalation & Support Policy
• FAQ
• Glossary

In those docs instead you can find step-by-step guides on how to run a React Native release

• Guide: Release CLI (rn-release-automator)
• Guide: Running a Release
• Guide: Release Candidates
  • How to setup a new release project
  • How to cut a release candidate
  • Release Candidate patches
  • Promote release candidate to stable
• Guide: Hermes Release
• Guide: Release Testing
• Notable Call-outs / Gotchas

Reference Documentation

These docs are not relevant for most releases but keeping them around in case of needing to patch an older release.

• Deprecated: Upgrade Helper
• Deprecated: Release Dependencies