Added docs to create and run angular project

docs/en/CLI.md

@@ -34,20 +34,25 @@ Example:
 abp new Acme.BookStore
 ````
 
-* Acme.BookStore is the solution name here.
+* `Acme.BookStore` is the solution name here.
 * Common convention is to name a solution is like *YourCompany.YourProject*. However, you can use different naming like *YourProject* (single level namespacing) or *YourCompany.YourProduct.YourModule* (three levels namespacing).
 
 #### Options
 
-* `--template` or `-t`: Specifies the template name. Default template name is `mvc`. Available templates:
+* `--template` or `-t`: Specifies the template name. Default template name is `app`, which generates a web application. Available templates:
-  * `mvc` (default): ASP.NET Core [MVC application template](Startup-Templates/Mvc.md). Additional options:
+  * `app` (default): [Application template](Startup-Templates/Application.md). Additional options:
+    * `--ui` or `-u`: Specifies the UI framework. Default framework is `mvc`. Available frameworks:
+      * `mvc`: ASP.NET Core MVC. There are some additional options for this template:
+        * `--tiered`: Creates a tiered solution where Web and Http API layers are physically separated. If not specified, it creates a layered solution which is less complex and suitable for most scenarios.
+      * `angular`: Angular. There are some additional options for this template:
+        * `--separate-identity-server`: Separates the identity server application from the API host application. If not specified, you will have a single endpoint in the server side.
     * `--database-provider` or `-d`: Specifies the database provider. Default provider is `ef`. Available providers:
       * `ef`: Entity Framework Core.
       * `mongodb`: MongoDB.
-    * `--tiered`: Creates a tiered solution where Web and Http API layers are physically separated. If not specified, it creates a layered solution which is less complex and suitable for most scenarios.
+  *  `mvc-module`: ASP.NET Core [module template](Startup-Templates/Mvc-Module.md). Additional options:
-  *  `mvc-module`: ASP.NET Core [MVC module template](Startup-Templates/Mvc-Module.md). Additional options:
     * `--no-ui`: Specifies to not include the UI. This makes possible to create service-only modules (a.k.a. microservices - without UI).
 * `--output-folder` or `-o`: Specifies the output folder. Default value is the current directory.
