Version: v5

bundle

bundle or webpack-bundle is a command-line tool that builds the bundle for the provided project.

Usage

In the root of an existing project, run this command in your terminal of choice:

npm
yarn
pnpm
bun
npm run react-native bundle

Options

INFO

To stay compatible with the @react-native-community/cli command, the following flags are included but are not functional:

  • --config-cmd

--entry-file

  • Type: string

Path to the root JS file, either absolute or relative to JS root.

--platform

  • Type: string
  • Default: "ios"

Either "ios" or "android".

--dev

  • Type: boolean
  • Default: true

Enables development warnings and disables production optimizations.

--minify

  • Type: boolean

Allows overriding whether bundle is minified. This defaults to false if dev is true, and true if dev is false. Disabling minification can be useful for speeding up production builds for testing purposes.

--bundle-output

  • Type: string

File name where to store the resulting bundle, ex. /tmp/groups.bundle.

--sourcemap-output

  • Type: string

File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map.

--assets-dest

  • Type: string

Directory name where to store assets referenced in the bundle.

--json

  • Type: string

Stores stats in a file.

--stats

  • Type: string

Instructs Rspack on how to treat the stats. Use with --json to store stats in a file.

  • 'errors-only' - only output when errors happen
  • 'errors-warnings' - only output errors and warnings happen
  • 'minimal' - only output when errors or new compilation happen
  • 'none' - output nothing
  • 'normal' - standard output
  • 'verbose' - output everything
  • 'detailed' - output everything except chunkModules and chunkRootModules
  • 'summary' - output webpack version, warnings count and errors count

Example:

npm
yarn
pnpm
bun
npm run react-native bundle --stats summary --json ./stats.json

More details: Rspack documentation

--reset-cache

  • Type: boolean

Resets the transformation cache.

--verbose

  • Type: boolean

Enables verbose logging.

--watch

  • Type: boolean
  • Default: false

Watch for file changes.

--config

  • Type: string

Path to a bundler config file, e.g rspack.config.js.

--webpackConfig

  • Type: string
  • Deprecated: Use --config instead

Path to a bundler config file, e.g webpack.config.js.

-h,--help

Display help for command.