<commit_before>[![Build Status][circle-badge]][circle-badge-url]
[![npm][npm-badge]][npm-badge-url]

# Ionic CLI

The Ionic Framework command line utility makes it easy to start, build, run,
and emulate [Ionic](http://ionicframework.com/) apps.

Use the `ionic help` command for more detailed task information.

**Support/Questions?**: Please see our [Support
Page](http://ionicframework.com/support) for general support questions. The
issues on GitHub should be reserved for bug reports and feature requests.

## Requirements

* Node 6+
* npm 3+

## Install

```bash
$ npm install -g ionic@beta
```

*Note: For a global install of `-g ionic`, OSX/Linux users may need to prefix
the command with `sudo` or can setup [proper file permissions on OSX for
npm](http://www.johnpapa.net/how-to-use-npm-global-without-sudo-on-osx/) to
install without `sudo`.*

## Changes from CLI 2

We have rewritten the CLI from the ground up.  Our main focus was to:

1. Decrease the amount of time to the first **start** execution
1. Improve the responsiveness of every CLI command
1. Make the architecture flexible for future platform support (PWA, electron, etc.)
1. Provide better **help**, more guidance, and more feedback when executing commands.

In doing so we decided to take a new approach to the CLI's structure. The base
CLI installation now ships with global commands that are common to all Ionic
apps.

Cordova commands have been namespaced and put into a CLI _plugin_, which is
installed by default with new Ionic projects and can be installed in existing
Ionic projects with `npm i --save @ionic/cli-plugin-cordova`. For full details,
see below.

Here is a brief summary of changes in CLI 3. For more details and reasoning,
see [CHANGELOG.md](https://github.com/driftyco/ionic-cli/blob/v3/CHANGELOG.md).

* Removed commands: `setup`, `share`, `lib`, `io`, `security`, `push`,
  `package`, `config`, `service`, `add`, `remove`, `list`, `hooks`, `state`.
* Added commands: `signup`.
* Cordova commands have been namespaced (e.g. `ionic cordova build`, not `ionic
  build`).
* Many command arguments, options, and flags have changed. Please use `ionic
  help <commands>` for command usage.
* `generate` command has been overhauled to interactively generate components,
  pages, etc.

#### Upgrading from a previous beta release to beta7

You will need to install the newly updated CLI globally and execute the
following command in your Ionic project directory.

```bash
$ npm install -g ionic@beta
$ npm uninstall --save-dev @ionic/cli-plugin-core @ionic/cli-build-ionic-angular
$ npm install --save-dev @ionic/cli-plugin-cordova @ionic/cli-plugin-ionic-angular
```

#### Latest beta release versions

 - ionic@3.0.0-beta7
 - @ionic/cli-plugin-cordova@0.0.12
 - @ionic/cli-plugin-ionic-angular@0.0.6
 - @ionic/cli-plugin-ionic1@0.0.6

## Ionic Framework - Using CLI 3

### Start a new project
```bash
$ npm install -g ionic@beta
$ ionic start myNewProject
```

### Existing project

```bash
$ npm install -g ionic@beta
$ npm install --save-dev @ionic/cli-plugin-ionic-angular@beta @ionic/cli-plugin-cordova@beta
$ ionic help
```

## Ionic 1 - Using CLI 3

### Start a new project

```bash
$ npm install -g ionic@beta
$ ionic start myNewProject blank --type ionic1
```

### Existing project

```bash
$ npm install -g ionic@beta
$ npm install --save-dev @ionic/cli-plugin-ionic1@beta @ionic/cli-plugin-cordova@beta
$ ionic help<commit_msg>chore(): ionic framework -> ionic-angular<commit_after>[![Build Status][circle-badge]][circle-badge-url]
[![npm][npm-badge]][npm-badge-url]

# Ionic CLI

The Ionic Framework command line utility makes it easy to start, build, run,
and emulate [Ionic](http://ionicframework.com/) apps.

Use the `ionic help` command for more detailed task information.

**Support/Questions?**: Please see our [Support
Page](http://ionicframework.com/support) for general support questions. The
issues on GitHub should be reserved for bug reports and feature requests.

## Requirements

* Node 6+
* npm 3+

## Install

```bash
$ npm install -g ionic@beta
```

*Note: For a global install of `-g ionic`, OSX/Linux users may need to prefix
the command with `sudo` or can setup [proper file permissions on OSX for
npm](http://www.johnpapa.net/how-to-use-npm-global-without-sudo-on-osx/) to
install without `sudo`.*

## Changes from CLI 2

We have rewritten the CLI from the ground up.  Our main focus was to:

1. Decrease the amount of time to the first **start** execution
1. Improve the responsiveness of every CLI command
1. Make the architecture flexible for future platform support (PWA, electron, etc.)
1. Provide better **help**, more guidance, and more feedback when executing commands.

In doing so we decided to take a new approach to the CLI's structure. The base
CLI installation now ships with global commands that are common to all Ionic
apps.

Cordova commands have been namespaced and put into a CLI _plugin_, which is
installed by default with new Ionic projects and can be installed in existing
Ionic projects with `npm i --save @ionic/cli-plugin-cordova`. For full details,
see below.

Here is a brief summary of changes in CLI 3. For more details and reasoning,
see [CHANGELOG.md](https://github.com/driftyco/ionic-cli/blob/v3/CHANGELOG.md).

* Removed commands: `setup`, `share`, `lib`, `io`, `security`, `push`,
  `package`, `config`, `service`, `add`, `remove`, `list`, `hooks`, `state`.
* Added commands: `signup`.
* Cordova commands have been namespaced (e.g. `ionic cordova build`, not `ionic
  build`).
* Many command arguments, options, and flags have changed. Please use `ionic
  help <commands>` for command usage.
* `generate` command has been overhauled to interactively generate components,
  pages, etc.

#### Upgrading from a previous beta release to beta7

You will need to install the newly updated CLI globally and execute the
following command in your Ionic project directory.

```bash
$ npm install -g ionic@beta
$ npm uninstall --save-dev @ionic/cli-plugin-core @ionic/cli-build-ionic-angular
$ npm install --save-dev @ionic/cli-plugin-cordova @ionic/cli-plugin-ionic-angular
```

#### Latest beta release versions

 - ionic@3.0.0-beta7
 - @ionic/cli-plugin-cordova@0.0.12
 - @ionic/cli-plugin-ionic-angular@0.0.6
 - @ionic/cli-plugin-ionic1@0.0.6

## Ionic-Angular - Using CLI 3

### Start a new project
```bash
$ npm install -g ionic@beta
$ ionic start myNewProject
```

### Existing project

```bash
$ npm install -g ionic@beta
$ npm install --save-dev @ionic/cli-plugin-ionic-angular@beta @ionic/cli-plugin-cordova@beta
$ ionic help
```

## Ionic 1 - Using CLI 3

### Start a new project

```bash
$ npm install -g ionic@beta
$ ionic start myNewProject blank --type ionic1
```

### Existing project

```bash
$ npm install -g ionic@beta
$ npm install --save-dev @ionic/cli-plugin-ionic1@beta @ionic/cli-plugin-cordova@beta
$ ionic help
{'fraction_non_alphanumeric': 0.11835608480975893, 'fraction_numerical': 0.008713331397037467, 'mean_word_length': 4.269319051262433, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 6, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6140096', 'n_tokens_mistral': 2278, 'n_tokens_neox': 2052, 'n_words': 837}