+* `--version` or `-v`: Specifies the ABP & template version. It can be a [release tag](https://github.com/abpframework/abp/releases) or a [branch name](https://github.com/abpframework/abp/branches). Uses the latest release if not specified. Most of the times, you will want to use the latest version.
 
 ### add-package
 
@@ -103,7 +108,7 @@ abp add-module Volo.Blogging
 
 ### update
 
-Updating all ABP related packages can be tedious since there are many packages of the framework and modules. This command automatically updates all ABP NuGet related packages and NPM packages in a solution or project to the latest versions.
+Updating all ABP related packages can be tedious since there are many packages of the framework and modules. This command automatically updates all ABP related NuGet and NPM packages in a solution or project to the latest versions.
 
 Usage:
 

docs/en/Getting-Started-Angular-Template.md

@@ -0,0 +1,122 @@
+## Getting Started With the Angular Startup Template
+
+This tutorial explain how to create a new Angular application using the startup template, configure and run it.
+
+### Creating a New Project
+
+This tutorial uses **ABP CLI** to create a new project. See the [Get Started](https://abp.io/get-started) page for other options.
+
+Install the ABP CLI using a command line window, if you've not installed before:
+
+````bash
+dotnet tool install -g Volo.Abp.Cli
+````
+
+Use `abp new` command in an empty folder to create your project:
+
+````bash
+abp new Acme.BookStore -u angular
+````
+
+> You can use different level of namespaces; e.g. BookStore, Acme.BookStore or Acme.Retail.BookStore.
+
+`-u angular` option specifies the UI framework to be Angular. Default database provider is EF Core. See the [CLI documentation](CLI.md) for all available options.
+
+#### Pre Requirements
+
+The created solution requires;
+
+* [Visual Studio 2017 (v15.9.0+)](https://visualstudio.microsoft.com/tr/downloads/)
+* [.NET Core 2.2+](https://www.microsoft.com/net/download/dotnet-core/)
+
+### The Solution Structure
+
+Open the solution in **Visual Studio**:
+
+![bookstore-visual-studio-solution](images/bookstore-visual-studio-solution-for-spa.png)
+
+The solution has a layered structure (based on [Domain Driven Design](Domain-Driven-Design.md)) and contains unit & integration test projects properly configured to work with **EF Core** & **SQLite in-memory** database.
+
+> See the [Application Template Document](Startup-Templates/Application.md) to understand the solution structure in details.
+
+### Database Connection String
+
+Check the **connection string** in the `appsettings.json` file under the `.HttpApi.Host` project:
+
+````json
+{
+  "ConnectionStrings": {
+    "Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
+  }
+}
+````
+
+The solution is configured to use **Entity Framework Core** with **MS SQL Server**. EF Core supports [various](https://docs.microsoft.com/en-us/ef/core/providers/) database providers, so you can use another DBMS if you want. Change the connection string if you need.
+
+### Create Database & Apply Database Migrations
+
+You have two options to create the database.
+
+#### Using the DbMigrator Application
+
+The solution contains a console application (named `Acme.BookStore.DbMigrator` in this sample) that can create database, apply migrations and seed initial data. It is useful on development as well as on production environment.
+
+> `.DbMigrator` project has its own `appsettings.json`. So, if you have changed the connection string above, you should also change this one.
+
+Right click to the `.DbMigrator` project and select **Set as StartUp Project**:
+
+![set-as-startup-project](images/set-as-startup-project.png)
+
+Hit F5 (or Ctrl+F5) to run the application. It will have an output like shown below:
+
+![set-as-startup-project](images/db-migrator-app.png)
+
+#### Using EF Core Update-Database Command
+
+Ef Core has `Update-Database` command which creates database if necessary and applies pending migrations. Right click to the `.Web` project and select **Set as StartUp Project**:
+
+![set-as-startup-project](images/set-as-startup-project.png)
+
+Open the **Package Manager Console**, select `.EntityFrameworkCore.DbMigrations` project as the **Default Project** and run the `Update-Database` command:
+
+![pcm-update-database](images/pcm-update-database-v2.png)
+
+This will create a new database based on the configured connection string.
+
+> Using the `.Migrator` tool is the suggested way, because it also seeds the initial data to be able to properly run the web application.
+
+### Running the Application
+
+#### Run the API Host (Server Side)
+
+Ensure that the `.HttpApi.Host` project is the startup project and un the application which will open a Swagger UI:
+
+![bookstore-homepage](images/bookstore-swagger-ui-host.png)
+
+You can see the application APIs and test them here. Get [more info](https://swagger.io/tools/swagger-ui/) about the Swagger UI.
+
+##### Authorization for the Swagger UI
+
+Most of the application APIs require authentication & authorization. If you want to test authorized APIs, manually go to the `/Account/Login` page, enter `admin` as the username and `1q2w3E*` as the password to login to the application. Then you will be able to execute authorized APIs too.
+
+#### Run the Angular Application (Client Side)
+
+Go to the `angular` folder, open a command line terminal, type the `yarn` command (we suggest to the [yarn](https://yarnpkg.com) package manager while npm install will also work in most cases):
+
+````bash
+yarn
+````
+
+Once all node modules are loaded, execute `yarn start` or `npm start` command:
+
+````bash
+yarn start
+````
+
+Open your favorite browser and go to `localhost:4200` URL. Initial username is `admin` and password is `1q2w3E*`.
+
+The startup template includes the **identity management** and **tenant management** modules. Once you login, the Administration menu will be available where you can manage **tenants**, **roles**, **users** and their **permissions**.
+
+### What's Next?
+
+* [Application development tutorial](Tutorials/Angular/Part-I.md)

docs/en/Getting-Started-AspNetCore-MVC-Template.md

@@ -1,6 +1,6 @@
 ## Getting Started With the ASP.NET Core MVC Template
 
-These tutorials explain how to create a new ASP.NET Core MVC web application using the startup template, configure and run it.
+This tutorial explains how to create a new ASP.NET Core MVC web application using the startup template, configure and run it.
 
 ### Creating a New Project
 

docs/en/Startup-Templates/Mvc.md → docs/en/Startup-Templates/Application.md

@@ -1,13 +1,11 @@
-# MVC Application Startup Template
+# Application Startup Template
 
 ## Introduction
 
-This template provides a layered (or tiered, based on the preference) application structure based on the [Domain Driven Design](../Domain-Driven-Design.md) (DDD) practices.
+This template provides a layered application structure based on the [Domain Driven Design](../Domain-Driven-Design.md) (DDD) practices. This document explains the solution structure and projects in details. If you want to start quickly, follow the guides below:
 
-This document explains the solution structure and projects in details.
+* See [Getting Started With the ASP.NET Core MVC Template](../Getting-Started-AspNetCore-MVC-Template.md) to create a new solution and run it for this template (uses MVC as the UI framework and Entity Framework Core as the database provider).
-
+* See the [ASP.NET Core MVC Tutorial](../Tutorials/AspNetCore-Mvc/Part-I.md) to learn how to develop applications using this template (uses MVC as the UI framework and Entity Framework Core as the database provider).
-* See [Getting Started With the ASP.NET Core MVC Template](../Getting-Started-AspNetCore-MVC-Template.md) to create a new solution and run it for this template.
-* See the [ASP.NET Core MVC Tutorial](../Tutorials/AspNetCore-Mvc/Part-I.md) to learn how to develop applications using this template.
 
 ## How to Start With?
 
@@ -22,11 +20,24 @@ dotnet tool install -g Volo.Abp.Cli
 Then use the `abp new` command in an empty folder to create a new solution:
 
 ````bash
-abp new Acme.BookStore -t mvc
+abp new Acme.BookStore -t app
 ````
 
 * `Acme.BookStore` is the solution name, like *YourCompany.YourProduct*. You can use single level, two-levels or three-levels naming.
-* This example specified the template name (`-t` or `--template` option). However, `mvc` is already the default template if you don't specify it.
+* This example specified the template name (`-t` or `--template` option). However, `app` is already the default template if you don't specify it.
+
+### Specify the UI Framework
+
+This template provides multiple UI frameworks:
+
+* `mvc`: ASP.NET Core MVC UI with Razor Pages (default)
+* `angular`: Angular UI
+
+Use `-u` or `--ui` option to specify the UI framework:
+
+````bash
+abp new Acme.BookStore -u angular
+````
 
 ### Specify the Database Provider
 
@@ -41,23 +52,13 @@ Use `-d` (or `--database-provider`) option to specify the database provider:
 abp new Acme.BookStore -d mongodb
 ````
 
-### Create a Tiered Solution
-
-`--tiered` option is used to create a tiered solution where Web and Http API layers are physically separated. If not specified, it creates a layered solution which is less complex and suitable for most scenarios.
-
-````bash
-abp new Acme.BookStore --tiered
-````
-
-See the "Tiered Structure" section below for the tiered approach.
-
 ## Solution Structure
 
 Based on the options you've specified, you will get a slightly different solution structure.
 
 ### Default Structure
 
-If you don't specify any option, you will have a solution like shown below:
+If you don't specify any additional option, you will have a solution like shown below:
 
 ![bookstore-visual-studio-solution-v3](../images/bookstore-visual-studio-solution-v3.png)
 
@@ -161,7 +162,7 @@ Most of time you don't need to manually create C# client proxies, thanks to ABP'
 
 #### .Web Project
 
-This project contains the User Interface (UI) of the application. It contains razor pages, JavaScript files, style files, images and so on...
+This project contains the User Interface (UI) of the application if you are using ASP.NET Core MVC UI. It contains Razor pages, JavaScript files, CSS files, images and so on...
 
 This project contains the main `appsettings.json` file that contains the connection string and other configuration of the application.
 
@@ -182,10 +183,10 @@ The solution has multiple test projects, one for each layer:
 * `.Domain.Tests` is used to test the domain layer.
 * `.Application.Tests` is used to test the application layer.
 * `.EntityFrameworkCore.Tests` is used to test EF Core configuration and custom repositories.
-* `.Web.Tests` is used to test the UI.
+* `.Web.Tests` is used to test the UI (if you are using ASP.NET Core MVC UI).
 * `.TestBase` is a base (shared) project for all tests.
 
-In addition, `.HttpApi.Client.ConsoleTestApp` is a console application (not an automated test project) which demonstrate the usage of HTTP APIs from a Dotnet application.
+In addition, `.HttpApi.Client.ConsoleTestApp` is a console application (not an automated test project) which demonstrate the usage of HTTP APIs from a .NET application.
 
 Test projects are prepared for integration testing;
 
@@ -203,7 +204,7 @@ See [Getting Started With the ASP.NET Core MVC Template](../Getting-Started-AspN
 
 ### Tiered Structure
 
-If you specify the `--tiered` option as described above, the solution created will be a tiered solution. The purpose of the tiered structure is to be able to **deploy Web application and HTTP API to different servers**:
+If you have selected the ASP.NET Core UI and specified the `--tiered` option, the solution created will be a tiered solution. The purpose of the tiered structure is to be able to **deploy Web application and HTTP API to different servers**:
 
 ![bookstore-visual-studio-solution-v3](../images/tiered-solution-servers.png)
 
@@ -254,6 +255,19 @@ You should run the application with the given order:
 * Then run the `.HttpApi.Host` since it is used by the `.Web` application.
 * Finally, you can run the `.Web` project and login to the application (using `admin` as the username and `1q2w3E*` as the password).
 
+### Angular UI
+
+If you choose Angular as the UI framework (using the `-u angular` option), the solution is separated into two folders:
+
+* `angular` folder contains the Angular UI solution, the client side.
+* `aspnet-core` folder contains the ASP.NET Core solution, the server side.
+
+Server side is very similar to the solution described above. `.HttpApi.Host` project serves the API, so the Angular application can consume it.
+
+The files under the `angular/src/environments` folder has the essential configuration of the application.
+
+#### 
+
 ## What's Next?
 
 - See [Getting Started With the ASP.NET Core MVC Template](../Getting-Started-AspNetCore-MVC-Template.md) to create a new solution and run it for this template.

docs/en/Startup-Templates/Index.md

@@ -1,11 +1,9 @@
 # Startup Templates
 
-While you can start with an empty project and add needed packages manually, startup templates makes easy and comfortable to start a new solution with the ABP framework.
+While you can start with an empty project and add needed packages manually, startup templates make easy and comfortable to start a new solution with the ABP framework. Click the name from the list below to see the documentation of the related startup template:
 
-Click to the name from the list below to see the documentation of the related startup template:
+* [**app**](Application.md): Application template.
-
+* [**mvc-module**](Mvc-Module.md): Module/service template.
-* [**mvc**](Mvc.md): ASP.NET Core MVC application template.
-* [**mvc-module**](Mvc-Module.md): ASP.NET Core MVC module/service template.
 
 
 

docs/en/Tutorials/Angular/Part-I.md

@@ -0,0 +1,7 @@
+## Angular Tutorial - Part I
+
+### About this Tutorial
+
+In this tutorial series, you will build an application that is used to manage a list of books & their authors. **Angular** will be used as the UI framework and **MongoDB** will be used as the database provider.
+
+TODO...