Getting Started with Ionic

Build mobile apps faster with the web technologies you know and love.

Questions? Head over to our Community Forum to chat with others using the framework.

Start building with Ionic!

Follow these quick steps and start building high quality mobile apps in minutes. For a more indepth overview, watch our Crash Course video, which covers everything else you'd want to know.

Install Ionic

First, install Node.js. Then, install the latest Cordova and Ionic command-line tools. Follow the Android and iOS platform guides to install required platform dependencies. Windows users might want to watch this installation video (or try Vagrant below).

We also have a Vagrant package for an all-in-one setup (experimental).

Note: iOS development requires Mac OS X. iOS simulator through the Ionic CLI requires the ios-sim npm package, which can be installed with the command sudo npm -g install ios-sim.

$ npm install -g cordova ionic

Start a project

Create an Ionic project using one of our ready-made app templates, or a blank one to start fresh.

$ ionic start myApp tabs
$ ionic start myApp blank
$ ionic start myApp tabs
$ ionic start myApp sidemenu

Run it

Use the Ionic tool to build, test, and run your apps (or use Cordova directly). Make sure to substitute ios with android to build for Android.

Then, try Ionic View to share your apps with testers and clients, or to easily test on new devices.

$ cd myApp
$ ionic platform add ios
$ ionic build ios
$ ionic emulate ios

Yep, it's that easy. You might be wondering what's next...

Ionitron suggests you head over to the Docs for an overview of Ionic's CSS and Javascript components. Make sure to join the Forum and enter your email below for Ionic updates: