From 9fbcb1f30ebbf2be54291035257bf735391b4943 Mon Sep 17 00:00:00 2001
From: D N <4661784+retyui@users.noreply.github.com>
Date: Thu, 10 Sep 2026 15:18:22 +0200
Subject: [PATCH] feat: Add missing `ReactNativeVersion` API

commit: https://github.com/react/react-native/commit/ec5638abd0e872be62b6ea5d8df9bed6335c2191
---
 docs/components-and-apis.md                   |  6 ++
 docs/reactnativeversion.md                    | 83 +++++++++++++++++++
 website/sidebars.ts                           |  1 +
 .../version-0.82/components-and-apis.md       |  6 ++
 .../version-0.82/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.83/components-and-apis.md       |  6 ++
 .../version-0.83/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.84/components-and-apis.md       |  6 ++
 .../version-0.84/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.85/components-and-apis.md       |  6 ++
 .../version-0.85/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.86/components-and-apis.md       |  6 ++
 .../version-0.86/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.87/components-and-apis.md       |  6 ++
 .../version-0.87/reactnativeversion.md        | 83 +++++++++++++++++++
 .../version-0.82-sidebars.json                |  1 +
 .../version-0.83-sidebars.json                |  1 +
 .../version-0.84-sidebars.json                |  1 +
 .../version-0.85-sidebars.json                |  1 +
 .../version-0.86-sidebars.json                |  1 +
 .../version-0.87-sidebars.json                |  1 +
 21 files changed, 630 insertions(+)
 create mode 100644 docs/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.82/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.83/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.84/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.85/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.86/reactnativeversion.md
 create mode 100644 website/versioned_docs/version-0.87/reactnativeversion.md

