# native-run

> A CLI for running apps on iOS/Android devices and simulators/emulators

Latest version **2.0.3** (published 2026-01-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install native-run
pnpm add native-run
yarn add native-run
bun add native-run
```

Provides the command `native-run`.

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 2.0.3 |
| Published | 2026-01-08 |
| First published | 2018-08-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=16.0.0 |
| Dependencies | 11 |
| Unpacked size | 2.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 137 |
| Author | Ionic Team |
| Maintainers | ionicjs, brandyscarney, gm-os, jcesarmobile, kensodemann, vmfo, devinshoemaker, jpender, itschaced, john_ionic, mark-ionic, jpender-os, harvdoggy, eric-ionic, capacitor-plugin-bot, jaredcbaum, trevorlambert, benmccarty-os, alexgerardojacinto, rui.mendes, os-pedrobilro, ndr, os-ruialves, maxlynch |
| Keywords | android, ios, cli, mobile, app, hybrid, native |

## Links

- npm: https://www.npmjs.com/package/native-run
- Repository: https://github.com/ionic-team/native-run
- Homepage: https://github.com/ionic-team/native-run#readme
- Issues: https://github.com/ionic-team/native-run/issues
- npm.io page: https://npm.io/package/native-run

## Dependencies (11)

- [ini](https://npm.io/package/ini.md) ^4.1.1
- [debug](https://npm.io/package/debug.md) ^4.3.4
- [plist](https://npm.io/package/plist.md) ^3.1.0
- [tslib](https://npm.io/package/tslib.md) ^2.6.2
- [yauzl](https://npm.io/package/yauzl.md) ^2.10.0
- [split2](https://npm.io/package/split2.md) ^4.2.0
- [through2](https://npm.io/package/through2.md) ^4.0.2
- [elementtree](https://npm.io/package/elementtree.md) ^0.1.7
- [bplist-parser](https://npm.io/package/bplist-parser.md) ^0.3.2
- [@ionic/utils-fs](https://npm.io/package/@ionic/utils-fs.md) ^3.1.7
- [@ionic/utils-terminal](https://npm.io/package/@ionic/utils-terminal.md) ^2.3.4

## Alternatives

- [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads
- [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads
- [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads
- [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads
- [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads

## Recent versions

- 2.0.3 (latest) — 2026-01-08
- 0.2.9-testing.2 (testing) — 2019-10-12
- 2.0.2 — 2026-01-07
- 2.0.1 — 2024-01-25
- 2.0.0 — 2023-10-26
- 1.7.4 — 2023-10-24
- 1.7.3 — 2023-09-21
- 1.7.2 — 2023-03-02
- 1.7.1 — 2022-09-23
- 1.7.0 — 2022-09-01
- 1.6.0 — 2022-05-16
- 1.5.0 — 2021-10-11
- 1.4.1 — 2021-09-03
- 1.4.0 — 2021-06-08
- 1.3.1 — 2021-06-04
- … 42 more at https://npm.io/package/native-run/versions

## README

[![github-actions](https://img.shields.io/github/actions/workflow/status/ionic-team/native-run/ci.yml?branch=develop&style=flat-square)](https://github.com/ionic-team/native-run/actions?query=workflow%3ACI)
[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](https://github.com/semantic-release/semantic-release)
[![npm](https://img.shields.io/npm/v/native-run.svg?style=flat-square)](https://www.npmjs.com/package/native-run)

# native-run

`native-run` is a cross-platform command-line utility for running native app binaries (`.ipa` and `.apk` files) on iOS and Android devices. It can be used for both hardware and virtual devices.

This tool is used by the Ionic CLI, but it can be used standalone as part of a development or testing pipeline for launching apps. It doesn't matter whether the `.apk` or `.ipa` is created with Cordova or native IDEs, `native-run` will be able to deploy it.

## Install

`native-run` is written entirely in TypeScript/NodeJS, so there are no native dependencies.

To install, run:

```
npm install -g native-run
```

:memo: Requires NodeJS 16+

## Usage

```
native-run <platform> [options]
```

See the help documentation with the `--help` flag.

```
native-run --help
native-run ios --help
native-run android --help
```

### Troubleshooting

Much more information can be printed to the screen with the `--verbose` flag.

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