# @react-native/community-cli-plugin

> Core CLI commands for React Native

Latest version **0.87.1** (published 2026-08-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @react-native/community-cli-plugin
pnpm add @react-native/community-cli-plugin
yarn add @react-native/community-cli-plugin
bun add @react-native/community-cli-plugin
```

## Health

**Score 75/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo; extremely popular.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.87.1 |
| Published | 2026-08-26 |
| First published | 2023-08-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^22.13.0 \|\| ^24.3.0 \|\| >= 26.0.0 |
| Dependencies | 6 |
| Unpacked size | 62.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 126779 |
| Maintainers | react-native-bot, fb |
| Keywords | react-native, tools |

## Links

- npm: https://www.npmjs.com/package/@react-native/community-cli-plugin
- Repository: https://github.com/react/react-native
- Homepage: https://github.com/react/react-native/tree/HEAD/packages/community-cli-plugin#readme
- Issues: https://github.com/react/react-native/issues
- npm.io page: https://npm.io/package/@react-native/community-cli-plugin

## Dependencies (6)

- [debug](https://npm.io/package/debug.md) ^4.4.0
- [metro](https://npm.io/package/metro.md) ^0.87.0
- [semver](https://npm.io/package/semver.md) ^7.1.3
- [invariant](https://npm.io/package/invariant.md) ^2.2.4
- [@react-native/asset-utils](https://npm.io/package/@react-native/asset-utils.md) 0.87.1
- [@react-native/dev-middleware](https://npm.io/package/@react-native/dev-middleware.md) 0.87.1

## Recent versions

- 0.87.1 (latest) — 2026-08-26
- 0.89.0-nightly-20261012-8566016ec (nightly) — 2026-10-12
- 0.88.0-rc.4 (next) — 2026-10-05
- 0.86.3 (0.86-stable) — 2026-08-24
- 0.83.10 (0.83-stable) — 2026-06-25
- 0.81.6 (0.81-stable) — 2026-02-05
- 0.80.3 (0.80-stable) — 2026-01-26
- 0.79.7 (0.79-stable) — 2025-10-21
- 0.77.3 (0.77-stable) — 2025-07-21
- 0.78.3 (0.78-stable) — 2025-07-09
- 0.76.9 (0.76-stable) — 2025-04-03
- 0.75.5 (0.75-stable) — 2025-02-06
- 0.74.89 (0.74-stable) — 2025-01-27
- 0.74.82 (false) — 2024-05-01
- 0.89.0-nightly-20261011-1c6e0c773 — 2026-10-11
- … 1183 more at https://npm.io/package/@react-native/community-cli-plugin/versions

## README

# @react-native/community-cli-plugin

[![npm]](https://www.npmjs.com/package/@react-native/community-cli-plugin) [![npm downloads]](https://www.npmjs.com/package/@react-native/community-cli-plugin)

[npm]: https://img.shields.io/npm/v/@react-native/community-cli-plugin.svg?color=blue
[npm downloads]: https://img.shields.io/npm/dm/@react-native/community-cli-plugin.svg

> 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](https://www.npmjs.com/package/@react-native-community/cli-plugin-metro).

## Commands

### `start`

Start the React Native development server.

#### Usage

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

#### Options

| Option | Description |
| - | - |
| `--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-cache` | Remove cached files. |
| `--custom-log-reporter-path <string>` | Specify a module path exporting a replacement for `TerminalReporter`. |
| `--https` | Enable 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-interactive` | Disable 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

| Option | Description |
| - | - |
| `--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-path` | Report `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-cache` | Remove cached files. |
| `--read-global-cache` | Attempt 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](https://reactnative.dev/contributing/overview#contributing-code). During development, this package is automatically run from source with no build step.

---
_Source: https://npm.io/package/@react-native/community-cli-plugin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
