Getting Started

    You have three options to install SERENE template:

    Serene .NET Framework version (ASP.NET MVC 4) requires Visual Studio 2017 or Visual Studio 2015 with Update 3 installed.

    If you have Visual Studio 2015, please make sure that you have Update 3 installed by looking at Help => About

    Serene ASP.NET Core 2.0 version only works in Visual Studio 2017, or using command line.

    As of writing, the recommended version of TypeScript is 2.5.2.

    Even though Serene uses NodeJS based TypeScript compiler (tsc) on build, Visual Studio still uses its own version of TypeScript for intellisense and refactoring etc. If you have an older version of that extension, you’ll be greeted with many errors as soon as you open a Serene project.

    To check what version of TypeScript Visual Studio Extension you have, again see Help => About:

    VS2015 TypeScript Extension

    Visual Studio 2017 comes with TypeScript 2.1.5 by default, but Visual Studio 2015 might include older versions.

    If you have something lower than 2.3.4 there, you might need to install TypeScript for Visual Studio extension.

    TypeScript versions after 1.8.6 requires Visual Studio 2015 Update 3 to be installed first, so even if you try to install the extension it will raise an error, so please first install Update 3.

    You can get TypeScript extension for your Visual Studio version from http://www.typescriptlang.org/#download-links.

    Here is the link for Visual Studio 2015:

    But don’t click the download button right away. Expand Details section, and select the exact version you need (e.g. 2.5.2):

    Latest version of TypeScript might probably work but keeping in sync with the version we currently use, can help you avoid compatibility problems that could come with them.

    Serene uses NodeJS / NPM for these:

    • TypeScript compiler itself (tsc)
    • Less compilation (lessjs)
    • T4 Code generation by parsing TypeScript sources

    It requires NodeJS v6.9+ and NPM 3.10+

    Serene will check their versions on project creation and ask for confirmation to download and install them. Anyway, please check your versions manually by opening a command prompt:

    If you get an error, they might not be installed or not in path. Please install LTS (long term support) versions from

    Even if you have correct Node / NPM installed, Visual Studio might still be trying to use its own integrated, and older version of NodeJS.

    Click Tools => Options, and then under Projects and Solutions => External Web Tools add C:\Program Files\nodejs to the top of the list by clicking plus folder icon, typing C:\Program Files\nodejs and using Up Arrow to move it to the start:

    VS External Tools Path