Summary:
This PR adds the missing test coverage for the standalone Fusebox debugger shell in `StandaloneFuseboxShell-test`.
First, I added some missing expectation for the success case (`enableStandaloneFuseboxShell=true` and no errors) already present:
- the assertion that `unstable_prepareFuseboxShell` is called just one time during middleware initialization
- the assertion that `launchDebuggerAppWindow` is never called when the standalone shell is available
Then, I added the missing test for the case when `unstable_prepareFuseboxShell` returns one of the error code like eg. `platform_not_supported` (as reported also in the TODO that I removed).
In this way now the test is verifying the full behaviour for the new standalone mode for debugger/dev tools.
## Changelog:
[GENERAL] [CHANGED] - Added missing tests for Standalone fusebox shell
Pull Request resolved: https://github.com/facebook/react-native/pull/55460
Test Plan:
- Ran `StandaloneFuseboxShell-test` and verify all tests cases passed
- Ran the full React Native test suite to ensure all tests pass.
- Verified test correctness by intentionally breaking production code:
- removing the calls to the `DefaultBrowserLauncher` in `openDebuggerMiddleware` to verify that the tests were correctly failing
Reviewed By: Abbondanzo
Differential Revision: D93157076
Pulled By: huntie
fbshipit-source-id: 51c12ad67dd929035f779b53add9163a6619cf41
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55728
Fixes unwanted side effect launches of the debugger shell in tests (likely introduced in D88161573!).
Also adds error guard on `DefaultAppLauncher` to ensure that the implementation is always mocked.
Changelog: [Internal]
Reviewed By: vzaidman
Differential Revision: D94230761
fbshipit-source-id: 966f6f09c38aa55594091bd7d34a5c78dc6eee93
Summary:
Renames the **"BrowserLauncher"** concept (`unstable_browserLauncher`) to **"DevToolLauncher"** (`unstable_toolLauncher`), since the scope is now widened to open the desktop debugger shell by default.
Also rename and remove `unstable_` prefixes for `launchDebuggerShell` and `prepareDebuggerShell` methods (APIs remain unstable on the root option key).
**Why not `DebuggerLauncher`?**
This naming remains wide enough to cover other host process delegation in future (e.g. opening other secondary tools, or opening a generic URL in the browser). Debugger launching methods remain specifically named to match their intent.
Changelog: [Internal]
Reviewed By: vzaidman
Differential Revision: D94218654
fbshipit-source-id: e59d5465f200666cd0f1a189414f2223f5e46f69
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55549
**Context**
Clean up the legacy `rn_inspector.html` entry point. React Native DevTools has been the default since 0.76, and we have now removed all internal dependencies at Meta.
**This diff**
- Remove `prefersFuseboxFrontend` metadata from `unstable_eventReporter` API.
Changelog: [Internal]
Reviewed By: vzaidman
Differential Revision: D93247602
fbshipit-source-id: 278f847433259c98deb121562e34a12ff59058a2
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55548
**Context**
Clean up the legacy `rn_inspector.html` entry point. React Native DevTools has been the default since 0.76, and we have now removed all internal dependencies at Meta.
We've verified that Reanimated (`react-native-worklets`) also do not depend on this workflow, and documents `chrome://inspect` instead.
**This diff**
- Launching the debugger will no longer check for the `prefersFuseboxFrontend` capability flag (internal contract with the debugger server).
- The modern `rn_fusebox.html` entry point will always be used.
Changelog: [Internal]
Reviewed By: vzaidman
Differential Revision: D93247604
fbshipit-source-id: 1c7b6838d9105c9206ffc0030374dc1ee559a6dd
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55574
Upgrade the undici devDependency in react-native/dev-middleware from ^5.29.0 to ^6.23.0 to address security vulnerabilities. undici v6 drops the fastify/busboy dependency and requires Node.js >= 18, which is already satisfied by the engine requirements. The API surface used (Agent, request) remains compatible.
this is low risk, because it's only used in a test.
Changelog: [Internal]
Reviewed By: robhogan
Differential Revision: D93298172
fbshipit-source-id: be623702ebec1bd494c862f9c7990580f6b3cc4d
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55285
Changelog: [GENERAL] [CHANGED] - `createDevMiddleware` now accepts `string | URL` for `serverBaseUrl`
Replaces the serverBaseUrl string type with a native URL object across the Metro CLI and Gateway packages.
This change improves type safety and makes URL manipulation more robust by leveraging the built-in URL API instead of string concatenation.
The public createDevMiddleware API has been updated to accept either a string or URL for the serverBaseUrl option.
Internally within the dev-middleware package, the internal APIs (InspectorProxy, openDebuggerMiddleware, getDevToolsFrontendUrl) use URL objects instead of strings.
https://www.npmjs.com/package/react-native/dev-middleware
Reviewed By: vzaidman
Differential Revision: D90987090
fbshipit-source-id: ec5b8faa4ed5c24b489c3d63f7b6030073be5403
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55237
Adds multi-session support to the Node side of the inspector-proxy protocol implementation. The protocol now has an explicit `sessionId` property in all relevant messages.
Multi-session support is fully backwards compatible:
* An app that does not report itself as multi-session capable will get the old proxy behaviour.
* If the `enableStandaloneFuseboxShell` experiment flag is disabled by the integrator/framework, we automatically disable multi-session support, too. This is to guarantee that we continue to have at most one active RNDT window/tab open per app. (The standalone shell guarantees this independently of the proxy, while the old browser-based flow requires the proxy to keep enforcing the single-session UX.)
Changelog: [General][Added] Support multiple CDP connections to one React Native Host (diff 2 of 2)
Reviewed By: robhogan
Differential Revision: D90174643
fbshipit-source-id: b277cf2777d2018c44252dc4eae7b197e51cfb79
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55238
Adds multi-session support to the inspector-proxy protocol, specifically to the C++ `InspectorPackagerConnection` class that implements the "device" side of the protocol.
Changelog: [General][Added] Support multiple CDP connections to one React Native Host (diff 1 of 2)
Reviewed By: hoxyq
Differential Revision: D90174642
fbshipit-source-id: b22946aaa5a6f3d2d4a81cbfe81d371ea2bc0632
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55268
Allow WS debugger connection to origin from debugger url.
Also notify the user on Metro if a connection is rejected.
Changelog: [General][Fixed] - Reaching Metro from Debugger on urls other than localhost:8081 and 127.0.0.1:8081.
Reviewed By: robhogan, yungsters
Differential Revision: D91130956
fbshipit-source-id: 107dbc78aa60b888325f5c6dca68cc28f4e6af52
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55235
Use of Node's `url.parse` is deprecated and emits a runtime warning (when used in 1P code) from Node 24.
This wouldn't directly affect RN users, but does create noise running from monorepo source.
Changelog: [Internal]
Reviewed By: GijsWeterings
Differential Revision: D90992431
fbshipit-source-id: d53e2837cd13bba3fbb24302c5916038ae0e5a50
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55114
Our official [docs](https://reactnative.dev/docs/set-up-your-environment#node--watchman) require:
> Node 20.19.4 or newer
Currently, our `package.json#engines` fields express this as `"node": ">= 20.19.4"`
This is a bit imprecise because of Node's overlapping release lines - e.g. v24.0.0 is actually older than v20.19.4 (2025-07-15), and the whole v21 line was already EOL before v20.19.4.
The release *date* is relevant because Node.js frequently backports the most important updates - notably, `require(esm)` is already stable in Node 20.19 but is not unflagged in v22 until v22.12.
This makes the `package.json#engines` requirement truer to the documented requirement, dropping some old minors and EOL majors that prevent us using features included in v20.19.
Notably, `require(esm)` is stable and unflagged on all versions supported from this diff.
- v21 and v23 are EOL, so are dropped.
- v22.13 pre-dates 20.19.4 and is the first to have unflagged silent `require(esm)`
- v24.3.0 pre-dates 20.19.4 and is the first to unflag TS-stripping
- Support v25 and newer.
Changelog:
[General][Breaking] Drop support for EOL Node.js lines and old minors.
Reviewed By: cortinico, huntie
Differential Revision: D90467358
fbshipit-source-id: a5fdfb1b93a9d6cffe78eb6811ff7420ab906f44
Summary:
Related to https://github.com/facebook/react-native/issues/54669
This version bump drops `rimraf`.
This has been raised at a sync before, but it'd be great to instead drop or replace this entirly. I also noticed that it pulls in `types/node@*`, which isn't necessary for it to function as well, and generally, it'd be nice if we had an alternative here.
cc huntie
## Changelog:
[GENERAL] [SECURITY] - Bump to `chromium-edge-launcher@^0.3.0` to drop `rimraf`
Pull Request resolved: https://github.com/facebook/react-native/pull/54711
Test Plan: - Package hasn't changed except for `rimraf` having been dropped
Reviewed By: huntie, cortinico
Differential Revision: D87978681
Pulled By: robhogan
fbshipit-source-id: b761493f677f9cd4008d3fda584dd04de40c0845
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55075
It's been >1y since we introduced this notice (and introduced the `--client-logs` flag) — clean up.
Changelog:
[General][Changed] - Remove "JavaScript logs have moved!" notice from dev server CLI
Reviewed By: hoxyq
Differential Revision: D90247471
fbshipit-source-id: dc13c90476c65c301bdb3a51db91f0e5fe0b326b
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/55008
Changelog: [Internal] removed an unstable function briefly added in #54447
This was previously added in https://github.com/facebook/react-native/pull/54447, but not needed anymore as we found a different way to get this information without exposing a special API for that.
Reviewed By: robhogan
Differential Revision: D89962175
fbshipit-source-id: 3636ef8815678781ee39ef8211f00bde69b5ce63
Summary:
### Motivation
Updates the shared JavaScript build setup to use the modern `publishConfig` convention.
This:
- Simplifies the build script.
- Makes the production values for `"exports"` more understandable in place (especially by separating from exports conditions).
- Prevents us from creating a dirty file state when running `yarn build`.
### Changes
- Add `publishConfig` to each `package.json` listing production `"exports"` targets.
- Add `scripts/build/prepack.js` script to action `publishConfig` (now on `npm pack`, `npm publish` exclusively).
- Remove `"exports"` rewriting (and un-rewriting safeguards) from build script.
**Note on `"prepack"`**
Slightly unfortunately, `publishConfig` doesn't work consistently between package managers currently, including npm — so this does not work implicitly (but may in future).
We're instead following `publishConfig` as a convention, and explicitly implementing a full copy (theoretically forking us towards pnpm and Yarn v4's approach).
However, I believe this is:
- Worthwhile, for the motivations above — and in particular being able to understand the final shape of `"exports"` (independent from the dimension of conditional exports, which may come into play later).
- Completely inspectable/maintainable as an explicit implementation (`scripts/build/prepack.js`).
Changelog: [Internal]
Pull Request resolved: https://github.com/facebook/react-native/pull/54857
Test Plan:
### CI
✅ GitHub Actions
### End-to-end release test script
(Note: Rebased on `0.83-stable` when tested)
```
yarn test-release-local -t "RNTestProject" -p "iOS" -c $GITHUB_TOKEN
```
{F1984106139}
✅ Test script runs `npm publish` on packages to a local proxy.
{F1984106146}
✅ Installed packages have `publishConfig` `"exports"` values applied
NOTE: ⬆️ This is **exactly** the same output as before.
{F1984106148}
✅ `/tmp/RNTestProject` runs using built + proxy-published + proxy-installed packages
Reviewed By: cipolleschi
Differential Revision: D88963450
Pulled By: huntie
fbshipit-source-id: f328252cf93a1f1039b79d7f369d1e6e7e5b4b52
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/54528
Changelog: [Internal]
Currently, `DefaultBrowserLauncher.js` holds arguments configuring how the debugger shell is launched. Instead, move some of them downstream, and make `DefaultBrowserLauncher.js` use the defaults.
Reviewed By: motiz88
Differential Revision: D86772692
fbshipit-source-id: 826bb6236dc3cba3c4b0d455aebf3f81c4e8ed6f
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/54447
Changelog: [Internal]
Expose `unstable_hasConnectedDevices` and `unstable_addHasConnectedDevicesListener` from both `InspectorProxy` and `DevMiddleware` that tells the user if any devices are connected to `devMiddleware` and allows to listen to whenever this state changes.
Reviewed By: motiz88
Differential Revision: D86319965
fbshipit-source-id: 18a30138b16a41821dc17a63e9d9cada04888f34
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/54754
Enables the standalone app shell for React Native DevTools by default.
We preserve + document this flag as an opt-out (allowing Frameworks to override this behaviour if needed).
Changelog: [Internal]
Reviewed By: motiz88
Differential Revision: D88161573
fbshipit-source-id: 64ee191dcead4e639bb3067bc9e715b1c8cdf80d
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/54634
CI fails after attempting to update to Node v24 (latest LTS) because our `dev-middleware` dev-only dependency `selfsigned` uses a default key size incompatible with the version of OpenSSL in Node>=24.5. We see lots of:
```
error:0A00018F:SSL routines::ee key too small
```
This was mitigated in OSS CI by pinning our Node tests to before v24.5: https://github.com/facebook/react-native/pull/53013
This default is raised upstream in https://github.com/jfromaniello/selfsigned/commit/bf687c80cfe125b7051c7b2f07e321289c037993 , this bumps to v4 which includes that fix, and removes the temporary mitigation above.
Changelog:
[Internal]
Reviewed By: cipolleschi
Differential Revision: D87643898
fbshipit-source-id: f1072c0801769d5fcd4bb53f68999653c6dad29f
Summary:
Pull Request resolved: https://github.com/facebook/react-native/pull/54009
Packages haven't been bumped on main ahead of 0.83. This takes care of it.
Changelog:
[Internal] [Changed] -
Reviewed By: cipolleschi, huntie
Differential Revision: D83580515
fbshipit-source-id: 7471e77f74e3fb3b4ee6538a49369b5df1393098