Trellis.Asp.Templates 1.0.153-alpha

Trellis.Asp.Templates

dotnet new trellis-asp scaffolds a single-service ASP.NET application on the Trellis framework with Clean Architecture (API + Application + Domain + ACL), optional API versioning, EF Core, OpenAPI, and test infrastructure.

Quick Start

dotnet new install Trellis.Asp.Templates
dotnet new trellis-asp -n MyService --author-name "Your Name"
cd MyService; dotnet run --project Api\src

The template restores packages after creation. A restore failure makes dotnet new return a non-zero exit code; generated files remain on disk. Use --skip-restore for deferred/offline creation, then run dotnet restore explicitly. Once the app is running, use the API endpoint or OpenAPI UI from the Api project output.

What's Included

Trellis organizes your service into clear layers so business logic stays isolated from HTTP and infrastructure concerns.

Api -> Application -> Domain
  \-> Acl -----------^

Features

• Trellis-based service structure for clean, layered ASP.NET applications
• Railway-Oriented Programming patterns for explicit success and failure flows
• Domain-Driven Design friendly layout with domain, application, API, and ACL projects
• CQRS-style application layer with handlers and request separation
• Test projects for every layer
• EF Core-ready infrastructure setup
• OpenTelemetry support for local observability
• API starter files, HTTP samples, and local app settings
• Common named-route pagination links for both profiles, with the version-aware host policy enabled by --api-versioning
• Dev Container support for Codespaces and VS Code
• Agent-neutral AGENTS.md instructions and version-aligned .agentdocs references for Trellis-friendly code generation

Template Parameters

Azure requires an explicit server provider; SQLite/Azure fails restore/build and deployment preflight. PostgreSQL and SQL Server profiles include compose.database.yaml for local development. Generated README.md describes connection configuration, production identity, Cosmos, and deployment bootstrap. See the shared option defaults.

Solution filenames and their references preserve the literal -n value, including hyphens. The default C# namespace is sanitized separately, and --root-namespace does not rename the solution.

The Entra profile expects v2 access tokens with the API application's client-ID GUID as aud, not the calling client's ID or an api://... audience. Configure the API registration's api.requestedAccessTokenVersion as 2; requested scopes may still use api://<client-id>/.... The generated production guidance describes the tenant-specific issuer and required claims.

Documentation

• Trellis docs: https://xavierjohn.github.io/Trellis/
• Dev Container guide: template/.devcontainer/README.md
• OpenTelemetry guide: template/DockerOpenTelemetry/README.md

Related repositories

• xavierjohn/Trellis — the framework: Result<T>, Maybe<T>, value objects, DDD primitives, ASP.NET / EF Core / Mediator integration.
• xavierjohn/Trellis.Microservices — microservice trust-boundary packages: YARP gateway integration + consumer-side actor provider for multi-tenant ABAC.
• Microservices template — dotnet new trellis-microservices Project Tracker starter with Aspire.
• xavierjohn/Trellis.ServiceLevelIndicators — latency SLI metrics library for emitting operation-duration histograms via System.Diagnostics.Metrics + OpenTelemetry.

Requirements

• .NET 10 SDK

License

MIT.