Repository files navigation

This is a solution template for creating a Single Page App (SPA) with Angular and ASP.NET Core following the principles of Clean Architecture. Create a new project based on this template by clicking the aboveUse this template button or by installing and running the associated NuGet package (see Getting Started for full details).

• .NET Core 3.1
• ASP .NET Core 3.1
• Entity Framework Core 3.1
• Angular 10
• MediatR
• AutoMapper
• FluentValidation
• NUnit, FluentAssertions, Moq & Respawn

The easiest way to get started is to install theNuGet package and rundotnet new ca-sln:

1. Install the latest.NET Core SDK
2. Install the latestNode.js LTS
3. Rundotnet new --install Clean.Architecture.Solution.Template to install the project template
4. Create a folder for your solution and cd into it (the template will use it as project name)
5. Rundotnet new ca-sln to create a new project
6. Navigate tosrc/WebUI/ClientApp and runnpm start to launch the front end (Angular)
7. Navigate tosrc/WebUI and rundotnet run to launch the back end (ASP.NET Core Web API)

Check out myblog post for more information.

The template is configured to use an in-memory database by default. This ensures that all users will be able to run the solution without needing to set up additional infrastructure (e.g. SQL Server).

If you would like to use SQL Server, you will need to updateWebUI/appsettings.json as follows:

"UseInMemoryDatabase":false,

Verify that theDefaultConnection connection string withinappsettings.json points to a valid SQL Server instance.

When you run the application the database will be automatically created (if necessary) and the latest migrations will be applied.

To usedotnet-ef for your migrations please add the following flags to your command (values assume you are executing from repository root)

• --project src/Infrastructure (optional if in this folder)
• --startup-project src/WebUI
• --output-dir Persistence/Migrations

For example, to add a new migration from the root folder:

dotnet ef migrations add "SampleMigration" --project src\Infrastructure --startup-project src\WebUI --output-dir Persistence\Migrations

This will contain all entities, enums, exceptions, interfaces, types and logic specific to the domain layer.

This layer contains all application logic. It is dependent on the domain layer, but has no dependencies on any other layer or project. This layer defines interfaces that are implemented by outside layers. For example, if the application need to access a notification service, a new interface would be added to application and an implementation would be created within infrastructure.

This layer contains classes for accessing external resources such as file systems, web services, smtp, and so on. These classes should be based on interfaces defined within the application layer.

This layer is a single page application based on Angular 10 and ASP.NET Core 3.1. This layer depends on both the Application and Infrastructure layers, however, the dependency on Infrastructure is only to support dependency injection. Therefore onlyStartup.cs should reference Infrastructure.

If you are having problems, please let us know byraising a new issue.

This project is licensed with theMIT license.