# pod-install
> A fast, zero-dependency package for cutting down on common issues developers have when running pod install.
Latest version **1.1.0** (published 2026-06-25) · MIT license · 0 weekly downloads
## Install
```sh
npm install pod-install
pnpm add pod-install
yarn add pod-install
bun add pod-install
```
Provides the command `pod-install`.
## Health
**Score 65/100 (B)** — status: active.
Positive: no vulnerabilities; recently updated; high maintenance score; popular repo; extremely popular.
Warnings: low downloads; no types; no esm support.
## Facts
| | |
|---|---|
| Version | 1.1.0 |
| Published | 2026-06-25 |
| First published | 2020-03-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 205.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 52336 |
| Author | Expo |
| Maintainers | ide, brentvatne, expoadmin, exponent, bycedric, kudochien, alanhughes, tsapeta, expo-bot, philpl, wschurman, evanbacon |
| Keywords | cocoapods, pod-install, npx, ios |
## Links
- npm: https://www.npmjs.com/package/pod-install
- Repository: https://github.com/expo/expo
- Homepage: https://github.com/expo/expo/tree/main/packages/pod-install
- Issues: https://github.com/expo/expo/issues
- npm.io page: https://npm.io/package/pod-install
## Recent versions
- 1.1.0 (latest) — 2026-06-25
- 1.2.0 (next) — 2026-09-10
- 1.1.1-canary-20260909-ea7a89a (canary) — 2026-09-09
- 1.2.0-canary-20260701-9100865 (canary-sdk-56) — 2026-07-01
- 1.0.20 (sdk-55) — 2026-06-25
- 1.0.16-canary-20260429-a5e59cf (canary-sdk-55) — 2026-04-29
- 0.2.2 (sdk-51) — 2024-04-24
- 0.2.0 (sdk-50) — 2023-12-12
- 0.1.19-alpha.0 (alpha) — 2021-02-18
- 1.1.1-canary-20260908-e343e6e — 2026-09-08
- 1.1.1-canary-20260902-26df09e — 2026-09-02
- 1.1.1-canary-20260901-2164f24 — 2026-09-02
- 1.1.1-canary-20260812-27f94d4 — 2026-08-12
- 1.1.1-canary-20260806-8c2d007 — 2026-08-06
- 1.1.1-canary-20260805-ccd18b9 — 2026-08-05
- … 237 more at https://npm.io/package/pod-install/versions
## README
👋 Welcome to
pod-install
A fast, zero-dependency package for cutting down on common issues developers have when running pod install.
## 🚀 Usage
```sh
npx pod-install
```
👋 **Notice:** This package is not limited to native React projects, you can use it with any iOS or Xcode project using CocoaPods (like Ionic, or Flutter).
## 🤔 Why?
All native packages (especially those installed with NPM) often need to explain the following:
- What is CocoaPods.
- What is gem.
- How to install CocoaPods.
- `cd` into the proper directory before running `pod install`.
- You may need run `pod repo update` to fix your project.
- Why CocoaPods requires a darwin machine.
But now you can simply instruct users to run `npx pod-install`.
This package will do the following:
- Check if the machine is darwin.
- If not then it'll quit with a helpful error message.
- Ensure CocoaPods CLI is installed on the machine.
- If not then it'll try to install CocoaPods CLI, first with gem, then with homebrew.
- Check if there is an Xcode project in the current directory
- If not then it'll try again in `ios/` than `macos/` directories (if any exists).
- Run `pod install`
- If `pod install` fails because the repo is out of date, then it'll run `pod repo update` and try again.
## ⚙️ Options
For more information run `npx pod-install --help` (or `-h`)
| Flag | Input | Description | Default |
| ------------------- | ----------- | --------------------------------------------- | ---------------------- |
| `--non-interactive` | `[boolean]` | Skip prompting to install CocoaPods with sudo | `process.stdout.isTTY` |
| `--quiet` | `[boolean]` | Only print errors | `false` |
## License
The Expo source code is made available under the [MIT license](LICENSE). Some of the dependencies are licensed differently, with the BSD license, for example.
---
_Source: https://npm.io/package/pod-install · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._