Open-source reference architecture

Build .NET systems with real distributed boundaries.

ADNC is a pragmatic .NET 8 framework and working reference implementation for modular monoliths, distributed applications, and microservice systems.

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 parts that usually fail after the demo works.

Boundary design

Modular first, distributed when necessary

Define service boundaries before deployment boundaries become the expensive part of the system.

Shared platform

Infrastructure is shared

Centralize cross-cutting concerns such as authentication, cache, repositories, remote calls, events, logs, and health checks.

Service ownership

Business behavior stays owned

Keep domain decisions inside service-specific application and domain layers instead of hiding them in a platform.

Architecture at a glance

Gateway, infrastructure packages, shared service layers, and demo services in one repository.

Gateway

Ocelot routing, authentication integration, Consul provider, and resilience policies.

Infrastructure

Reusable Consul, Redis, repository, event bus, ID generation, helper, and core packages.

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 architecture, not afterthoughts.

API gateway Service discovery Centralized configuration HTTP + gRPC calls Event integration EF Core + Dapper Unit of Work Redis cache JWT security Tracing and logs Health checks Polly resilience

Demo services

Five business services make architectural trade-offs visible.

ADM Layered

Admin

Users, roles, permissions, dictionaries, and configuration.

Identity and system administration

MNT Layered

Maint

Logs, audits, and operations management.

Audit trail and operations support

CST Compact

Cust

Customer management in a compact single-project service.

Minimal service structure

ORD DDD

Ord

Order management with explicit domain boundaries.

Domain-oriented order flow

WHS DDD

Whse

Warehouse management with a domain-oriented service shape.

Inventory and warehouse domain

Start with the reference implementation

Study the system, run the demo, then adopt the pieces that fit your team.

Open Documentation View Online Demo