Skip to main content
codewithmukesh
Resource · Starter template
500+ devs already shipping with it

Ship features from day one with Clean Architecture.

A production-ready .NET 10 starter with manual CQRS, JWT auth, HybridCache, and Aspire wired together. Skip the scaffolding and start building the actual thing.

Join 8,429 devs · No spam · Unsubscribe anytime

or browse the full architecture breakdown first

  • .NET 10 ready
  • ·
  • Zero commercial deps
  • ·
  • 17 tests passing on first build
  • ·
  • MIT licensed
01 · By the numbers
  • 500+

    Downloads

    Devs already shipping with it

  • 17

    Tests passing

    Architecture + handler tests

  • 0

    Warnings

    Strict analyzer rules

  • MIT

    License

    Free forever · use commercially

02 · What's inside

Everything you need to start shipping features .

  • Clean Architecture, enforced

    Four layers with strict dependency rules. Architecture tests fail the build if you break them.

  • Manual CQRS, zero licensing risk

    ICommand, IQuery, and handler interfaces. No MediatR. You own every line.

  • Full identity, ready to go

    ASP.NET Identity, JWT, refresh tokens, role-based authorization, seeded admin user.

  • Microsoft HybridCache

    L1 in-memory + L2 Redis with stampede protection and automatic serialization.

  • Scalar API docs

    Modern OpenAPI UI that replaces Swagger. JWT pre-configured for testing.

  • Aspire + OpenTelemetry

    One 'dotnet run' starts Postgres, Redis, and the API with full observability.

  • FluentValidation + Result pattern

    Endpoint filters validate before handlers. Typed errors map to correct HTTP codes.

  • Tests from day one

    9 architecture tests, 8 unit tests. xUnit v3 with FluentAssertions. AAA pattern.

  • Modern .NET conventions

    .slnx solution, Central Package Management, primary constructors, collection expressions.

03 · The architecture
  • Api

    Minimal API endpoints, Scalar, middleware, ProblemDetails

  • Infrastructure

    EF Core, Identity, JWT, HybridCache, Serilog

  • Application

    CQRS handlers, validators, DTOs, feature folders

  • Domain zero dependencies

    Entities, Result pattern, Error types — zero dependencies

04 · Project structure

A structure that explains itself.

Eight projects. One dependency rule. Top to bottom, every folder earns its place — no Helpers/, no Common/, no magic.

solution explorer
src 6 projects
  • Domain 0 deps
  • Application use cases
  • Infrastructure I/O
  • Api entry
  • AppHost Aspire
  • ServiceDefaults Aspire
tests 2 projects · 17 tests
  • Architecture.Tests 9 tests
  • Application.UnitTests 8 tests
8 projects · 17 tests passing · 0 warnings

src · core layers · aspire · orchestration · tests · enforcement

05 · Opinionated by design
  • Manual CQRS

    MediatR is commercial since v13. Zero licensing risk. You learn the pattern, not a library.

  • Scalar over Swagger

    Modern, faster, better UX. Pre-configured with JWT for testing auth flows.

  • HybridCache

    Stampede protection, L1+L2, auto serialization. Replaces IMemoryCache + IDistributedCache.

  • Result pattern

    Explicit error handling with typed errors. No hidden exceptions. Correct HTTP codes.

  • No repository pattern

    EF Core DbContext IS the repository. No unnecessary abstraction. Handlers query directly.

  • .slnx solution format

    XML-based, merge-friendly, smaller. The future of .NET solution files.

Convinced? Grab it now

Skip the scaffolding. Start building the actual thing.

Download link lands in your inbox in under a minute. Free forever, MIT licensed.

Read the FAQ first
06 · Questions, answered
  • Q01 How is this different from FullStackHero?

    FullStackHero is a Modular Monolith with Vertical Slices — enterprise-grade, open source, with multitenancy, Blazor UI, and 10+ building blocks. This template is Clean Architecture — intentionally minimal, focused on learning the pattern, and designed as a starter for new projects. Different architecture, different scope, complementary tools.

  • Q02 Why no MediatR?

    MediatR went commercial with v13. The manual CQRS approach uses simple ICommand/IQuery interfaces with handler classes — about 40 lines of infrastructure code total. Zero licensing risk, and you learn the actual pattern instead of a library abstraction.

  • Q03 Can I use this for production?

    Yes. It includes JWT auth with refresh tokens, global exception handling, ProblemDetails error responses, HybridCache, OpenTelemetry observability, and architecture tests. Add your domain entities and features following the Todos pattern.

  • Q04 What database does it use?

    PostgreSQL via EF Core 10, managed by .NET Aspire. Run 'dotnet run' in the AppHost project and Aspire spins up a PostgreSQL container automatically. The initial migration and seed data are applied on first startup.

  • Q05 Do I need Docker installed?

    Yes, Docker Desktop is required for .NET Aspire to manage the PostgreSQL and Redis containers. Alternatively, you can use the included docker-compose.yml to run dependencies standalone.

  • Q06 Will I get updates?

    Yes. When the template is updated (new .NET version, new features), you'll receive an email with what changed and a link to download the latest version.

Real questions from real downloaders · Last updated March 2026
One more time

Stop scaffolding. Start building.

.NET 10 · Clean Architecture · zero commercial dependencies · MIT · unzip and go.

Just the newsletter

Built by the author of 150+ .NET tutorials and 3 free courses

Newsletter

stay ahead in .NET

One email every Tuesday at 7 PM IST. One topic, deep. The week's articles. No filler.

Tutorials Architecture DevOps AI
Join 8,429 developers · Delivered every Tuesday
Privacy notice 30s read

Cookies, but only the useful ones.

I use cookies to understand which articles get read and which CTAs actually work. No third-party advertising trackers, ever. Read the privacy policy →