/ionic-starter

Sample Ionic project to let you kick start your new project.

Primary LanguageJavaScript

Ionic Starter

Dependency Status devDependency Status

This project aims to let you start a new app as fast as possible.

Just clone it and you are ready to do ! Many boilerplate code is already written and most usefull libs are included. I'm trying to follow best practices with Angular & Ionic so it could be a good kick start :)

Feel free to open an issue for any question or suggestion you could have.

This application (mostly) follows the John Papa's style guide.

Getting started

  • install nodejs, npm, gulp, bower, cordova, ionic & sass (if not already done)
  • git clone git@github.com:loicknuchel/ionic-starter.git : clone this repo
  • cd ionic-starter : go to folder
  • bower install : install app dependencies
  • npm install : install build dependencies
  • ionic setup sass : use sass
  • ionic serve : start the app on your browser

For the impatients, you can run all these commands in one time : git clone git@github.com:loicknuchel/ionic-starter.git && cd ionic-starter && bower install && npm install && ionic setup sass && ionic serve

To run the app on your android device :

  • ionic platform add android : add android platform to the project
  • ionic resources : generate icon & splash-screen for project platforms
  • ionic run android : run your app !

Once again, in one command : ionic platform add android && ionic resources && ionic run android

Personnalize

As it's only a template project, you may want to change its name. For that, you just have to open :

  • config.xml (widget id, name, description & author)
  • www/index.html (title)
  • bower.json (name, homepage, author & description)
  • package.json (name & description)
  • ionic.project (name)

Used versions

  • Node v4.2.2 (node -v)
  • Cordova 5.4.0 (cordova -version)
  • Bower 1.7.0 (bower -v)
  • Angular 1.4.3 (see bower.json)
  • Ionic 1.2.0 (see bower.json)

Infos

Browser development

Android debug

Specific urls

Use these custom urls to open other apps using inappbrowser (org.apache.cordova.inappbrowser)

  • "tel:0123456789" => call this number
  • "sms:0123456789?body=coucou" => send sms to this number
  • "geo:lat,lon" => open google map to this geoloc
  • "mailto:toto@example.com" => send an email
  • "market:???"

see http://stackoverflow.com/questions/26271313/tel-sms-and-mailto-no-longer-working-in-android-after-upgrading-to-cordo

Other links