/Ionic-TypeScript-Starter

:iphone: Platform and IDE agnostic starter project for building mobile apps with Ionic and TypeScript.

Primary LanguageTypeScriptMIT LicenseMIT

Ionic/TypeScript Starter

Build Status

This is a sample project that I use as a starting point for developing new mobile applications. This starter project targets iOS, Android, Chrome (as an extension), and the web.

It uses the Ionic framework (version 1.x, built on AngularJS 1.x) which makes it possible to rapidly build apps that feel native.

The project is written primarily in TypeScript, which decreases development time and increases maintainability (with object oriented and type-safe code, compile-time checking, and IDE tooling such as refactoring and code completion).

This project is IDE and platform agnostic. I recommend using the free and lightweight Visual Studio Code editor, as it has superb support for TypeScript.

In-browser development and debugging is possible via the Chrome developer tools. When deployed to a physical device, the application runs in the Cordova application container.

If you are developing on Windows or Linux but want to compile and run your application on a remote OS X machine, you can use the built-in gulp emulate-ios-remote task.

Documentation

Documentation is available in the docs directory, or online at the project website.

Quick Start

Install Node.js 4.4.0

All other dependencies are installed in the project directory via npm. To use them, you must add ./node_modules/.bin to your path.

To begin, edit your path, clone the repository, install the node packages, and initialize the development environment.

$ PATH=$PATH:./node_modules/.bin
$ git clone https://github.com/Justin-Credible/Ionic-TypeScript-Starter.git
$ cd Ionic-TypeScript-Starter
$ npm install
$ gulp init

Your environment should now be ready for development! If you encounter errors, check out the full guide to getting started.