lb-ngIonic

Kickstart Your Ionic Project with Nodejs LoopBack backend in seconds !

This project aims to let you start a new Hybrid cross platform app as fast as possible using Loopback-angular-admin backend.

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 [email protected]:denzelwamburu/lb-ngIonic.git : clone this repo
• cd lb-ngIonic : 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 [email protected]:denzelwamburu/lb-ngIonic.git && cd lb-ngIonic && 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

Before starting, makes sure you've followed Getting Started with LoopBack to install Node and LoopBack.

In adittion, you will need a basic understanding of:

• AngularJs
• Ionic CSS and Javascript components

Main features

• User authentication with Social Authentication
• Rest Apis
• Material Design 🎉
• Error handling & async remote logger
• Angular wrappers & browser mocks for plugins :
  • org.apache.cordova.device (ngCordova)
  • org.apache.cordova.dialogs (ngCordova)
  • https://github.com/EddyVerbruggen/Toast-PhoneGap-Plugin (ngCordova)
  • org.apache.cordova.inappbrowser (ngCordova)
  • org.apache.cordova.geolocation
  • org.apache.cordova.camera
  • https://github.com/EddyVerbruggen/SocialSharing-PhoneGap-Plugin
  • org.apache.cordova.media
  • https://github.com/loicknuchel/cordova-device-accounts

Server

This is an Ionic Mobile client for loopback-angular-admin using loopback as a backend.

Set up the server or clone the repo.

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)
• app/services.js (Api-Url, generated lb-service based on your backend)

Used versions

• Node v5.4.1 (node -v)
• Cordova 6.1.1 (cordova -version)
• Bower 1.7.2 (bower -v)
• Angular 1.3.13 (see bower.json)
• Ionic 1.0.0-rc.5 (see bower.json)

TODO

• Offline Caching
• Push

Contributing

• Feel Free to Open an issue and ask any questions. You can email me [email protected]
• Be awesome and make a pull request.
• Be Super awesome to Star This project.
• Checkout The CONTRIBUTING Documentation.

Credits

• Ionic Starter by loicknuchel.
• loopback-angular-admin
• loopback-example-ionic