[![Build Status][circle-badge]][circle-badge-url]
[![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=ionic-team/ionic-cli)](https://dependabot.com)
[![npm][npm-badge]][npm-badge-url]

# Ionic CLI

The Ionic command line interface (CLI) is your go-to tool for developing [Ionic][ionic-homepage] apps.

### Installation

```
npm install -g ionic
```

Detailed installation instructions can be found in the [CLI documentation](https://ionicframework.com/docs/installation/cli).

### Usage

The Ionic CLI ships with command documentation, accessible in your terminal by using the `--help` flag. These docs are also available [online][ionic-cli-docs].

* For a list of commands:

```
ionic --help
ionic cordova --help
ionic capacitor --help
```

* For command usage and a list of options:

```
ionic start --help
ionic serve --help
ionic cordova run --help
```

---

:book: **Documentation**: [https://ionicframework.com/docs/cli][ionic-cli-docs]

:mega: **Support/Questions?** Please see our [Support Page][ionic-support] for general support questions. The issues on GitHub should be reserved for bug reports and feature requests.

:sparkling_heart: **Want to contribute?** Please see [CONTRIBUTING.md](https://github.com/ionic-team/ionic-cli/blob/develop/CONTRIBUTING.md). 

[ionic-homepage]: https://ionicframework.com
[ionic-cli-docs]: https://ionicframework.com/docs/cli
[ionic-support]: https://ionicframework.com/support

[circle-badge]: https://circleci.com/gh/ionic-team/ionic-cli.svg?style=shield
[circle-badge-url]: https://circleci.com/gh/ionic-team/ionic-cli
[npm-badge]: https://img.shields.io/npm/v/ionic.svg
[npm-badge-url]: https://www.npmjs.com/package/ionic