← WorkOpen Source · API

dotnet-clean-api-starter

Een productieklaar .NET 10 Web API-template gebouwd op Clean Architecture en CQRS. Volledig ingericht met JWT-auth, PostgreSQL, Docker en integratietests — klaar om te clonen en op te bouwen.

Bezoek website
dotnet-clean-api-starter

Periode

May 2026

Rol

Solo Backend Developer

Stack

.NET 10 · C# · PostgreSQL · EF Core · MediatR · JWT · Docker · xUnit · Testcontainers

The problem

Een nieuwe .NET API van nul opzetten kost dagen aan boilerplate — projectstructuur, auth, databaseconfiguratie, foutafhandeling, tests. Dit template elimineert die opstarttijd zodat je je kunt focussen op de daadwerkelijke feature.

What I built

  • Clean Architecture in vier lagen: Domain → Application → Infrastructure → API, met strikte eenrichtings-afhankelijkheidsregels
  • CQRS via MediatR met een validatiepipeline — elke command doorloopt automatisch FluentValidation voor de handler
  • JWT-toegangstokens (15 min) + roterend refresh token (7 dagen) — opgeslagen in PostgreSQL met volledige intrekkingsondersteuning
  • Multi-stage Dockerfile + docker-compose met healthcheck — één commando om de volledige stack lokaal te draaien
  • Integratietests met Testcontainers (echte PostgreSQL), Respawn (databaseopschoning) en Bogus (realistische testdata)
  • GitHub Actions CI-pipeline — build, unit tests en integratietests bij elke push naar main

Result

Een volledig functioneel, getest en gedocumenteerd .NET 10 API-template. 17 geslaagde tests (10 unit, 7 integratie). Clean Architecture gedemonstreerd van begin tot eind — van domein-value objects tot integratietests tegen een echte database.

17
tests geslaagd
4
architectuurlagen
CI
GitHub Actions

Next project

De Bergen