Created: 2014-05-19 14:22
Updated: 2014-05-30 20:10

Ionic App Base

A starting project for Ionic that optionally supports using custom SCSS.

Using this project

We recommend using the ionic utility to create new Ionic projects that are based on this project but use a ready-made starter template.

For example, to start a new Ionic project with the default tabs interface, make sure the ionic utility is installed:

$ sudo npm install -g ionic

Then run:

$ sudo npm install -g ionic
$ ionic start myProject tabs

More info on this can be found on the Ionic Getting Started page.


While we recommend using the ionic utility to create new Ionic projects, you can use this repo as a barebones starting point to your next Ionic app.

To use this project as is, first clone the repo from GitHub, then run:

$ cd ionic-app-base
$ sudo npm install -g cordova ionic gulp
$ npm install
$ gulp init

Using Sass (optional)

This project makes it easy to use Sass (the SCSS syntax) in your projects. This enables you to override styles from Ionic, and benefit from Sass's great features.

Just update the ./scss/ file, and run gulp or gulp watch to rebuild the CSS files for Ionic.

Note: if you choose to use the Sass method, make sure to remove the included ionic.css file in index.html, and then uncomment the include to your file which now contains all your Sass code and Ionic itself:

<!-- IF using Sass (run gulp sass first), then remove the CSS include above
<link href="css/" rel="stylesheet">


Issues have been disabled on this repo, if you do find an issue or have a question consider posting it on the Ionic Forum. Or else if there is truly an error, follow our guidelines for submitting an issue to the main Ionic repository. On the other hand, pull requests are welcome here!

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more