Ionic apps are created and developed primarily through the Ionic command-line utility. The Ionic CLI is the preferred method of installation, as it offers a wide range of dev tools and help options along the way. It is also the main tool through which to run the app and connect it to other services, such as Ionic Pro.
Install the Ionic CLI
Before proceeding, make sure the latest version of Node.js and npm are installed. See Environment Setup for details. Install the Ionic CLI globally with npm:
npm install -g ionic
-gmeans it is a global install. For Window’s it's recommended to open an Admin command prompt. For Mac/Linux, run the command with
Start an App
Create an Ionic app using one of the pre-made app templates, or a blank one to start fresh. The three most common starters are the
tabs starter, and
sidemenu starter. Get started with the
ionic start command:
ionic start myApp tabs --type=angular
Ionic 4 beta requires the
--type=angularflag and version 4.0.0 or greater of the CLI.
To learn more about starting Ionic apps, see the Starting Guide.
Run the App
The majority of Ionic app development can be spent right in the browser using the
ionic serve command:
cd myApp ionic serve
There are a number of other ways to run an app, it's recommended to start with this workflow. To develop and test apps on devices and emulators, see the Running an App Guide.