Nacho Portmanteau Meltdown
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


0.0.9 • Public • Published


Build Status npm npm Dependency Status

Yeoman generator for ASP.NET vNext projects with additional templates

This repo will remain a full working version from the upstream sync to omnisharp/generator-aspnet

Additional Templates:

  • Starter Web - Foundation 5



Getting Started

  • Install: npm i -g generator-aspnet-xtianus
  • Run: yo aspnet-xtianus

Remember to always yo aspnet-xtianus for this fork


  • yo aspnet-xtianus shows a wizard for generating a new ASP.NET app

  • yo aspnet-xtianus --gulp generates gulp.js files for web template instead of grunt.js

  • yo aspnet-xtianus --help shows flags and other configurable options

Template projects

Full, template based projects available in generator:

  • Empty Application
  • Console Application
  • Web Application
  • Starter Web Application - Foundation 5 Readme
  • Web API Application
  • Nancy ASP.NET Application
  • Class Library

Looking to build or add templates to this repo - feel free to help - contact below for more info

Starter Web - Foundation 5 Info

Yeoman generator for Zurb Foundation 5. & for Visual Studio ASP.Net Vnext Integration

Important notes:

  • F5 template places additonal files & folder structures in your project
  • Folder [app] & [dist] for static html mockup and protyping
  • Folder [includes] for _header.cshtml & _footer.cshtml - partials for _Layouts.cshtml
  • Files .jshintrc, .editorconfig & index.html included
  • Reworked gruntfile.js for a complete frontend development methodology

Default option here will be Sass with Libsass (for now). But you can choose Ruby version on startup.

From Foundation 5.5+: "Foundation is now compatible with Sass 3.4! Note: this removes Sass 3.2 compatability." Foundation 5 Changelog

Yo ASP.Net Foundation 5 Features!

  • Sass compiling
  • Font Awesome (option)
  • Jade templating engine (option)
  • Publishing to dist directory
  • Server with LiveReload ( for *.html
  • Server k web (Windows localhost:5001) or k kestrel (OSX, Linux localhost:5004) for *.cshtml
  • Bower install
  • JSHint

Grunt tasks:

run project (compile Jade, compile Sass, bower install, livereload (server on, watch)

$ grunt

publishing project (into dist directory) (compile Jade, compile Sass, validate-js, copy, concatenation, minifications)

$ grunt publish

dist directory preview (server on

$ grunt server-dist

Other Grunt tasks (if you want to use it)

..for copying app files to wwwroot, fonts & includes folders

$ grunt copy-app-files

..for copying bower_components files to app/bower_components

$ grunt copy-app-files

..for injecting bower libraries (also in default grunt task)

$ grunt bower-install

..for compiling Sass files

$ grunt compile-sass

..for validating javascript

$ grunt validate-js

..for compiling Jade files

$ grunt compile-jade

Full instructions for SW Foundation 5 Template

Starter Web Foundation 5: Readme Starter Web Foundation 5 Getting Started: Wiki

The Empty Application, Web Application, Web API Application are based on the new templates recently introduced with Visual Studio CTP 6 release, and you can read about this new templates on blog post accompanying CTP 6 release:
ASP.NET 5 Updates and other improvements for Web Developers in Visual Studio 2015 CTP 6

The Nancy project is based on framework's "Hello World" template:
Nancy Getting Started: Introduction

Related yeoman generators

The goal of generator-aspnet is to provide an experience consistent with creating new ASP.NET 5 (DNX) projects and files in Visual Studio 2015. Below are some other related generators that you may be interested in.


generator-csharp is a work in progress but is available for you to try out today. The goal of generator-csharp is to provide an experience consistent with creating C# projects (MSBuild based, not DNX) and files in Visual Studio 2015.


generator-aspnet-xtianus is an extension of OmniSharp/generator-aspnet that comes with a special Foundation 5 SASS/SCSS framework ready out of the box with wiredep & other grunt tasks for advanced front-end development. Look for => Starter Web Application - Foundation 5. The other goal of this generator is to provide alternative templates to the traditional ASP.NET Visual Studio templates. More templates will become housed under this fork in the near future. Feel free to participate and learn more about generator-aspnet-xtianus.

If you are working on a related generator please open an issue to let us know about it so that we can add it to the list.

Sub Generators

Available sub generators (to create files after the project has been created):

** Note: files generated are created in the working directory, no conventions are forced **


Creates a new ASP.NET 5 MvcController class


yo aspnet-xtianus:MvcController ContactController

Produces /ContactController.cs

using Microsoft.AspNet.Mvc;

// For more information on enabling MVC for empty projects, visit

namespace MyNamespace
    public class ContactController : Controller
        // GET: /<controller>/
        public IActionResult Index()
            return View();


Creates a new ASP.NET 5 MvcView page file


yo aspnet-xtianus:MvcView ContactView

Produces /ContactView.cshtml

    For more information on enabling MVC for empty projects, visit
    // ViewBag.Title = "ContactView Page";


Creates a new ASP.NET 5 WebApiController class


yo aspnet-xtianus:WebApiController ValuesController

Produces /ValuesController.cs

using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.AspNet.Mvc;

// For more information on enabling Web API for empty projects, visit

namespace MyNamespace.Controllers
    public class ValuesController : Controller
        // GET: api/values
        public IEnumerable<string> Get()
            return new string[] { "value1", "value2" };

        // GET api/values/5
        public string Get(int id)
            return "value";

        // POST api/values
        public void Post([FromBody]string value)

        // PUT api/values/5
        public void Put(int id, [FromBody]string value)

        // DELETE api/values/5
        public void Delete(int id)


Creates a new ASP.NET 5 Class


yo aspnet-xtianus:Class Contact

Produces /Contact.cs

using System;

namespace MyNamespace
    public class Contact



Creates a new Startup Class file


yo aspnet-xtianus:StartupClass

Produces Startup.cs


Creates a new Bower file


yo aspnet-xtianus:BowerJson

Produces bower.json


Creates a new CoffeeScript file


yo aspnet-xtianus:CoffeeScript filename



Creates a new config.json file


yo aspnet-xtianus:Config

Produces config.json


Creates a new Gulp file


yo aspnet-xtianus:Gulpfile

Produces gulpfile.js


Creates a new HTML file


yo aspnet-xtianus:HTMLPage filename

Produces filename.html


Creates a new JavaScript file


yo aspnet-xtianus:JavaScript filename

Produces filename.js


Creates a new JavaScript file


yo aspnet-xtianus:JScript filename

Produces filename.js


Creates a new JSON file


yo aspnet-xtianus:JSON filename

Produces filename.json


Creates a new package.json file


yo aspnet-xtianus:PackageJson

Produces package.json


Creates a new Text file


yo aspnet-xtianus:TextFile filename

Produces filename.txt


Creates a new TypeScript file


yo aspnet-xtianus:TypeScript filename

Produces filename.ts


Copyright 2014-2015 OmniSharp

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


@xtianus |


..see Coming soon file


npm i generator-aspnet-xtianus

Downloadsweekly downloads





Apache License 2.0




last publish


  • avatar
Report a vulnerability