Architecture workbench · .NET 10

A hands-on architecture laboratory for .NET 10

CPnucleo is a project-management sandbox for comparing implementations and tradeoffs: REST with EF Core and Dapper, gRPC style messaging, Astro UI, PostgreSQL, Docker, NGINX, OpenTelemetry, and Hostinger deployment.

Proof hero Architecture hero Control

.NET 10FastEndpointsAstroPostgreSQLDockerHostinger

Read docs Inspect GitHub Open live demo

Variant BProof-led hero

Prioritizes docs and GitHub clicks with source-backed rows above the fold.

Variant CArchitecture-first hero

Makes the service topology the dominant visual for first-time evaluators.

ControlCurrent hierarchy

Keeps broad project positioning, then compares CTA and scroll behavior.

source-backed proof

Evidence before adjectives

Each row points to the docs page that carries the implementation detail.

Transport parityREST and gRPC

WebApi compares EF Core and Dapper through FastEndpoints REST. GrpcServer uses FastEndpoints Remote Messaging with Dapper against the same PostgreSQL model.

Architecture gateNetArchTest

Architecture tests protect the Domain layer from infrastructure, presentation, EF Core, Dapper, and Npgsql dependencies.

Runtime topology4 services

WebApi, IdentityApi, GrpcServer, and WebClient share PostgreSQL. Production uses Traefik for public routing and NGINX to balance the two REST instances.

Release pathGHCR to Hostinger

GitHub Actions tests immutable amd64 images before Hostinger deployment. CodeQL runs separately; multi-arch manifests also wait for the arm64 build.

documentation paths

Start where your review starts

Learning Lab

Start small, change one variable, and verify the result.

Architecture

Layer boundaries, transport split, and domain rules.

API Reference

REST endpoints, Identity API, and gRPC contracts.

Database

PostgreSQL, EF Core, Dapper, migrations, and seed scripts.

Testing

Architecture tests, unit tests, integration tests, and coverage.

clone path

Run the stack, then inspect the boundaries

# Clone the repository
git clone https://github.com/jonathanperis/cpnucleo

# Build the minimal lab and seed disposable example data
cd cpnucleo
docker compose -f compose.lab.yaml up --build -d
docker compose -f compose.lab.yaml run --rm seed

Open http://localhost:5400. See Getting Started for the local account, profiles and source-development settings.