
react-native-web
React Native for Web
About
React Native for Web
Live mirror of the GitHub README. Updated whenever the repo's default branch changes.
Development monorepo
This is the development monorepo for "React Native for Web" and related projects.
Structure
.github- Contains workflows used by GitHub Actions.
- Contains issue templates.
configs- Contains configuration files used by the monorepo tooling (compiling, linting, testing, etc.)
packages- react-native-web
- Contains the individual packages managed in the monorepo.
scripts- Contains Node.js scripts for miscellaneous tasks.
Tasks
build- Use
npm run buildto run the build script in every package. - Use
npm run build -w <package-name>to run the build script for a specific package.
- Use
dev- Use
npm run devto run the dev script in every package. - Use
npm run dev -w <package-name>to run the dev script for a specific package.
- Use
test- Use
npm run testto run tests for every package.
- Use
More details can be found in the contributing guide below.
Contributing
Development happens in the open on GitHub and we are grateful for contributions including bugfixes, improvements, and ideas.
Code of conduct
This project expects all participants to adhere to Meta's OSS Code of Conduct. Please read the full text so that you can understand what actions will and will not be tolerated.
Contributing guide
Read the contributing guide to learn about the development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native for Web.
Good first issues
To help you get you familiar with the contribution process, there is a list of good first issues that contain bugs which have a relatively limited scope. This is a great place to get started.
Quick facts
npm install react-native-webCommon pairings
Packages this one expects to find in the same project. Each is also a Sourcemap Explorer detection target.
How Sourcemap Explorer detects react-native-web
We catch react-native-web from two complementary signals: bundled source paths and the embedded package.json. Modern bundlers (webpack, Vite, esbuild, Rollup, Turbopack) preserve the original node_modules/react-native-web/ paths inside the JavaScript sourcemap's sources[] array — that's the canonical signal. When the matching package.json is also captured in sourcesContent[], we read the exact version field — patch number included. No regex guessing, no version inference.
- 1
Confirm the site exposes sourcemaps
In DevTools Network, check the response headers of any application script for `SourceMap` or `X-SourceMap`. Failing that, fetch the script's last 4 KB and look for a `//# sourceMappingURL=` comment.
- 2
Find the package in the bundle
Open DevTools → Network → reload. Click any application script and look at its sourcemap. Inside, search `sources[]` for entries matching `node_modules/react-native-web/` — every match confirms the package is bundled. The matching `sourcesContent[i]` for `node_modules/react-native-web/package.json` gives you the exact installed version.
- 3
Read the version directly from package.json
Run `jq -r '. as $m | $m.sources | to_entries[] | select(.value | endswith("node_modules/react-native-web/package.json")) | $m.sourcesContent[.key] | fromjson | .version' bundle.js.map`. Sourcemap Explorer automates the same query in the popup.
Recent versions
FAQ
What is react-native-web used for?
React Native for Web
How can I tell if a website is using react-native-web?
Open the page in Chrome with the Sourcemap Explorer extension installed and read the Stack tab. We catch `react-native-web` from two complementary signals: `node_modules/react-native-web/` paths inside the JavaScript sourcemap, and the embedded `package.json` we read for exact-version detection. Without the extension you can do the same lookup manually in DevTools — the steps are listed in the "How Sourcemap Explorer detects" section above.
What is the latest version of react-native-web?
0.21.2, as published on the npm registry. The "Recent versions" table on this page lists the most recent 8 releases with their release dates. Sourcemap Explorer reports the version actually bundled into a site, which can lag the latest release by months on real-world deployments.
Where can I read more?
Project homepage: https://github.com/necolas/react-native-web#readme. Source code: https://github.com/necolas/react-native-web. Published on npm: https://www.npmjs.com/package/react-native-web. Licensed as MIT.
Keep reading on Sourcemap Explorer
Detection deep dives
Alternative tools
Detected by Sourcemap Explorer
When a bundle ships sourcemaps, we read the embedded package.json for react-native-web and report the precise version. Without sourcemaps, an import / require in the page's scripts is enough to flag it.