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

• Visual Studio Requirements
• VSCode Requirements
• Getting Started

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

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

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

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 how the Dependencies node in Solution Explorer shows 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.

Ionic uses Gulp 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

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 can:

1. Have a global installation of gulp, and run gulp build
2. Use the local installed version node_modules\.bin\gulp build
3. Use the npm script: 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.

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

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

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.