Open-source .NET 8 framework

Build modular monoliths that can evolve into microservices.

ADNC is a pragmatic .NET 8 framework for modular monoliths, distributed microservices, production-grade infrastructure, and a working reference implementation.

Quickstart Explore GitHub

Docs Start from the architecture guides Quick start, Docker deployment, service layers, auth, cache, events, tracing. Code Generate and shape service code Development support for teams adopting ADNC conventions. Online Inspect the running ecosystem Explore the demo experience and companion admin front-end. GitHub Study the source and contribute Framework packages, gateway, demo services, database scripts, and deployment assets.

Why ADNC

It focuses on the boundary challenges that make business systems hard.

Modular monolith first

Strict boundaries from day one

Define service ownership and module boundaries before deployment boundaries become expensive.

Strategic evolution

Extract services when scale justifies the cost

Start pragmatic, then move toward distributed deployment when the operational return is clear.

Enterprise infrastructure

Production building blocks for .NET 8

Use consistent abstractions for gateway routing, discovery, configuration, auth, events, cache, observability, and resilience.

Architecture at a glance

Gateway, reusable infrastructure, shared service layers, and demo services in one system.

ADNC .NET 8 modular monolith and microservices architecture diagram

Gateway

Ocelot-based API gateway with routing, authentication integration, Consul provider, and resilience policies.

Infrastructure

Reusable packages for Consul, Redis, repositories, event bus, ID generation, helpers, and core primitives.

Shared Service Layer

Common application, domain, repository, remote-call, and Web API building blocks.

Demo Services

Business services that show layered, compact, and DDD-oriented structures side by side.

Core capabilities

Production concerns treated as architectural requirements, not afterthoughts.

Ocelot gateway Consul discovery Consul configuration Refit HTTP clients gRPC clients CAP events RabbitMQ EF Core Dapper MySQL + SQL Server MongoDB Unit of Work Redis cache Distributed locks Bloom filters JWT security NLog + Loki SkyAPM + SkyWalking HealthChecks Polly resilience Central Package Management

Demo services

Five business services show layered, compact, and DDD-oriented service structures.

ADM Layered

Admin

Organization, users, roles, permissions, dictionaries, and configuration.

Classic layered architecture with separated application contracts

MNT Layered

Maint

Logs, audits, and operations management.

Classic layered architecture with contracts merged into the application layer

CST Compact

Cust

Customer management.

Minimal single-project service

ORD DDD

Ord

Order management.

DDD-style service with a domain layer

WHS DDD

Whse

Warehouse management.

DDD-style service with a domain layer

Start with the reference implementation

Follow the quick start, run the demo, then adopt the infrastructure and service patterns that fit your team.

Open Documentation View Online Demo