repowisefullstackhero/dotnet-starter-kit

Architecture of fullstackhero/dotnet-starter-kit

fullstackhero/dotnet-starter-kit is 2,022 source files holding 12,054 symbols across 3 modules, written mainly in C#, TypeScript, Terraform. The largest module is src, with 1,553 files, and 22 files are entry points into the dependency graph.

How dotnet-starter-kit fits together

The backend code lives under src, where src/BuildingBlocks holds shared framework libraries such as Core, Persistence, Caching and Eventing. Each bounded context in src/Modules, such as Identity, Billing or Chat, has a runtime project and a Contracts project that serves as its only public surface. The src/Host/FSH.Starter.Api project is the composition root that hosts the Web API, using Minimal APIs and Mediator for CQRS. The src/Host/FSH.Starter.DbMigrator project runs migrations and seeding once, because the database is not migrated at API startup. The src/Host/FSH.Starter.AppHost project is the .NET Aspire orchestrator that starts Postgres, Valkey, MinIO, the migrator, the API and both React apps together. The clients/admin and clients/dashboard directories contain the two React 19 apps, which call the API through a hand-written typed client.

Largest modules

  • src: 1,553 files and 74,783 lines of code
  • clients: 339 files and 57,055 lines of code
  • deploy: 63 files and 6,500 lines of code
  • .agents: 43 files and 1,611 lines of code
  • root: 8 files and 385 lines of code
  • superpowers: 6 files and 2,315 lines of code
  • .github: 5 files and 663 lines of code
  • .template.config: 2 files and 200 lines of code

Languages

By file count: C# 1,541 files, TypeScript 319 files, Terraform 58 files, Dockerfile 4 files, Shell 3 files, JavaScript 2 files.

More on dotnet-starter-kit: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos