DotNet core on Linux (Ubuntu)

Nodejs Install - Version 4

curl sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install y nodejs
Version 6
curl Sl https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install y nodejs
Optional Build Tools
sudo apt-get install y build-essential

Dotnet Core Install

Ubuntu 14.04
sudo sh c echo deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/
trusty main > /etc/apt/sources.list.d/dotnetdev.list
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
Ubuntu 16.04
sudo sh c echo deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/
xenial main > /etc/apt/sources.list.d/dotnetdev.list
sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
sudo apt-get update
Install .NET Core SDK
sudo apt-get install dotNet-dev-1.0.0-preview2-003131
Install Yeoman and Gulp
sudo npm i -g yo gulp (yeoman webs scaffolding tool for modern webapps, gulp - streaming
build system)
sudo npm i -g bower (package manager)
sudo npm i -g jspm (frictionless bower package management)
sudo npm i -g typescript (to develop front end with Angular 2)
sudo npm i -g typings (to develop front end with Angular 2)
sudo npm i -g webpack (to develop front end with Angular 2)
sudo npm i -g @microsoft/generator-sharepoint (yeoman SharePoint WebPart generator
create SharePoint client-side solution projects with the right tool chain and project structure)
sudo npm i -g generator-aspnet (yeoman generator for ASP.NET core projects)
mkdir aspnet
cd aspnet
yo aspnet
code . (to open project folder in Visual Studio Code)
cd projectname
dotnet restore
dotnet build
dotnet ef database update
dotnet run
mkdir helloworld-webpart
cd helloworld-webpart
yo @microsoft/sharepoint
code .
gulp serve

Getting Started

Dependencies:
o Node.js: brew install node for Mac OS X, choco install nodejs for Windows OS
o Yeoman: npm install -g yo
o Bower npm install -g bower
Install: npm install -g generator-aspnet
Run: yo aspnet

See also: Building Projects with Yeoman on docs.asp.net

NOTE: Starting from RTM release Web Application and Web Application Basic project templates
use Bundler Minifier tool instead of NPM based build systems like Gulp or Grunt. The Bundler
tool is installed as part of tooling support for the project, the project.json contains relevant
scripting integration and one can use that tool independently from console using
its CLI interface. Visit Bundler tool WIKI for details.
Also see ASP NET Community Standup - June 21st, 2016 - Mads Visits for detailed information
about this change introduction.

Usage
yo aspnet shows a wizard for generating a new ASP.NET Core app
yo aspnet --help shows flags and other configurable options

Templates

Full, template based projects available in generator:

Empty Web Application

