# @react-native/metro-config

> Metro configuration for React Native.

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

## Install

```sh
npm install @react-native/metro-config
pnpm add @react-native/metro-config
yarn add @react-native/metro-config
bun add @react-native/metro-config
```

## 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-03-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^22.13.0 \|\| ^24.3.0 \|\| >= 26.0.0 |
| Dependencies | 4 |
| Unpacked size | 6.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 126492 |
| Maintainers | react-native-bot, fb |
| Keywords | metro, config, react-native |

## Links

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

## Dependencies (4)

- [metro-config](https://npm.io/package/metro-config.md) ^0.87.0
- [metro-runtime](https://npm.io/package/metro-runtime.md) ^0.87.0
- [@react-native/js-polyfills](https://npm.io/package/@react-native/js-polyfills.md) 0.87.1
- [@react-native/metro-babel-transformer](https://npm.io/package/@react-native/metro-babel-transformer.md) 0.87.1

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 0.87.1 (latest) — 2026-08-26
- 0.88.0-rc.3 (next) — 2026-09-28
- 0.89.0-nightly-20260928-d7ff82ebe (nightly) — 2026-09-28
- 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-20260927-d7ff82ebe — 2026-09-27
- … 1178 more at https://npm.io/package/@react-native/metro-config/versions

## README

# @react-native/metro-config

[![npm]](https://www.npmjs.com/package/@react-native/metro-config) [![npm downloads]](https://www.npmjs.com/package/@react-native/metro-config)

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

Metro configuration for React Native. In React Native, your Metro config should extend either `@react-native/metro-config` or `@expo/metro-config`. These packages contain essential defaults necessary to build and run React Native apps.

See [Configuring Metro](https://reactnative.dev/docs/next/metro#configuring-metro) for the full guide.

## Usage

```js
const {
  getDefaultConfig,
  mergeConfig,
} = require('@react-native/metro-config');

/**
 * Metro configuration
 * https://metrobundler.dev/docs/configuration
 *
 * @type {import('metro-config').MetroConfig}
 */
const config = {};

module.exports = mergeConfig(getDefaultConfig(__dirname), config);
```

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