From bef385042e7646aa82852d9a78a3f35f756181cd Mon Sep 17 00:00:00 2001 From: Nicola Corti Date: Tue, 2 Sep 2025 15:45:29 +0200 Subject: [PATCH 1/4] Add the releases page --- docs/releases.md | 39 +++++++++++++++++++++++ website/contributing/versioning-policy.md | 8 +---- website/sidebars.ts | 1 + website/static/_redirects | 3 ++ 4 files changed, 44 insertions(+), 7 deletions(-) create mode 100644 docs/releases.md diff --git a/docs/releases.md b/docs/releases.md new file mode 100644 index 00000000000..1a981b90c1b --- /dev/null +++ b/docs/releases.md @@ -0,0 +1,39 @@ +--- +id: releases +title: Releases +--- + +New React Native releases are shipped **every two months**, usually resulting in six (6) new minors per year. + +Below is the schedule and current status of recent and upcoming React Native releases: + +| Version | Branch-cut Date | Release Date | Support | Blogpost | +| -------- | --------------- | ------------ | ------------ | -------------------------------------------------------------------- | +| `0.83.x` | 2025-11-03 | 2025-12-08 | Future | | +| `0.82.x` | 2025-09-01 | 2025-10-06 | Future | | +| `0.81.x` | 2025-07-10 | 2025-08-12 | Active | [Details](https://reactnative.dev/blog/2025/08/12/react-native-0.81) | +| `0.80.x` | 2025-05-07 | 2025-06-12 | Active | [Details](https://reactnative.dev/blog/2025/06/12/react-native-0.80) | +| `0.79.x` | 2025-03-04 | 2025-04-08 | End of Cycle | [Details](https://reactnative.dev/blog/2025/04/08/react-native-0.79) | +| `0.78.x` | 2025-01-15 | 2025-02-19 | Unsupported | [Details](https://reactnative.dev/blog/2025/02/19/react-native-0.78) | +| `0.77.x` | 2024-11-26 | 2025-01-21 | Unsupported | [Details](https://reactnative.dev/blog/2025/01/21/version-0.77) | + +The different support level presented in the table are defined as such: + +- Future + - After a new version branch gets cut, creating new Release Candidates to allow the community to test the upcoming version is very important. New RC releases are done at a high pace, as soon as viable. +- Active + - Stable releases in active support receive frequent updates. Latest stable has the highest priority, and at the start of its stable cycle (right after .0 is released) multiple patches will be done as soon as possible to stabilize the version and ensure a good upgrade experience to the community. +- End of Cycle + - A version in this support bracket will receive less patches, unless some important regressions need to be addressed. Once a next version becomes the new latest stable, before the version in EoC moves over into Unsupported one last patch released will be produced with the latest receive pick requests. +- Unsupported + - When a version is in the unsupported stage, no new released are to be expected. Only very important regressions might create exceptions to this rule; it is recommended that codebases using an unsupported version upgrade as soon as possible. + +## Commitment to Stability + +In order to support users upgrading React Native versions, we’re committed to maintain the **latest 3 minor series** (e.g. 0.78.x, 0.77.x and 0.76.x when 0.78 is the latest release). + +For those releases we’ll be publishing regular updates and bug fixes. + +You can read more about our support policy on [the react-native-releases working group](https://github.com/reactwg/react-native-releases/blob/main/docs/support.md). + +More information on our versioning, and what we consider a breaking change is available in our [versioning policy](/contributing/versioning-policy) page. diff --git a/website/contributing/versioning-policy.md b/website/contributing/versioning-policy.md index d1898e867b3..0ae581580d1 100644 --- a/website/contributing/versioning-policy.md +++ b/website/contributing/versioning-policy.md @@ -26,13 +26,7 @@ Stable releases are shipped regularly, with the latest tagged as `latest` on NPM A series of releases under the same minor number is called a **minor series** (e.g. 0.76.x is the minor series for 0.76.0, 0.76.1, 0.76.2, etc.). -## Commitment to Stability - -In order to support users upgrading React Native versions, we’re committed to maintain the latest 3 minor series (e.g. 0.78.x, 0.77.x and 0.76.x when 0.78 is the latest release). - -For those releases we’ll be publishing regular updates and bug fixes. - -You can read more about our support policy on [the react-native-releases working group](https://github.com/reactwg/react-native-releases/blob/main/docs/support.md). +You can read more about our **commitment to stability** in [the releases page](/releases). ### Breaking changes diff --git a/website/sidebars.ts b/website/sidebars.ts index c6e61c2fa8d..c70d5d2d1c9 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -11,6 +11,7 @@ export default { 'using-a-listview', 'troubleshooting', 'platform-specific-code', + 'releases', 'more-resources', ], 'Environment setup': [ diff --git a/website/static/_redirects b/website/static/_redirects index cd366db3423..5ff0a4f37e0 100644 --- a/website/static/_redirects +++ b/website/static/_redirects @@ -116,5 +116,8 @@ https://reactnative.dev/docs/0.74/ram-bundles-inline-requires /docs/o # Rework of the community /help /community/overview +# Releases +/releases /docs/releases + # Latest version might be linked to directly and should redirect /docs/$LATEST_VERSION$/* /docs/:splat From 89c94aa246fb9699fa9a1844ad853ffa5e74a0b2 Mon Sep 17 00:00:00 2001 From: Simek Date: Tue, 2 Sep 2025 16:14:37 +0200 Subject: [PATCH 2/4] define releases table as a non-versioned component --- docs/releases.md | 12 +++--------- website/src/releases/ReleasesTable.tsx | 5 +++++ website/src/releases/_releases-table.mdx | 9 +++++++++ 3 files changed, 17 insertions(+), 9 deletions(-) create mode 100644 website/src/releases/ReleasesTable.tsx create mode 100644 website/src/releases/_releases-table.mdx diff --git a/docs/releases.md b/docs/releases.md index 1a981b90c1b..517ffc31ab4 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -3,19 +3,13 @@ id: releases title: Releases --- +import ReleasesTable from '@site/src/releases/ReleasesTable'; + New React Native releases are shipped **every two months**, usually resulting in six (6) new minors per year. Below is the schedule and current status of recent and upcoming React Native releases: -| Version | Branch-cut Date | Release Date | Support | Blogpost | -| -------- | --------------- | ------------ | ------------ | -------------------------------------------------------------------- | -| `0.83.x` | 2025-11-03 | 2025-12-08 | Future | | -| `0.82.x` | 2025-09-01 | 2025-10-06 | Future | | -| `0.81.x` | 2025-07-10 | 2025-08-12 | Active | [Details](https://reactnative.dev/blog/2025/08/12/react-native-0.81) | -| `0.80.x` | 2025-05-07 | 2025-06-12 | Active | [Details](https://reactnative.dev/blog/2025/06/12/react-native-0.80) | -| `0.79.x` | 2025-03-04 | 2025-04-08 | End of Cycle | [Details](https://reactnative.dev/blog/2025/04/08/react-native-0.79) | -| `0.78.x` | 2025-01-15 | 2025-02-19 | Unsupported | [Details](https://reactnative.dev/blog/2025/02/19/react-native-0.78) | -| `0.77.x` | 2024-11-26 | 2025-01-21 | Unsupported | [Details](https://reactnative.dev/blog/2025/01/21/version-0.77) | + The different support level presented in the table are defined as such: diff --git a/website/src/releases/ReleasesTable.tsx b/website/src/releases/ReleasesTable.tsx new file mode 100644 index 00000000000..6cd3ae095ae --- /dev/null +++ b/website/src/releases/ReleasesTable.tsx @@ -0,0 +1,5 @@ +import ReleasesTableMDX from './_releases-table.mdx'; + +export default function ReleasesTable() { + return ; +} diff --git a/website/src/releases/_releases-table.mdx b/website/src/releases/_releases-table.mdx new file mode 100644 index 00000000000..8e698827753 --- /dev/null +++ b/website/src/releases/_releases-table.mdx @@ -0,0 +1,9 @@ +| Version | Branch-cut Date | Release Date | Support | Blogpost | +| -------- | --------------- | ------------ | ------------ | --------------------------------------------- | +| `0.83.x` | 2025-11-03 | 2025-12-08 | Future | | +| `0.82.x` | 2025-09-01 | 2025-10-06 | Future | | +| `0.81.x` | 2025-07-10 | 2025-08-12 | Active | [Details](/blog/2025/08/12/react-native-0.81) | +| `0.80.x` | 2025-05-07 | 2025-06-12 | Active | [Details](/blog/2025/06/12/react-native-0.80) | +| `0.79.x` | 2025-03-04 | 2025-04-08 | End of Cycle | [Details](/blog/2025/04/08/react-native-0.79) | +| `0.78.x` | 2025-01-15 | 2025-02-19 | Unsupported | [Details](/blog/2025/02/19/react-native-0.78) | +| `0.77.x` | 2024-11-26 | 2025-01-21 | Unsupported | [Details](/blog/2025/01/21/version-0.77) | From 78402f1639e5d2860332d618908b183b74d7a6ee Mon Sep 17 00:00:00 2001 From: Simek Date: Tue, 2 Sep 2025 18:00:07 +0200 Subject: [PATCH 3/4] correct link --- website/contributing/versioning-policy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/contributing/versioning-policy.md b/website/contributing/versioning-policy.md index 0ae581580d1..0a74805437c 100644 --- a/website/contributing/versioning-policy.md +++ b/website/contributing/versioning-policy.md @@ -26,7 +26,7 @@ Stable releases are shipped regularly, with the latest tagged as `latest` on NPM A series of releases under the same minor number is called a **minor series** (e.g. 0.76.x is the minor series for 0.76.0, 0.76.1, 0.76.2, etc.). -You can read more about our **commitment to stability** in [the releases page](/releases). +You can read more about our **commitment to stability** in [the releases page](/docs/next/releases). ### Breaking changes From 0b9d9701e1177c9bdb13ad16d0beed2b933ecd1d Mon Sep 17 00:00:00 2001 From: Simek Date: Tue, 2 Sep 2025 18:01:06 +0200 Subject: [PATCH 4/4] correct redirect --- website/static/_redirects | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/static/_redirects b/website/static/_redirects index 5ff0a4f37e0..6cb13fa6328 100644 --- a/website/static/_redirects +++ b/website/static/_redirects @@ -117,7 +117,7 @@ https://reactnative.dev/docs/0.74/ram-bundles-inline-requires /docs/o /help /community/overview # Releases -/releases /docs/releases +/releases /docs/next/releases # Latest version might be linked to directly and should redirect /docs/$LATEST_VERSION$/* /docs/:splat