Console Application
Console Application (F#)
Web Application
Web Application Basic [without Membership and Authorization]
Web API Application
Nancy ASP.NET Application
Class Library
Class Library (F#)
Unit Test project (xUnit.net)

The Empty Web Application, Console Application, Web Application, Web Application Basic
(a.k.a. Web Application No Auth), Web API Application and Class Library are based on the
templates introduced with Visual Studio 2015. They are available and maintained in
the ASP.NET Templates project.

ASP.NET Templates project provides templates which are used in Visual Studio for creating
ASP.NET Core applications.

NOTE: Starting from RC2 dotnet release the web application template project no longer ships
with built-in EF migration. For this reason you should call dotnet ef database update to scaffold
database using template provided migrations!
The Nancy project is based on framework's "Hello World" template: Nancy Getting Started:
Introduction

The Docker support with Dockerfile configuration files is based on the official Docker image for
ASP.NET Core
The Unit test project uses xUnit: a free, open source, community-focused unit testing tool for
the .NET Framework

The F# Templates are based on Core F# Templates projects. They were translated into F# from
the original ASP.NET Templates

The templates that use client-side libraries are calling the bower install script to install Bower
managed dependencies. You can skip the installation process by passing the --skip-install option
to the generator, e.g. yo aspnet --skip-install. This should allow for a better experience
when Development has been enabled.

Command line automation

The project type and application name can be specified as optional command line arguments:

yo aspnet [projecttype [applicationname] [uiframework]]

The valid project types are:

emptyweb for Empty Web Application

consoleapp for Console Application
web for Web Application
webbasic for Web Application Basic
webapi for Web API Application
nancy for Nancy ASP.NET Application
classlibrary for Class Library
unittest Unit Test project (xUnit.net)
fsharp_emptyweb for F# Empty Web Application
fsharp_console for F# Console Application
fsharp_lib for F# Class Library
fsharp_webbasic for F# Web Application Basic
fsharp_test for F# Unit Test project (xUnit.net)

The valid UI framework types are:

bootstrap for Bootstrap (this is the default and does not have to be specified explicitly)
semantic for Semantic UI

Example: yo aspnet webbasic "my semantic app" semantic will create a "Web Application Basic"
project called "my semantic app" using the Semantic UI framework.
Example: yo aspnet webbasic "my bootstrap app" OR yo aspnet webbasic "my bootstrap app"
bootstrap will create a "Web Application Basic" project called "my bootstrap app" using the
Bootstrap framework.

Related yeoman generators

The goal of generator-aspnet is to provide an experience consistent with creating new ASP.NET
Core dotnet cli projects and files in Visual Studio 2015.
The list of related generators can be seen on our Wiki section

Sub Generators
The alphabetic list of available sub generators (to create files after the project has been
created):

aspnet:angularcontroller
aspnet:angularcontrolleras
aspnet:angulardirective
aspnet:angularfactory
aspnet:angularmodule
aspnet:appsettings
aspnet:bowerjson
aspnet:class
aspnet:coffeescript
aspnet:dockerfile
aspnet:gitignore
aspnet:gruntfile
aspnet:gulpfile
aspnet:htmlpage
aspnet:interface
aspnet:javascript
aspnet:json
aspnet:jsonschema
aspnet:jsx
aspnet:middleware
aspnet:mvccontroller
aspnet:mvcview
aspnet:nuget
aspnet:packagejson
aspnet:program
aspnet:readme
aspnet:startup
aspnet:stylesheet
aspnet:stylesheetless
 aspnet:stylesheetscss
aspnet:taghelper
aspnet:textfile
aspnet:tfignore
aspnet:typescript
aspnet:typescriptconfig
aspnet:typescriptjsx
aspnet:usersecrets
aspnet:webapicontroller

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

angularcontroller

Creates AngularJS controller file using $scope

Example:

yo aspnet:angularcontroller filename
Produces filename.js

angularcontrolleras

Creates AngularJS controller file using Controller As syntax.

Example:

yo aspnet:angularcontrolleras filename
Produces filename.js

angulardirective

Creates AngularJS directive file.

Example:

yo aspnet:angulardirective filename
Produces filename.js

angularfactory

Creates AngularJS factory file.

Example:
yo aspnet:angularfactory filename
Produces filename.js

angularmodule

Creates AngularJS module file

Example:

yo aspnet:angularmodule filename
Produces filename.js

appsettings

Creates a new appsettings.json file

Example:

yo aspnet:appsettings
Produces appsettings.json

bowerjson

Creates a new bower.json and configuration file.

Example:

yo aspnet:bowerjson
Produces bower.json and .bowerrc

class

Creates a new ASP.NET Core class

Example:

yo aspnet:class Contact
Produces /Contact.cs

coffeescript

Creates a new CoffeeScript file

Example:

yo aspnet:coffeescript filename
Produces filename.coffee

dockerfile

Creates a new Docker configuration file. To create Docker image with SQLite support for
EntityFramework use --sqliteoption
Example:

yo aspnet:dockerfile
Creates a new Dockerfile
Are you curious about Docker, Linux containers and ASP.NET Core Docker image and all these
buzz words?

Docker image for ASP.NET 5 (Docker Hub)

Running ASP.NET 5 applications in Linux Containers with Docker (MSDN)
ASP.NET 5 : Continuous Integration with Travis-CI, Tutum, Docker, Webhooks and Azure
[Advanced]
ASP.NET 5 on Docker talk at NDC {London} by Mark Rendle

gitignore

Creates a new .gitignore file

Example:

yo aspnet:gitignore
Produces .gitignore

gruntfile

Creates a new Grunt file

Example:

yo aspnet:gruntfile
Produces Gruntfile.js

gulpfile

Creates a new Gulp file

Example:

yo aspnet:gulpfile
Produces gulpfile.js
htmlpage

Creates a new HTML file

Example:

yo aspnet:htmlpage filename
Produces filename.html

interface

Creates a new ASP.NET Core interface

Example:

yo aspnet:interface IContact
Produces /IContact.cs

javascript

Creates a new JavaScript file

Example:

yo aspnet:javascript filename
Produces filename.js

json

Creates a new JSON file

Example:

yo aspnet:json filename
Produces filename.json

jsonschema

Creates a new JSON schema file

Example:

yo aspnet:jsonschema filename
Produces filename.json
jsx

Creates a new React JSX file

Example:

yo aspnet:jsx filename
Produces filename.jsx

middleware

Creates a new C# middleware class file

Example:

yo aspnet:middleware filename
Produces filename.cs

mvccontroller

Creates a new ASP.NET Core MvcController class

Example:

yo aspnet:mvccontroller ContactController
Produces /ContactController.cs
Read more about MVC Controllers on docs.asp.net

mvcview

Creates a new ASP.NET Core MvcView page file

Example:

yo aspnet:mvcview ContactView
Produces /ContactView.cshtml
Read more about MVC Views on docs.asp.net

nuget

Creates a new NuGet.config file. The support for unstable development feed is provided by --
unstable option.
Example:

yo aspnet:nuget --unstable
Produces NuGet.config with unstable NuGet feed

packagejson

Creates a new package.json file

Example:

yo aspnet:packagejson
Produces package.json

program

Creates a new Program.cs file

Example:

yo aspnet:program
Produces Program.cs

README

Creates a new REAMDE.md documentation file in Markdown format You can optionally pass --
txt option to use .txtextension. Example:
yo aspnet:readme [--txt]
Produces readme.md

startup

Creates a new Startup.cs file

Example:

yo aspnet:startup
Produces Startup.cs

stylesheet

Creates a new CSS file

Example:

yo aspnet:stylesheet style
Produces style.css

stylesheetless
Creates a new Less class file

Example:

yo aspnet:stylesheetless filename
Produces filename.less

stylesheetscss

Creates a new Sass SCSS class file

Example:

yo aspnet:stylesheetscss filename
Produces filename.scss

taghelper

Creates a new TagHelper class file

Example:

yo aspnet:taghelper filename
Produces filename.cs

textfile

Creates a new Text file

Example:

yo aspnet:textfile filename
Produces filename.txt

tfignore

Creates a new .tfignore file

Example:

yo aspnet:tfignore
Produces .tfignore

typescript
Creates a new TypeScript file

Example:

yo aspnet:typescript filename
Produces filename.ts

typescriptconfig

Creates a new TypeScript configuration file

Example:

yo aspnet:typescriptconfig
Produces tsconfig.json

typescriptjsx

Creates a new JSX-enabled TypeScript file

Example:

yo aspnet:typescriptjsx filename
Produces filename.tsx

usersecrets

Adds UserSecrets information to ASP.NET Core project.json file. The generator do not update
existing keys if found and does not create new project.json file.
Example:

yo aspnet:usersecrets
This will add following keys to project.json:

"userSecretsId" key
"Microsoft.Extensions.Configuration.UserSecrets" key under "dependencies"

webapicontroller

Creates a new ASP.NET Core WebApiController class

Example:

yo aspnet:webapicontroller ValuesController
Produces /ValuesController.cs
Read more about Web API MVC concepts on docs.asp.net