diff --git a/docs/components-and-apis.md b/docs/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/docs/components-and-apis.md
+++ b/docs/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/docs/reactnativeversion.md b/docs/reactnativeversion.md
new file mode 100644
index 00000000000..dceca05fee0
--- /dev/null
+++ b/docs/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.88.1
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 88
+patch; // 1
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/sidebars.ts b/website/sidebars.ts
index 363f0c5c05b..6f2abf7d498 100644
--- a/website/sidebars.ts
+++ b/website/sidebars.ts
@@ -214,6 +214,7 @@ export default {
       'pixelratio',
       'platform',
       'platformcolor',
+      'reactnativeversion',
       'roottag',
       'share',
       'stylesheet',
diff --git a/website/versioned_docs/version-0.82/components-and-apis.md b/website/versioned_docs/version-0.82/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.82/components-and-apis.md
+++ b/website/versioned_docs/version-0.82/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.82/reactnativeversion.md b/website/versioned_docs/version-0.82/reactnativeversion.md
new file mode 100644
index 00000000000..134673641fb
--- /dev/null
+++ b/website/versioned_docs/version-0.82/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.82.1
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 82
+patch; // 1
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_docs/version-0.83/components-and-apis.md b/website/versioned_docs/version-0.83/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.83/components-and-apis.md
+++ b/website/versioned_docs/version-0.83/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.83/reactnativeversion.md b/website/versioned_docs/version-0.83/reactnativeversion.md
new file mode 100644
index 00000000000..f7c7b652bc1
--- /dev/null
+++ b/website/versioned_docs/version-0.83/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.83.10
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 83
+patch; // 10
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_docs/version-0.84/components-and-apis.md b/website/versioned_docs/version-0.84/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.84/components-and-apis.md
+++ b/website/versioned_docs/version-0.84/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.84/reactnativeversion.md b/website/versioned_docs/version-0.84/reactnativeversion.md
new file mode 100644
index 00000000000..8ed767ff380
--- /dev/null
+++ b/website/versioned_docs/version-0.84/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.84.1
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 84
+patch; // 1
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_docs/version-0.85/components-and-apis.md b/website/versioned_docs/version-0.85/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.85/components-and-apis.md
+++ b/website/versioned_docs/version-0.85/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.85/reactnativeversion.md b/website/versioned_docs/version-0.85/reactnativeversion.md
new file mode 100644
index 00000000000..c4b6e7a8b77
--- /dev/null
+++ b/website/versioned_docs/version-0.85/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.85.3
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 85
+patch; // 3
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_docs/version-0.86/components-and-apis.md b/website/versioned_docs/version-0.86/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.86/components-and-apis.md
+++ b/website/versioned_docs/version-0.86/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.86/reactnativeversion.md b/website/versioned_docs/version-0.86/reactnativeversion.md
new file mode 100644
index 00000000000..35e254c249c
--- /dev/null
+++ b/website/versioned_docs/version-0.86/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.86.3
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 86
+patch; // 3
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_docs/version-0.87/components-and-apis.md b/website/versioned_docs/version-0.87/components-and-apis.md
index 616ead503e0..5347a46286b 100644
--- a/website/versioned_docs/version-0.87/components-and-apis.md
+++ b/website/versioned_docs/version-0.87/components-and-apis.md
@@ -198,6 +198,12 @@ These components may be useful for certain applications. For an exhaustive list
       <p>Provides access to the device pixel density.</p>
     </a>
   </div>
+  <div className="component">
+    <a href="./reactnativeversion">
+      <h3>ReactNativeVersion</h3>
+      <p>Exposes the resolved React Native package version on the JS side.</p>
+    </a>
+  </div>
   <div className="component">
     <a href="./refreshcontrol">
       <h3>RefreshControl</h3>
diff --git a/website/versioned_docs/version-0.87/reactnativeversion.md b/website/versioned_docs/version-0.87/reactnativeversion.md
new file mode 100644
index 00000000000..2ea05eb0954
--- /dev/null
+++ b/website/versioned_docs/version-0.87/reactnativeversion.md
@@ -0,0 +1,83 @@
+---
+id: reactnativeversion
+title: ReactNativeVersion
+---
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+```
+
+The `ReactNativeVersion` API exposes the version of the resolved `react-native` package on JS side. Apps and libraries can use it to check compatibility or enable version-specific behavior.
+
+:::note
+
+Also, we have [`Platform.constants.reactNativeVersion`](platform#constants) in our public API already. **However**, this is the per-platform _**native-reported**_ React Native version.
+
+:::
+
+## Example
+
+```tsx
+import {ReactNativeVersion} from 'react-native';
+
+const version = ReactNativeVersion.getVersionString(); // 0.87.1
+const {major, minor, patch, prerelease} = ReactNativeVersion;
+major; // 0
+minor; // 87
+patch; // 1
+prerelease; // null
+```
+
+---
+
+# Reference
+
+## Properties
+
+### `major`
+
+```tsx
+static major: number;
+```
+
+The major version number of the resolved `react-native` package.
+
+---
+
+### `minor`
+
+```tsx
+static minor: number;
+```
+
+The minor version number of the resolved `react-native` package.
+
+---
+
+### `patch`
+
+```tsx
+static patch: number;
+```
+
+The patch version number of the resolved `react-native` package.
+
+---
+
+### `prerelease`
+
+```tsx
+static prerelease: string | null;
+```
+
+The prerelease tag for the resolved `react-native` package, or `null` for stable releases.
+
+## Methods
+
+### `getVersionString()`
+
+```tsx
+static getVersionString(): string;
+```
+
+Returns the full version string in the format `major.minor.patch` or `major.minor.patch-prerelease`.
diff --git a/website/versioned_sidebars/version-0.82-sidebars.json b/website/versioned_sidebars/version-0.82-sidebars.json
index de67809776b..b7b6f72dae3 100644
--- a/website/versioned_sidebars/version-0.82-sidebars.json
+++ b/website/versioned_sidebars/version-0.82-sidebars.json
@@ -228,6 +228,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",
diff --git a/website/versioned_sidebars/version-0.83-sidebars.json b/website/versioned_sidebars/version-0.83-sidebars.json
index 0eabe9c2736..2d90c999bb8 100644
--- a/website/versioned_sidebars/version-0.83-sidebars.json
+++ b/website/versioned_sidebars/version-0.83-sidebars.json
@@ -228,6 +228,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",
diff --git a/website/versioned_sidebars/version-0.84-sidebars.json b/website/versioned_sidebars/version-0.84-sidebars.json
index 710e2fd561c..1e0c50dc103 100644
--- a/website/versioned_sidebars/version-0.84-sidebars.json
+++ b/website/versioned_sidebars/version-0.84-sidebars.json
@@ -239,6 +239,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",
diff --git a/website/versioned_sidebars/version-0.85-sidebars.json b/website/versioned_sidebars/version-0.85-sidebars.json
index 710e2fd561c..1e0c50dc103 100644
--- a/website/versioned_sidebars/version-0.85-sidebars.json
+++ b/website/versioned_sidebars/version-0.85-sidebars.json
@@ -239,6 +239,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",
diff --git a/website/versioned_sidebars/version-0.86-sidebars.json b/website/versioned_sidebars/version-0.86-sidebars.json
index 30f5165e95c..06dcd504b1b 100644
--- a/website/versioned_sidebars/version-0.86-sidebars.json
+++ b/website/versioned_sidebars/version-0.86-sidebars.json
@@ -224,6 +224,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",
diff --git a/website/versioned_sidebars/version-0.87-sidebars.json b/website/versioned_sidebars/version-0.87-sidebars.json
index df0ec0e0b53..4aee4868e04 100644
--- a/website/versioned_sidebars/version-0.87-sidebars.json
+++ b/website/versioned_sidebars/version-0.87-sidebars.json
@@ -223,6 +223,7 @@
       "pixelratio",
       "platform",
       "platformcolor",
+      "reactnativeversion",
       "roottag",
       "share",
       "stylesheet",