ZeroAlloc.Templates 0.15.5

ZeroAlloc.Templates

dotnet new Web API templates for the ZeroAlloc.* ecosystem. Source-generated, AOT-safe, zero-allocation through the framework hot path.

Catalog

Both templates ship the same 11-package showcase (Mediator, Validation, Authorization, Mapping, ValueObjects, Inject, Telemetry, Resilience, Rest, Results, ORM), same ZA.ORM 1.1 + SQLite persistence (raw Microsoft.Data.Sqlite provider, no DbContext), same xUnit + BenchmarkDotNet + NBomber test/bench fan-out. They differ in arrangement, not in functional scope — pick on team comfort, not capability.

Install

dotnet new install ZeroAlloc.Templates

Use

# Clean Architecture
dotnet new za-clean -o MyApp
cd MyApp && dotnet run --project src/MyApp.Api

# Vertical Slice
dotnet new za-vertical-slice -o MyApp
cd MyApp && dotnet run --project src/MyApp

# In another shell:
curl http://localhost:5000/healthz
# → {"status":"ok"}

za-clean ships with:

• Four layered projects (Domain, Application, Infrastructure, Api) with NetArchTest-enforced boundaries
• 18 passing tests (10 unit + 5 architecture + 3 integration)
• A BenchmarkDotNet write-pipeline scenario (~1.3 ms / ~36 KB per request through the full middleware stack on Linux/AMD EPYC Postgres CI; see run 26778623747)
• An NBomber read-RPS scenario for load testing under sustained concurrency
• An AGENTS.md that orients Claude Code, Cursor, GitHub Copilot, Codex, and Aider to the codebase

za-vertical-slice ships with:

• One src project (MyApp) — no horizontal layers; concerns live next to the feature that uses them
• Six slices (PlaceOrder, GetOrder, ListOrders, CancelOrder, CreateCustomer, GetCustomer) with request + validator + handler + endpoint + entity co-located per *.cs file
• 33 passing tests (16 unit + 12 integration + 5 NetArchTest convention rules)
• The same BenchmarkDotNet + NBomber benchmark fan-out adapted to the flat PlaceOrderCommand shape

Full tour and rationale: docs/za-clean.md.

What's in the box

License

MIT — see LICENSE.

Development

For maintainers of this repo (not for adopters of the template).

Required GitHub repo secrets

The release pipeline requires two secrets at Settings → Secrets and variables → Actions. Both are configured at org level so they inherit:

• RELEASE_PLEASE_TOKEN — Personal Access Token with contents:write + pull-requests:write + workflow:write. Needed because the default GITHUB_TOKEN can't trigger downstream workflows from release-please PRs.
• NUGET_API_KEY — push-only API key from nuget.org, scoped to ZeroAlloc.Templates.

Drift-guard for duplicated config

Three files are duplicated at the repo root and under each content/<template>/:

• Directory.Build.props
• Directory.Packages.props
• global.json

The root copies serve the template-tooling projects; the content/ copies serve the scaffolded app standalone. CI enforces they stay identical across the root and every content/<template>/ directory via a drift-guard step. When bumping a package version or SDK pin, edit all copies.

Build + test

# Per-template (replace za-clean ↔ za-vertical-slice as needed):
dotnet build content/za-clean/MyApp.slnx
dotnet test content/za-clean/MyApp.slnx
dotnet pack ZeroAlloc.Templates.csproj -o ./nupkg

# Full smoke test (parameterized over both templates: install + scaffold + build + test, ~50 s):
dotnet test tests/ZeroAlloc.Templates.SmokeTests

# Skip the slow smoke tests during inner-loop dev:
dotnet test --filter "Category!=Slow"

See AGENTS.md for the AI-agent orientation.