Click here to Skip to main content
15,908,674 members
Articles / Programming Languages / Typescript

Gulp Your TypeScript in ASP.NET 5

Rate me:
Please Sign up or sign in to vote.
5.00/5 (4 votes)
7 Jan 2015CPOL3 min read 19.4K   3   3
var disqus_identifier = 'GulpYourTypeScript'; If you have done any typescript development in Visual Studio in previous versions, you more than like are using the Web Essentials add in to perform the compilation to Javascript.

If you have done any typescript development in Visual Studio in previous versions, you more than like are using the Web Essentials add in to perform the compilation to Javascript. Another option is to add a gulp task now that we have gulp and grunt support within Visual Studio. The other value add is if you are a non Visual Studio user this solution works just the same.

Project Creation

In Visual Studio 2015, File > New Project > ASP.NET Web Application > ASP.NET 5 Empty
Image 1

or using the ASP.NET Yeoman Generator

$ yo aspnet 

    |       |    .--------------------------.
    |--(o)--|    |      Welcome to the      |
   `---------´   |   marvellous ASP.NET 5   |
    ( _´U`_ )    |        generator!        |
    /___A___\    '--------------------------'
     |  ~  |     
 ´   `  |° ´ Y ` 

? What type of application do you want to create? MVC Application
? What's the name of your ASP.NET application? (MvcApplication) GulpTypeScript

Adding Gulp

Add a package.json file.

Image 2

or using the ASP.NET Yeoman Generator

$ yo aspnet:PackageJSON

Within package.json you will need to add the dependencies to support gulp.

  • gulp: Core gulp.js package
  • gulp-tsc: TypeScript compliler for gulp
  • gulp-shell: command line interface, can execute other processes etc.
  • run-sequence: run a series of tasks
    "version": "0.0.1",
    "name": "GulpTypeScript",
    "devDependencies": {
        "gulp": "^3.8.5", 
        "gulp-tsc": "^0.9.1", 
        "gulp-shell": "^0.2.5",
        "del": "~1.1.1"

Unlike nuget (project.json > dependencies node), the npm packages are not automatically restored/downloaded once the package.json is saved. You can either expand the "Dependencies" node in the Solution Explorer and click "Restore Packages" or from a command line type npm install.

Restore Packages

after npm install completes...

packages restored

Adding the gulpfile.js

Using Visual Studio, Add New Item > JavaScript File > "gulpfile.js" or again using the aspnet Yeoman generator:

$ yo aspnet:JScript gruntfile

Adding the tasks

In this example, we'll put in a few simple tasks

  • build
  • clean
  • default
  • rebuild

the most important item being the build task as this is where the TypeScript compilation happens.

First declare the vars and dependencies...

var gulp = require('gulp'),
    tsc = require('gulp-tsc'),
    shell = require('gulp-shell'),
    seq = require('run-sequence'),
    del = require('del');

Next, set the source (src) and destination (dest) paths for your scripts...

var paths = {
     ts: {
         src: [
         dest : 'scripts'

Here, set the "default" task to be run

// Default
 gulp.task('default', ['build']);

A clean task is defined to delete any javascript files that were compiled to the destination location.

// Clean
  gulp.task('clean', function (cb) {
      del(paths.ts.dest + '/*.js', cb);

Next, a rebuild task is defined to execute the clean then build sequetiallly. You can use gulp.start('clean', 'build') but there is no guarantee what order the tasks will execute or complete in. So in that case the run-sequence npm package is used here.

// ReBuild - Clean & Build
gulp.task('rebuild', function (cb) {
    seq('clean', 'build', cb);

Finally, the build task. Here the TypeScript compiler is leveraged using the gulp-tsc npm package passing in the arguments from the source location and producing the compiled JavaScript to the destination.

// Build
gulp.task('build', function () {
    return gulp
            module: "CommonJS",
            sourcemap: true,
            emitError: false

For demo purposes, just grabbed the "Simple Inheritance" example from and created "animal.ts" in the /scripts/ts folder.

class Animal {  
    constructor(public name: string) { }
    move(meters: number) {
        alert( + " moved " + meters + "m.");

class Snake extends Animal {  
    constructor(name: string) { super(name); }
    move() {

class Horse extends Animal {  
    constructor(name: string) { super(name); }
    move() {

var sam = new Snake("Sammy the Python");  
var tom: Animal = new Horse("Tommy the Palomino");


Now in order to produce the JavaScript, there are a few options as mentioned before.

  • Use Web Essentials
  • Open the command line, now that we have defined the gulp tasks, and type gulp [task name]
  • Task Runner Explorer

Command Line

Pretty simple here, as mdentioned above, open your console in your working directoy

$ gulp build

Output will be similar to (Windows)

C:\Github\GulpTypeScript\src\GulpTypeScript>gulp build  
[16:58:08] Using gulpfile C:\Github\GulpTypeScript\src\GulpTypeScript\gulpfile.js
[16:58:08] Starting 'build'...
[16:58:08] Compiling TypeScript files using tsc version null
[16:58:09] Finished 'build' after 1.01 s

on OSX

$ gulp build
[17:00:43] Using gulpfile ~/GulpTypeScript/gulpfile.js
[17:00:43] Starting 'build'...
[17:00:43] Compiling TypeScript files using tsc version null
[17:00:43] Finished 'build' after 848 ms

The output goes right to /scripts as expected.
output js

Bonus Task

Edit 01.05.2015 - Someone asked me was there a way to watch for file changes to recompile. Here is the task to add using the .watch() functionality of grunt.

gulp.task('watch', function () {, ['build']);

This task watches for file changes in the src directory, then executes the build task. You could optionally put in multiple tasks or call any existing task.

Task Runner Explorer

In Visual Studio 2015, there is now Task Runner Explorer which gives you a visual look into your tasks. This supports grunt and gulp. Here is a shot of the window after running the build task.

Image 6


On Windows you may encounter a strange error when executing the tasks. This is an issue when you have multiple versions of TypeScript installed.

The error: Failed to compile TypeScript: Error: Command failed: Cannot initialize ActiveScript
Image 7

There is an easy fix, just go to to C:\Program Files(x86)\Microsoft SDKs\TypeScript
and remove the previous versions.
Image 8


There is a lot more you can add to the grunt file as you may or may not know, there are minification, image optimization and a ton more. I like the way of gulp as it allows for the non VS and Visual Studio developers to put together the code in the same manner. Not to toss out Web Essentials, cause that is an awesome add-in and there would be many of features not in VS without it.


This article was originally posted at


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
United States United States
I work on Azure, ASP.NET Core content and Open Source, speak at national and community events while helping teams architect web and cloud applications.

Comments and Discussions

QuestionVote of 5! Just one question! Pin
Member 1048631816-May-15 12:30
Member 1048631816-May-15 12:30 
AnswerRe: Vote of 5! Just one question! Pin
Shayne P Boyer17-May-15 6:53
Shayne P Boyer17-May-15 6:53 
Sure, you can use uglify to do that task.

var uglify = require('gulp-uglify');
gulp.task('compress', function() {
  return gulp.src('lib/*.js')

Shayne Boyer (@spboyer)
TattooCoder - make and impression with your code

GeneralMy vote of 5 Pin
Member 1048631816-May-15 12:27
Member 1048631816-May-15 12:27 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.