Back to Facebook Developer Docs

@react-native/community-cli-plugin

packages/community-cli-plugin/README.md

0.85.33.8 KB
Original Source

@react-native/community-cli-plugin

This is an internal dependency of React Native. Please don't depend on it directly.

CLI entry points supporting core React Native development features.

Formerly @react-native-community/cli-plugin-metro.

Commands

start

Start the React Native development server.

Usage

sh
npx @react-native-community/cli start [options]

Options

OptionDescription
--port <number>Set the server port.
--host <string>Set the server host.
--projectRoot <path>Set the path to the project root.
--watchFolders <list>Specify additional folders to be added to the watch list.
--assetPlugins <list>Specify additional asset plugins.
--sourceExts <list>Specify additional source extensions to bundle.
--max-workers <number>Set the maximum number of workers the worker-pool will spawn for transforming files. Defaults to the number of the cores available on your machine.
--transformer <string>Specify a custom transformer.
--reset-cacheRemove cached files.
--custom-log-reporter-path <string>Specify a module path exporting a replacement for TerminalReporter.
--httpsEnable HTTPS connections.
--key <path>Specify path to a custom SSL key.
--cert <path>Specify path to a custom SSL cert.
--config <string>Path to the CLI configuration file.
--no-interactiveDisable interactive mode.
--client-logs[Deprecated] Enable plain text JavaScript log streaming for all connected apps.

bundle

Build the bundle for the provided JavaScript entry file.

Usage

sh
npx @react-native-community/cli bundle --entry-file <path> [options]

Options

OptionDescription
--entry-file <path>Set the path to the root JavaScript entry file.
--platform <string>Set the target platform (either "android" or "ios"). Defaults to "ios".
--transformer <string>Specify a custom transformer.
--dev [boolean]If false, warnings are disabled and the bundle is minified. Defaults to true.
--minify [boolean]Allows overriding whether bundle is minified. Defaults to false if --dev is set. Disabling minification can be useful for speeding up production builds for testing purposes.
--bundle-output <string>Specify the path to store the resulting bundle.
--bundle-encoding <string>Specify the encoding for writing the bundle (https://nodejs.org/api/buffer.html#buffer_buffer).
--resolver-option <string...>Custom resolver options of the form key=value. URL-encoded. May be specified multiple times.
--sourcemap-output <string>Specify the path to store the source map file for the resulting bundle.
--sourcemap-sources-root <string>Set the root path for source map entries.
--sourcemap-use-absolute-pathReport SourceMapURL using its full path.
--max-workers <number>Set the maximum number of workers the worker-pool will spawn for transforming files. Defaults to the number of the cores available on your machine.
--assets-dest <string>Specify the directory path for storing assets referenced in the bundle.
--reset-cacheRemove cached files.
--read-global-cacheAttempt to fetch transformed JS code from the global cache, if configured. Defaults to false.
--config <string>Path to the CLI configuration file.

Contributing

Changes to this package can be made locally and tested against the rn-tester app, per the Contributing guide. During development, this package is automatically run from source with no build step.