The Ionic Framework command line utility makes it easy to start, build, run, and emulate Ionic apps. In the future, it will also have support for our mobile development services and tools that make Ionic even more powerful.
Use the ionic --help command for more detailed task information.
$ sudo npm install -g ionic$ ionic start myApp [template]There are three choices of templates:
- Side-Menu (sidemenu)
- Tabs (tabs)
- Blank (blank)
Command-line flags/options:
--app-name, -a ........................ Human readable name for the app (Use quotes around the name)
--id, -i .............................. Package name set in the <widget id> config, ie: com.mycompany.myapp
--no-cordova, -w ...................... Do not create an app targeted for Cordova
$ ionic serve$ ionic platform ios android$ ionic build ios$ ionic emulate ios$ ionic run iosUpdate Ionic library files, which are found in the www/lib/ionic directory.
$ ionic lib updateUsing Ionic's service, you can compile and package your project into an app-store ready app without requiring native SDKs on your machine.
$ ionic package debug androidThe third argument can be either debug or release, and the last argument can be either android or ios.
Ionic uses Cordova underneath, so you can also substitute Cordova commands to prepare/build/emulate/run, or to add additional plugins.
Note: we occasionally send anonymous usage statistics to the Ionic team to make the tool better.
By default, starter projects are hooked up to Ionic's precompiled CSS file, which is found in the project's www/lib/ionic/css directory, and is linked to the app in the head of the root index.html file. However, Ionic projects can also be customized using Sass, which gives developers and designers "superpowers" in terms of creating and maintaining CSS. Please follow these steps if you would like to use Sass for an Ionic project:
- Run
npm installfrom the working directory of an Ionic project. This will install the gulp.js build system and a few handy tasks, such as gulp-sass and gulp-minify-css. - Remove
<link href="proxy.php?url=https%3A%2F%2Fgithub.com%2Flib%2Fionic%2Fcss%2Fionic.css" rel="stylesheet">from the<head>of the rootindex.htmlfile. - Remove
<link href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fcss%2Fstyle.css" rel="stylesheet">from the<head>of the rootindex.htmlfile. - Add
<link href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fcss%2Fionic.app.css" rel="stylesheet">to the<head>of the rootindex.htmlfile. - In the
ionic.projectfile, add the JavaScript propertysass: trueto the object.