As of March 2019, this repo is no longer maintained by Microsoft. If you're interested in continuing this project, please feel free to fork it. As of March 2019, we will no longer monitor or respond to open issues. Thanks for your support!

---

Ionic 2 Blank Template with TypeScript

Note. This template is based on Ionic 2 Beta 10.

A template to create Ionic 2 apps with Visual Studio tools for Apache Cordova using TypeScript

Table of Contents

• Visual Studio Requirements
• VSCode Requirements
• Getting Started

Visual Studio Requirements

• Visual Studio 2015 Update 3
• Tools for Apache Cordova Update 10
• Microsoft ASP.Net and WebTools
• NPM Task Runner

VSCode Requirements

• A recent version of Node/NPM
• A global installed version of Cordova,Ionic, and TypeScript npm packages: npm i -g cordova ionic@beta typescript

Getting Started

Once you have your first project based on this template/repo created, you should follow the next steps:

Restore Npm Packages

VSCode will depend on you to execute npm install from the root folder.

Visual Studio should start the restore process as soon the project is opened. You should see the Dependencies node in Solution Explorer show a message saying "Restoring..". You can always invoke the restore process manually with RightClick->Restore Packages

To verify that the packages are completely restored you can check that the folder www\build contains some folders.

Note. Visual Studio shows the restore log in the Output Window Ctrl+Alt+O under the Npm/Bower category.

Run Ionic App Scripts

Ionic uses Ionic App Scripts to perform some tasks like Sass, and TypeScript compilation to process your source code and produce the output in the www folder.

Visual Studio 2015 includes a Task Runner Explorer that will show you all the available tasks to execute from the UI. You can access the Task Runner Explorer from the Menu: View->Other Windows-Task Runner Explorer or with the shortcut Ctrl+Alt+Bkspce. Ensure that you've installed the NPM Task Runner (.vsix) which adds support for npm scripts defined in package.json directly in Visual Studio's Task Runner Explorer.

Note: To ensure that the default tasks are executed before the VS build, we configured the Task Runner Explorer binding the default task to the BeforeBuild event, however you can customize this setting to match your needs (e.g. Binding watch to project opened)

To execute this tasks from the CLI you manually run: npm run build

Note: If VS is unable to show the tasks, you can check the log in the Ouput window under the Task Runner Explorer Logs category.

Usual Cordova development Workflow

Once you have all the packages restored, and the Gulp tasks executed, you can use your favorite cordova workflow:

• Cordova Getting Started
• Ionic Getting Started

Live Reload

Ionic cli offers the ionic serve command to implement a Live Reload development workflow, you can obtain similar results executing the gulp task watch and using the Live Reload capabilities of the Ripple Emulator

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.