NetVerticalSlice.Templates 2.0.0

Net Vertical Slice Templates

Production-oriented .NET templates for building ASP.NET Core Web APIs with Wolverine, Vertical Slice Architecture, Entity Framework Core, FluentValidation, and Mapster.

The package provides two coordinated templates:

• vsa-webapi: creates a complete Web API with production infrastructure.
• vsa-feature: adds a full vertical slice to an existing project.

The generated application is ready to build immediately and keeps infrastructure, authentication, observability, and feature code separated from the composition root.

Why use this template?

Design principles

• Feature code is organized by business use case, not by technical layer.
• Program.cs remains a small composition root.
• Infrastructure registration is split into focused DependencyInjection extensions.
• Authentication providers are isolated: the generated project contains only the selected provider's files, packages, and configuration.
• Normal Wolverine endpoints receive global rate limiting automatically.
• Production builds use static Wolverine code instead of runtime compilation.
• Configuration values can be overridden with standard ASP.NET Core configuration and environment variables.

Requirements

• .NET 10 SDK

Install

dotnet new install NetVerticalSlice.Templates

List the installed templates:

dotnet new list vsa

Create a Web API

dotnet new vsa-webapi \
  -n Store.Api \
  -D PostgreSQL \
  -A Scalar \
  -C OutputCache \
  -Au Identity \
  --Observability OpenTelemetry

Then run:

cd Store.Api
dotnet restore
dotnet ef migrations add InitialCreate -o Data/Migrations
dotnet ef database update
dotnet run

For Scalar, open /scalar/v1. For Swagger, open /swagger.

Project template options

These choices are also available in the Visual Studio and Rider new-project experience.

Authentication choices

Identity projects include:

• POST /api/auth/register
• POST /api/auth/login
• POST /api/auth/refresh
• POST /api/auth/logout

Database choices

The selected database provider controls the EF Core package, compile symbol, and generated connection strings. The application uses DbContextPool, configuration classes, audit interception, and a global soft-delete filter.

Rate limiting

Rate limiting is enabled in every generated project.

Rejected requests return HTTP 429, a Retry-After header, and the standard response envelope. Limits can be changed under RateLimiting in appsettings.json.

Observability

When --Observability OpenTelemetry is selected, the project includes:

• ASP.NET Core request traces and metrics.
• .NET runtime metrics.
• Wolverine activity and meter sources.
• ASP.NET Core rate-limiting metrics.
• OTLP export configured through standard OpenTelemetry environment variables.

Set the collector endpoint before running:

OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

Generated architecture

Store.Api/
├── DependencyInjection/
│   ├── ApiServiceCollectionExtensions.cs
│   ├── ApplicationServiceCollectionExtensions.cs
│   ├── AuthenticationServiceCollectionExtensions.cs
│   ├── InfrastructureServiceCollectionExtensions.cs
│   ├── MessagingHostBuilderExtensions.cs
│   ├── ObservabilityServiceCollectionExtensions.cs
│   ├── RateLimitingServiceCollectionExtensions.cs
│   └── WebApplicationExtensions.cs
├── Data/
│   ├── AppDbContext.cs
│   ├── Common/
│   ├── Configuration/
│   └── Entities/
├── Features/
│   └── SampleFeature/
├── Infrastructure/
│   ├── Common/
│   └── RateLimiting/
├── Mappings/
├── Models/
├── Program.cs
├── Dockerfile
├── Directory.Packages.props
└── appsettings.json

The request flow is:

HTTP request
  -> authentication
  -> rate limiting
  -> authorization
  -> Wolverine HTTP endpoint
  -> FluentValidation
  -> command/query handler
  -> EF Core
  -> standardized response

Authentication and authorization steps are omitted when AuthProvider is None.

Add a vertical slice

Use vsa-feature inside an existing project:

dotnet new vsa-feature \
  -n Product \
  --ResourceName products \
  --Category Catalog \
  --RootNamespace Store.Api \
  --DbContext AppDbContext \
  --output .

The template generates Create, GetById, GetList, Update, and SoftDelete slices, plus Mapster configuration. Each slice follows the same structure used by the project template.

If the entity does not exist, include it and its EF configuration:

dotnet new vsa-feature \
  -n Product \
  --ResourceName products \
  --Category Catalog \
  --RootNamespace Store.Api \
  --DbContext AppDbContext \
  --GenerateEntity \
  --output .

Feature template options

Generated commands and view models are field-agnostic. Replace the marked TODO fields with properties that match the target domain, register the DbSet, and create a migration.

Production build

The generated Dockerfile writes Wolverine handlers during the SDK stage and publishes without runtime compilation, Roslyn workspaces, or EF design-time packages.

docker build \
  --build-arg APP_ENVIRONMENT=Production \
  -t store-api:latest .

For a non-container production publish:

dotnet run \
  -c Release \
  -p:IncludeWolverineRuntimeCompilation=true \
  -- codegen write

dotnet publish \
  -c Release \
  -p:IncludeWolverineRuntimeCompilation=false \
  -p:IncludeEfDesignTimePackages=false

Health endpoints

Health endpoints are anonymous and excluded from rate limiting.

Template verification

The repository includes automated tests that generate projects for every database and authentication choice, build them, publish them with pre-generated Wolverine code, and verify runtime validation and rate-limiting behavior.

dotnet test templates/TemplateTests/TemplateTests.csproj --configuration Release

Create a NuGet package:

dotnet pack templates/NetVerticalSlice.Templates.csproj --configuration Release

Uninstall

dotnet new uninstall NetVerticalSlice.Templates

Additional documentation

The repository contains:

• docs/examples.md: end-to-end usage examples.
• docs/CONTRIBUTING.md: contribution and verification workflow.
• docs/IMPROVEMENTS.md: planned improvements.
• SKILL.md: detailed architecture and coding conventions for AI-assisted development.

Generated projects also include the reusable skill under .agents/skills/net-vertical-slice/.

License

MIT