react-native-bundle-visualizer

See what's inside of your react-native bundle 📦

Uses the awesome source-map-explorer to visualize the output of the Metro bundler.

Purpose

Sometimes, importing a single javascript library can drastically increase your bundle size. This package helps you to identify such a library, so you can keep the bundle size low and loading times fast.

Usage

Make sure npx is installed and run the following command in your project root

npx react-native-bundle-visualizer@2

And when using Expo SDK 40 or lower. Learn more: Expo extensions.

npx react-native-bundle-visualizer@2 --expo managed

Or install as a dev-dependency

yarn add --dev react-native-bundle-visualizer@2

And run it:

yarn run react-native-bundle-visualizer@2

or when using npm:

npm install --save-dev react-native-bundle-visualizer@2 ./node_modules/.bin/react-native-bundle-visualizer

Command line arguments

All command-line arguments are optional. By default a production build will be created for the ios platform.

Option	Description	Example
platform	Platform to build (default is ios)	--platform ios
expo	(Deprecated in SDK 41+) Expo target, managed or bare. Ensures that the project is bundled with expo settings and that .expo.* extensions are used.	--expo bare
dev	Dev or production build (default is false)	--dev false
entry-file	Entry-file (when omitted tries to auto-resolve it)	--entry-file ./index.ios.js
bundle-output	Output bundle-file (default is tmp)	--bundle-output ./myapp.bundle
format	Output format html, json or tsv (default is html) (see source-map-explorer options)	--format json
only-mapped	Exclude "unmapped" bytes from the output (default is false). This will result in total counts less than the file size.	--only-mapped
verbose	Dumps additional output to the console (default is false)	--verbose
reset-cache	Removes cached react-native files (default is false)	--reset-cache

Usage with older react-native versions and the Haul bundler

As of react-native-bundle-visualizer version 2.x, the direct output of the Metro bundler is visualized using the source-map-explorer.

Prior to version 2, the Haul bundler was used which used Webpack. If you are having problems visualizing the output for older react-native versions, or you want to explicitly use the Haul bundler, please check out the V1 documentation.

License

MIT