jjmyrup/NorthwindTraders

Northwind Traders is a sample application built using ASP.NET Core and Entity Framework Core.

NorthwindTraders

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.

Getting Started

Use these instructions to get the project up and running.

Prerequisites

You will need the following tools:

• Visual Studio Code or 2017
• .NET Core SDK 2.2
• Node.js (version 10 or later) with npm (version 6.9.0 or later)

Setup

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 Northwind.WebUI\ClientApp directory, launch the front end by running:

   npm start
   

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

   dotnet run
   

6. Launch http://localhost:52468/ in your browser to view the Web UI

7. Launch http://localhost:52468/api in your browser to view the API

Technologies

• .NET Core 2.2
• ASP.NET Core 2.2
• Entity Framework Core 2.2

License

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