CleanWebApi.Template 2026.11.1.122

Clean Web API

A dotnet new template for an API built with a streamlined version of Clean Architecture and ASP.NET Core Web API controllers.

It's one of five Lean Mean Clean Apps templates, for Minimal APIs, Model Context Protocol, GraphQL, Web API controllers and AWS Lambda, that share the same Application and Infrastructure layers, tests and CI pipeline. Full docs live at leanmeancleanapps.github.io/webapi.

Requirements

• .NET 10 SDK
• Docker (optional, to build and run the container image)

Install

dotnet new install CleanWebApi.Template

Create a solution

dotnet new cleanwebapi --name {YOUR_SOLUTION_NAMESPACE} --authorName "{YOUR_NAME}"

With an authority set, the movie, author and review endpoints need a JWT bearer token, and the version endpoint, the OpenAPI document and Scalar stay open.

Run it

From the new solution's folder, start the app and a Seq container for logs.

docker compose up -d

Then open the Scalar API reference at http://localhost:8080/scalar. The OpenAPI document is at http://localhost:8080/openapi/v1.json, and Seq shows the logs at http://localhost:5341.

Or run it without Docker.

dotnet run --project ./src/Presentation

Run the tests with dotnet test. Every way to run the solution is in docs/RUN.md inside it.

What's inside

• Presentation: ASP.NET Core controllers, documented with XML comments and browsable in Scalar
• Application: commands and queries through Mediator, validation with FluentValidation and mapping with Mapperly
• Infrastructure: Entity Framework Core on SQLite with migrations and optional sample data
• Tests: xUnit, Shouldly and NSubstitute, each test on its own in-memory database
• A Dockerfile that runs as a non-root user, a docker-compose.yml, and a GitHub Actions pipeline with tests, a coverage gate, a container scan and CodeQL

Updates

A new version is released on the 1st of each month with every change merged since the previous release, as long as something has changed. No change, no new version number. We're not here to pad the download stats. To update an installed template:

dotnet new update

What changed in each version is in the release notes. To remove the template, run dotnet new uninstall CleanWebApi.Template.

More help

• Docs site for guides, a reference and why it's built this way
• README on GitHub for the architecture, every feature and the Docker build options
• Running guide for every way to run, configure and test the solution
• GitHub issues for bugs and ideas
• Security policy to report a vulnerability privately

Support

If this template saves you time, please consider sponsoring the work on GitHub. It keeps all five templates current, and the coffee flowing.