# @react-native-community/cli-platform-apple

> This package is part of the [React Native CLI](../../README.md). It contains utilities for building reusable commands targeting Apple platforms.

Latest version **20.2.0** (published 2026-06-25) · MIT license · 0 weekly downloads

## Install

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

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 20.2.0 |
| Published | 2026-06-25 |
| First published | 2023-12-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 221.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2935 |
| Maintainers | bartoszklonowski, titozzz, empyrical, cpojer, mattoakes, ferrannp, mike866, krizzu, trensik, thymikee, nicholaslee119, mmazzarolo, rewieer, janicduplessis, swaagie, kelset, johandutoit, vonovak, wojteg1337, naturalclar, connectdotz, pvinis, brentvatne, evanbacon, eliwhite, simek, alloy, cortinico, safaiyeh, dmitryrykun, lunaleaps, wootwootwoot, react-native-bot, szymonrybczak, react-native-community-bot, okwasniewski |

## Links

- npm: https://www.npmjs.com/package/@react-native-community/cli-platform-apple
- Repository: https://github.com/react-native-community/cli
- Homepage: https://github.com/react-native-community/cli/tree/main/packages/cli-platform-apple
- Issues: https://github.com/react-native-community/cli/issues
- npm.io page: https://npm.io/package/@react-native-community/cli-platform-apple

## Dependencies (5)

- [execa](https://npm.io/package/execa.md) ^5.0.0
- [picocolors](https://npm.io/package/picocolors.md) ^1.1.1
- [fast-xml-parser](https://npm.io/package/fast-xml-parser.md) ^5.3.6
- [@react-native-community/cli-tools](https://npm.io/package/@react-native-community/cli-tools.md) 20.2.0
- [@react-native-community/cli-config-apple](https://npm.io/package/@react-native-community/cli-config-apple.md) 20.2.0

## Recent versions

- 20.2.0 (latest) — 2026-06-25
- 17.0.1 (17.x) — 2025-11-05
- 18.0.1 (18.x) — 2025-11-05
- 19.1.2 (19.x) — 2025-11-05
- 20.0.0-alpha.2 (next) — 2025-07-24
- 16.0.3 (16.x) — 2025-04-17
- 14.1.2 (14.x) — 2024-12-12
- 20.1.3 — 2026-03-24
- 20.1.2 — 2026-02-24
- 20.1.1 — 2026-01-28
- 20.1.0 — 2026-01-07
- 20.0.2 — 2025-09-09
- 20.0.1 — 2025-08-20
- 20.0.0 — 2025-08-11
- 19.1.1 — 2025-07-24
- … 52 more at https://npm.io/package/@react-native-community/cli-platform-apple/versions

## README

# @react-native-community/cli-platform-apple

This package is part of the [React Native CLI](../../README.md). It contains utilities for building reusable commands targeting Apple platforms.

## Installation

```sh
yarn add @react-native-community/cli-platform-apple
```

## Usage

This package is intended to be used internally in [React Native CLI](../../README.md) and by out of tree platforms.

It exports builder commands that can be used to create custom `run-`, `log-` and `build-` commands for example: `yarn run-<oot-platform>`.

Inside of `<oot-platform>/packages/react-native/react-native.config.js`:

```js
const {
  getBuildOptions,
  createBuild,
} = require('@react-native-community/cli-platform-apple');

const buildVisionOS = {
  name: 'build-visionos',
  description: 'builds your app for visionOS platform',
  func: createBuild({platformName: 'visionos'}),
  examples: [
    {
      desc: 'Build the app for visionOS in Release mode',
      cmd: 'npx react-native build-visionos --mode "Release"',
    },
  ],
  options: getBuildOptions({platformName: 'visionos'}),
};

module.exports = {
  commands: [buildVisionOS], // <- Add command here
  //..
};
```

`cli-platform-apple` also exports utilities to create OOT platform config.

- `getProjectConfig()` - creates project config for given platform
- `getDependencyConfig()` - creates dependency config for given platform

Example (`<oot-platform>/packages/react-native/react-native.config.js`):

```js
platforms: {
    visionos: {
      npmPackageName: '@callstack/react-native-visionos',
      projectConfig: getProjectConfig({platformName: 'visionos'}),
      dependencyConfig: getDependencyConfig({platformName: 'visionos'}),
    },
    ..
  },
```

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