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


    • xtianus