Building apps at a large company? Check out Ionic Enterprise


The Ionic CLI is your go-to tool for developing Ionic apps. You can follow CLI development on Github.


Please make sure latest Node 6 LTS and NPM 3+ are installed.

Then, install the CLI globally (you may need sudo):

$ npm install -g [email protected]

Getting Started

Start a new Ionic project using ionic start:

ionic start myNewProject tabs
cd ./myNewProject

This will create a new app named myNewProject. Once you cd into your project’s directory, a few new commands become available to you, such as serve:

ionic serve


Here is a full list of Ionic commands. You can also see the list on the command line with ionic --help.

Command Description
build Build web assets and prepare your app for any platform targets
docs Open the Ionic documentation website
generate Generate pipes, components, pages, directives, providers, and tabs (ionic-angular >= 3.0.0)
info Print system/environment info
link Connect your local app to Ionic
login Login with your Ionic ID
serve Start a local dev server for app dev/testing
signup Create an Ionic account
start Create a new project
telemetry Opt in and out of telemetry
upload Upload a new snapshot of your app
config get Print config values
config set Set config values
cordova build Build (prepare + compile) an Ionic project for a given platform
cordova compile Compile native platform code
cordova emulate Emulate an Ionic project on a simulator or emulator
cordova platform Manage Cordova platform targets
cordova plugin Manage Cordova plugins
cordova prepare Copies assets to Cordova platforms, preparing them for native builds
cordova resources Automatically create icon and splash screen resources
cordova run Run an Ionic project on a connected device
package build Start a package build
package download Download your packaged app
package info Get info about a build
package list List your cloud builds