dknet-minimal

DKNet API Solution Template

A production-ready ASP.NET Core solution template built on vertical slice architecture combining:

• DDD / CQRS — strict layer boundaries (Api → AppServices → Domains → Infra)
• .NET Aspire orchestration (Redis + SQL Server)
• EF Core with auto model config and seeding (UseAutoConfigModel, UseAutoDataSeeding)
• SlimMessageBus — in-memory bus always wired; Azure Service Bus optional
• FluentValidation, Mapster, OpenTelemetry, Azure App Configuration, JWT Bearer
• xUnit + Shouldly test project scaffolded out-of-the-box

---

Installation

Install from GitHub Packages:

dotnet nuget add source \
  --username <YOUR_GITHUB_USERNAME> \
  --password <YOUR_GITHUB_PAT_WITH_READ_PACKAGES> \
  --store-password-in-clear-text \
  --name github \
  "https://nuget.pkg.github.com/baoduy/index.json"

Install the latest template version directly from the GitHub feed:

dotnet new install DKNet.Minimal.Template --nuget-source "https://nuget.pkg.github.com/baoduy/index.json"

Or install a specific version:

dotnet new install DKNet.Minimal.Template::latest --nuget-source "https://nuget.pkg.github.com/baoduy/index.json"

---

Usage

Create a new solution

dotnet new dknet-minimal -n MyCompany.MyService

This generates a fully-wired solution under a MyCompany.MyService/ folder:

MyCompany.MyService/
├── MyCompany.MyService.sln
├── global.json
├── Directory.Packages.props
├── coverage.runsettings
└── MyCompany.MyService.ApiEndpoints/
    ├── MyCompany.MyService.Api/           # Minimal API entry point
    ├── MyCompany.MyService.AppHost/       # .NET Aspire orchestration host
    ├── MyCompany.MyService.AppServices/   # Application/use-case layer (CQRS)
    ├── MyCompany.MyService.Domains/       # Domain entities, repos, events
    ├── MyCompany.MyService.Infra/         # EF Core, repos, event publisher
    ├── MyCompany.MyService.Share/         # Constants, options, shared types
    └── MyCompany.MyService.App.Tests/     # xUnit + Shouldly test project

Available parameters

Parameter	Default	Description
-n, --name	MyApp	Root namespace and folder name
--AuthorName	Steven Hoang	Embedded in project metadata
--CompanyUrl	https://drunkcoding.net	<Company> in project metadata
--RepositoryUrl	https://github.com/baoduy/DKNet	<RepositoryUrl> in metadata

Example with all parameters:

dotnet new dknet-minimal -n Acme.OrderService \
  --AuthorName "Jane Smith" \
  --CompanyUrl "https://acme.com" \
  --RepositoryUrl "https://github.com/acme/order-service"

---

Running the generated solution

# Restore
dotnet restore <Name>.sln

# Build
dotnet build <Name>.sln -c Release

# Run API only
dotnet run --project <Name>.ApiEndpoints/<Name>.Api

# Run with Aspire (Redis + SQL Server auto-provisioned via Docker)
dotnet run --project <Name>.ApiEndpoints/<Name>.AppHost

# Test
dotnet test <Name>.sln --settings coverage.runsettings --collect:"XPlat Code Coverage"

---

EF Core Migrations

From inside <Name>.ApiEndpoints/:

# Add a new migration
./add-migration.sh <MigrationName>

# Remove the last migration
./remove-migration.sh <MigrationName>

---

Adding a new feature (vertical slice)

Follow the Profiles/V1 pattern already in the template:

1. Domain entity → <Name>.Domains/Features/<Feature>/Entities/
2. EF Core mapping → <Name>.Infra/Features/<Feature>/Mappers/
3. Commands / Queries → <Name>.AppServices/<Feature>/V1/
4. Endpoint config → <Name>.Api/ApiEndpoints/<Feature>V1Endpoint.cs (implement IEndpointConfig)

See AGENTS.md for the full architecture reference.

---

AI assistant plugins

The repo ships a Claude Code plugin and a GitHub Copilot plugin that drive vertical-slice features end-to-end. Generated solutions include both folders (.claude/, .claude-plugin/, .github/), so your team gets the same agents, skills, and slash commands the template authors use.

Claude Code

/plugin marketplace add baoduy/dknet.templates
/plugin install dknet-minimal

Once installed, the following slash commands are available: