README.md

Generator-M-Ionic

Development:

Why you need it

Build mobile Cordova/PhoneGap apps quickly with the tools you love: Yeoman, Gulp, Bower, AngularJS, Ionic & of course Cordova. All in one sexy generator.

What's in the box

Introduction

• More on: Why you need it
• More on: What's in the box

Quick Start

• Quick Start for the experienced developer.
• Try the demo. Get a quick impression by cloning the sample project generated with the latest version of Generator-M-Ionic.

Get started

• Installation and Prerequisites
• Development Introduction
• File structure

Guides

Generation

• Using Ionic's CSS or SASS?
• Sub-generators for adding new components.

App Development

• Developing on Windows, what you need to know.
• Git integration, see how it's done.
• SASS integration in our module concept.
• Bower Component Usage in our module concept.
• Gulp defaults, spare power users some tedious typing on the command line.

Quality

• ESLint code style checks and setting up your IDE/Editor.
• Testing with our testing workflows.

Continuous Integration and Delivery

• App Icons and splash screens, a simple setup or different sets for different builds - all is possible.
• Use Environments manage different API Endpoints and much more with just a single parameter.
• Build Vars, inject vars into your app at build time.
• Programmatically change the config.xml, an essential part for a successful continuous integration setup. Add environments and build vars for a full blown continuous integration use case!

Generator Insights

We've published 3 blog articles on our company blog delivering deep insights into the why and how of the generator:

• September 2015: Generator-M-Ionic and the search for the holy grail
  • rather technical comparison between the generator and similar tools as well as technical insights to the decisions and motivation behind the generator
• September 2015: Generator-M-Ionic: HTML5 mobile app development evolved
  • provides insight to the technology choices and ecosystem and the benefits of using the generator
• March 2015: Generator-M: the state of HTML5 mobile app development at M-Way
  • the origins of the generator development and company strategy

Questions, Issues? Talk to us!

Do the following:

1. check out our FAQ and issues see if there already is a solution or answer to that matter.
2. ask other developers and our core team on gitter if you're not sure how to proceed.
3. If all fails create a new issue.

• Important: we and others can help you a lot quicker if you provide a sample repo that we can clone. With step by step instructions on how to reproduce your error.

Want to contribute?

Start by reading our:

1. Mission Statement
2. Contribution Guide

License

Code licensed under MIT. Docs under Apache 2. PhoneGap is a trademark of Adobe.