bundle-wizard

🧙‍♂️ bundle-wizard

This command line utility makes it very easy to create visualizations of the JS bundles that were fetched for any specific entry point of an app.

bundle-wizard simply takes a url and generates a visualization that shows you:

1. The JavaScript bundles that were loaded.
2. What percent of each part of that JS was actually used to render the page.

Example

Visualizing JS loaded by Reddit's mobile homepage:

Quick start

npx source-map-wizard

That's it! The wizard will walk you through the rest.

Optional command line arguments

url (initial argument)

To skip the first prompt, provide a url as an initial argument:

npx bundle-wizard nytimes.com

desktop flag

By default, bundle-wizard will analyze a mobile version of the site. To analyze the desktop version instead, pass the --desktop flag:

npx bundle-wizard --desktop

debug flag

If you'd like to see more logging and detailed error messages, add this flag.

npx bundle-wizard --debug

Requirements

1. Downloadable sourcemaps

   This utility downloads sourcemaps from the url you provide. This requires the sourcemaps to be publically available, or at least available on your network. You might need to point to a testing instead of production build, for instance, as some apps disable sourcemaps in production.

2. A local Chrome installation

   The wizard uses puppeteer-core to load coverage information from the provided url. This requires you to have a fairly up-to-date version of Chrome installed on your machine.

Credits

The core functionality of this library is provided by the awesome source-map-explorer.