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
$ 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 install
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/ionic.app.scss file, and run
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
ionic.app.css 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/ionic.app.css" rel="stylesheet"> -->
To update to a new version of Ionic, open bower.json and change the version listed there.
For example, to update from version
1.0.0-beta.5, open bower.json and change this:
After saving the update to bower.json file, run
Alternatively, install bower globally with
npm install -g bower and run
Using the Nightly Builds of Ionic
If you feel daring and want use the bleeding edge 'Nightly' version of Ionic, change the version of Ionic in your bower.json to this:
Warning: the nightly version is not stable.
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!