christdev / northwind365

Reference architecture for SSW.CleanArchitecture

Northwind 365

Northwind 365 is a sample application built using .NET 8, ASP.NET Core, and Entity Framework Core.

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

Learning Resources

You're interested learning more about Clean Architecture, please see this excellent video by Matt Goldman:

• Clean Architecture with ASP.NET Core and MAUI

Alternatively, SSW has many great rules about Clean Architecture:

• SSW Rules - Clean Architecture

If you'd like to start a new project using Clean Architecture, you can use the SSW Clean Architecture template:

• SSW Clean Architecture Template

You can also find a collection of commumity projects built on Clean Architecture here:

• Awesome Clean Architecture

Getting Started

Use these instructions to get the project up and running.

Prerequisites

You will need the following tools:

• Visual Studio or VS Code, or Rider
• .NET 8 SDK
• Node.js version 20.10 LTS or later - Recommended to install using nvm or nvm for Windows
• Angular CLI (version 17 or later) - install by running npm install -g @angular/cli

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

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

dotnet run

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

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

Technologies

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

Other Packages

• MediatR
• FluentValidation
• AutoMapper
• Ardalis.Specification
• Ardalis.GuardClauses

Testing Packages

• xUnit
• NSubstitute
• TestContainers
• Fluent Assertions
• Respawn
• Bogus

Marketing

Marketing site can be found at northwind365.com which is deployed from Northwind365.Website.

License

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