diff --git a/package.json b/package.json
index 348d07af..fc49d3ca 100644
--- a/package.json
+++ b/package.json
@@ -77,6 +77,7 @@
"@release-it/conventional-changelog": "^10.0.0",
"@relmify/jest-serializer-strip-ansi": "^1.0.2",
"@types/jest": "^29.5.14",
+ "@types/node": "^22.13.8",
"@types/react": "^19.0.0",
"@types/react-test-renderer": "^19.0.0",
"babel-jest": "^29.7.0",
@@ -87,9 +88,9 @@
"flow-bin": "~0.170.0",
"jest": "^29.7.0",
"prettier": "^2.8.8",
- "react": "^19.0.0",
+ "react": "19.0.0",
"react-native": "0.78.0",
- "react-test-renderer": "^19.0.0",
+ "react-test-renderer": "19.0.0",
"release-it": "^18.0.0",
"typescript": "^5.6.3",
"typescript-eslint": "^8.19.1"
diff --git a/src/helpers/__tests__/ensure-peer-deps.test.ts b/src/helpers/__tests__/ensure-peer-deps.test.ts
new file mode 100644
index 00000000..354eab00
--- /dev/null
+++ b/src/helpers/__tests__/ensure-peer-deps.test.ts
@@ -0,0 +1,50 @@
+/* eslint-disable @typescript-eslint/no-require-imports */
+
+// Mock the require calls
+jest.mock('react/package.json', () => ({ version: '19.0.0' }));
+jest.mock('react-test-renderer/package.json', () => ({ version: '19.0.0' }));
+
+describe('ensurePeerDeps', () => {
+ const originalEnv = process.env;
+
+ beforeEach(() => {
+ jest.resetModules();
+ process.env = { ...originalEnv };
+ delete process.env.RNTL_SKIP_DEPS_CHECK;
+ });
+
+ afterEach(() => {
+ process.env = originalEnv;
+ });
+
+ it('should not throw when versions match', () => {
+ expect(() => require('../ensure-peer-deps')).not.toThrow();
+ });
+
+ it('should throw when react-test-renderer is missing', () => {
+ jest.mock('react-test-renderer/package.json', () => {
+ throw new Error('Module not found');
+ });
+
+ expect(() => require('../ensure-peer-deps')).toThrow(
+ 'Missing dev dependency "react-test-renderer@19.0.0"',
+ );
+ });
+
+ it('should throw when react-test-renderer version mismatches', () => {
+ jest.mock('react-test-renderer/package.json', () => ({ version: '18.2.0' }));
+
+ expect(() => require('../ensure-peer-deps')).toThrow(
+ 'Incorrect version of "react-test-renderer" detected. Expected "19.0.0", but found "18.2.0"',
+ );
+ });
+
+ it('should skip dependency check when RNTL_SKIP_DEPS_CHECK is set', () => {
+ process.env.RNTL_SKIP_DEPS_CHECK = '1';
+ jest.mock('react-test-renderer/package.json', () => {
+ throw new Error('Module not found');
+ });
+
+ expect(() => require('../ensure-peer-deps')).not.toThrow();
+ });
+});
diff --git a/src/helpers/ensure-peer-deps.ts b/src/helpers/ensure-peer-deps.ts
new file mode 100644
index 00000000..b06507bf
--- /dev/null
+++ b/src/helpers/ensure-peer-deps.ts
@@ -0,0 +1,37 @@
+function ensurePeerDeps() {
+ const reactVersion = getPackageVersion('react');
+ ensurePackage('react-test-renderer', reactVersion);
+}
+
+function ensurePackage(name: string, expectedVersion: string) {
+ const actualVersion = getPackageVersion(name);
+ if (!actualVersion) {
+ const error = new Error(
+ `Missing dev dependency "${name}@${expectedVersion}".\n\nFix it by running:\nnpm install -D ${name}@${expectedVersion}`,
+ );
+ Error.captureStackTrace(error, ensurePeerDeps);
+ throw error;
+ }
+
+ if (expectedVersion !== actualVersion) {
+ const error = new Error(
+ `Incorrect version of "${name}" detected. Expected "${expectedVersion}", but found "${actualVersion}".\n\nFix it by running:\nnpm install -D ${name}@${expectedVersion}`,
+ );
+ Error.captureStackTrace(error, ensurePeerDeps);
+ throw error;
+ }
+}
+
+function getPackageVersion(name: string) {
+ try {
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
+ const packageJson = require(`${name}/package.json`);
+ return packageJson.version;
+ } catch {
+ return null;
+ }
+}
+
+if (!process.env.RNTL_SKIP_DEPS_CHECK) {
+ ensurePeerDeps();
+}
diff --git a/src/index.ts b/src/index.ts
index 6649b662..426042f9 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,3 +1,4 @@
+import './helpers/ensure-peer-deps';
import './matchers/extend-expect';
import { getIsReactActEnvironment, setReactActEnvironment } from './act';
diff --git a/yarn.lock b/yarn.lock
index 4b5b106b..d1f5f68b 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2838,6 +2838,7 @@ __metadata:
"@release-it/conventional-changelog": "npm:^10.0.0"
"@relmify/jest-serializer-strip-ansi": "npm:^1.0.2"
"@types/jest": "npm:^29.5.14"
+ "@types/node": "npm:^22.13.8"
"@types/react": "npm:^19.0.0"
"@types/react-test-renderer": "npm:^19.0.0"
babel-jest: "npm:^29.7.0"
@@ -2851,10 +2852,10 @@ __metadata:
jest-matcher-utils: "npm:^29.7.0"
prettier: "npm:^2.8.8"
pretty-format: "npm:^29.7.0"
- react: "npm:^19.0.0"
+ react: "npm:19.0.0"
react-native: "npm:0.78.0"
react-native-gesture-handler: "npm:^2.23.1"
- react-test-renderer: "npm:^19.0.0"
+ react-test-renderer: "npm:19.0.0"
redent: "npm:^3.0.0"
release-it: "npm:^18.0.0"
typescript: "npm:^5.6.3"
@@ -3008,6 +3009,15 @@ __metadata:
languageName: node
linkType: hard
+"@types/node@npm:^22.13.8":
+ version: 22.13.8
+ resolution: "@types/node@npm:22.13.8"
+ dependencies:
+ undici-types: "npm:~6.20.0"
+ checksum: 10c0/bfc92b734a9dce6ac5daee0a52feccdf5dcb3804d895e4bc5384e2f4644612b8801725cd03c8c3c0888fb5eeb16b875877ac44b77641e0196dc1a837b1c2a366
+ languageName: node
+ linkType: hard
+
"@types/normalize-package-data@npm:^2.4.3":
version: 2.4.4
resolution: "@types/normalize-package-data@npm:2.4.4"
@@ -3031,7 +3041,16 @@ __metadata:
languageName: node
linkType: hard
-"@types/react@npm:*, @types/react@npm:^19.0.0":
+"@types/react@npm:*":
+ version: 19.0.10
+ resolution: "@types/react@npm:19.0.10"
+ dependencies:
+ csstype: "npm:^3.0.2"
+ checksum: 10c0/41884cca21850c8b2d6578b172ca0ca4fff6021251a68532b19f2031ac23dc5a9222470208065f8d9985d367376047df2f49ece8d927f7d04cdc94922b1eb34b
+ languageName: node
+ linkType: hard
+
+"@types/react@npm:^19.0.0":
version: 19.0.8
resolution: "@types/react@npm:19.0.8"
dependencies:
@@ -9261,7 +9280,7 @@ __metadata:
languageName: node
linkType: hard
-"react-test-renderer@npm:^19.0.0":
+"react-test-renderer@npm:19.0.0":
version: 19.0.0
resolution: "react-test-renderer@npm:19.0.0"
dependencies:
@@ -9273,7 +9292,7 @@ __metadata:
languageName: node
linkType: hard
-"react@npm:^19.0.0":
+"react@npm:19.0.0":
version: 19.0.0
resolution: "react@npm:19.0.0"
checksum: 10c0/9cad8f103e8e3a16d15cb18a0d8115d8bd9f9e1ce3420310aea381eb42aa0a4f812cf047bb5441349257a05fba8a291515691e3cb51267279b2d2c3253f38471