# @lingui/metro-transformer

> Metro transformer that compiles Lingui message catalogs on the fly in React Native and Expo apps

Latest version **6.12.0** (published 2026-11-03) · MIT license · 0 weekly downloads

## Install

```sh
npm install @lingui/metro-transformer
pnpm add @lingui/metro-transformer
yarn add @lingui/metro-transformer
bun add @lingui/metro-transformer
```

## Health

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

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

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 6.12.0 |
| Published | 2026-11-03 |
| First published | 2024-10-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=22.19.0 |
| Dependencies | 3 |
| Unpacked size | 13.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 5932 |
| Author | Vojtech Novak |
| Maintainers | andrii.bodnar, serhiydmytryshyn |
| Keywords | lingui, linguijs, metro, react-native, expo, i18n, message-catalog, localization, bundler, transformer |

## Links

- npm: https://www.npmjs.com/package/@lingui/metro-transformer
- Repository: https://github.com/lingui/js-lingui
- Homepage: https://lingui.dev
- Issues: https://github.com/lingui/js-lingui/issues
- npm.io page: https://npm.io/package/@lingui/metro-transformer

## Dependencies (3)

- [@lingui/cli](https://npm.io/package/@lingui/cli.md) 6.12.0
- [memoize-one](https://npm.io/package/memoize-one.md) ^6.0.0
- [@lingui/conf](https://npm.io/package/@lingui/conf.md) 6.12.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 6.12.0 (latest) — 2026-11-03
- 6.0.0-next.4 (next) — 2026-04-17
- 5.1.2 (canary) — 2024-12-16
- 6.11.0 — 2026-10-29
- 6.10.1 — 2026-10-22
- 6.10.0 — 2026-10-16
- 6.9.1 — 2026-10-09
- 6.9.0 — 2026-10-01
- 6.8.0 — 2026-09-23
- 6.7.0 — 2026-09-11
- 6.6.0 — 2026-07-24
- 6.5.0 — 2026-07-06
- 6.4.0 — 2026-06-16
- 6.3.0 — 2026-06-10
- 6.2.0 — 2026-06-01
- … 38 more at https://npm.io/package/@lingui/metro-transformer/versions

## README

[![License][badge-license]][license]
[![Version][badge-version]][package]
[![Downloads][badge-downloads]][package]

# @lingui/metro-transformer

> Metro transformer that compiles Lingui message catalogs on the fly in React Native and Expo apps

`@lingui/metro-transformer` is part of [Lingui][documentation]. Lingui is a lightweight, open-source internationalization (i18n) library for JavaScript and TypeScript. It brings compile-time macros and a CLI for message extraction to React, React Native, Vue, SolidJS, Astro, Svelte, and Node.js.

The transformer lets a React Native or Expo app import `.po` files directly instead of running `lingui compile`.

## Usage

See the [React Native tutorial][tutorial] and the [Metro transformer reference][reference].

## License

This package is licensed under the [MIT][license] license.

[license]: https://github.com/lingui/js-lingui/blob/main/LICENSE
[documentation]: https://lingui.dev
[tutorial]: https://lingui.dev/tutorials/react-native
[reference]: https://lingui.dev/ref/metro-transformer
[package]: https://www.npmjs.com/package/@lingui/metro-transformer
[badge-downloads]: https://img.shields.io/npm/dw/@lingui/metro-transformer.svg
[badge-version]: https://img.shields.io/npm/v/@lingui/metro-transformer.svg
[badge-license]: https://img.shields.io/npm/l/@lingui/metro-transformer.svg

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