Northwind Traders is a sample application built using ASP.NET Core and Entity Framework Core. The architecture and design of the project is explained in the video:

• Clean Architecture with ASP.NET Core 2.1 (slide deck)

The initial construction of this project is explained in the following blog posts:

• Code: Northwind Traders with Entity Framework Core
• Create Northwind Traders Code First with Entity Framework Core – Part 1
• Create Northwind Traders Code First with Entity Framework Core – Part 2

For information on upcoming features and fixes, take a look at the product roadmap.

Use these instructions to get the project up and running.

You will need the following tools:

• Visual Studio Code or Visual Studio 2019 (version 16.3 or later)
• .NET Core SDK 3
• Node.js (version 10 or later) with npm (version 6.11.3 or later)

Follow these steps to get your development environment set up:

1. Clone the repository

2. At the root directory, restore required packages by running:

   dotnet restore
   

3. Next, build the solution by running:

   dotnet build
   

4. Next, within the \Src\WebUI\ClientApp directory, launch the front end by running:

   npm start
   

5. Once the front end has started, within the \Src\WebUI directory, launch the back end by running:

   dotnet run
   

6. Launch https://localhost:44376/ in your browser to view the Web UI

7. Launch https://localhost:44376/api in your browser to view the API

If you need to regenerate the Northwind Traders TypeScript client (Northwind.WebUI\ClientApp\src\app\northwind-traders-api.ts) follow these steps:

1. First, launch the application as per the above instructions
2. Next, from the Northwind.WebUI\ClientApp directory, run:

   nswag run
   

This was previously managed by an MSBuild task, however NSwag.MSBuild has not yet been updated to support .NET Core 3. The MSBuild task will be re-enabled when this happens.

• .NET Core 3
• ASP.NET Core 3
• Entity Framework Core 3
• Angular 8

This project is licensed under the MIT License - see the LICENSE.md file for details.