Install the template once with dotnet new install ./template/content. Replace the project name, copy a command, then inspect the generated application.
Minimal API without persistence
Use for a focused endpoint surface that does not own durable data or require caller identity.
dotnet new dotnet-service-n PublicApi--api-styleminimal--data-providernone--database-providernone--authenticationnone--authorizationnone
Controllers + PostgreSQL
Use when the service owns relational data and conventional controller routing fits the API.
dotnet new dotnet-service-n OrderService--api-stylecontrollers--data-providerefcore--database-providerpostgresql
Controllers + SQL Server
Use when the service owns relational data in an environment standardized on SQL Server.
dotnet new dotnet-service-n CustomerService--api-stylecontrollers--data-providerefcore--database-providersqlserver
Minimal API + SQLite
Use for a small service or local deployment that needs owned relational state without an external database server.
dotnet new dotnet-service-n CatalogService--api-styleminimal--data-providerefcore--database-providersqlite
Hosted service without a business API
Use for scheduled or continuous work. Health endpoints remain available for operation.
dotnet new dotnet-service-n ReconciliationWorker--api-stylenone--job-processinghosted-service--data-providernone--database-providernone
HTTP integration + OpenTelemetry
Use when the service calls another HTTP service and needs distributed traces across the request path.
dotnet new dotnet-service-n PricingService--integrationhttp--observabilityopentelemetry--data-providernone--database-providernone
Inspect the generated baseline.
Successful generation and compilation do not prove runtime behavior or production readiness.
Restore and buildConfirm the selected SDK and packages resolve in a clean environment.
Start and probeRun the application and probe /health/live. Configure persistence before relying on /health/ready.
Inspect inclusion and absenceConfirm selected capabilities exist and omitted capabilities did not leave files or dependencies behind.
Review runtime configurationProvide connection strings, identity settings, secrets, and deployment configuration outside the generated source.
Know what the template does not complete.
Broker adapters, durable inbox and outbox delivery, and Hangfire storage are not complete production implementations in the current template. Treat them as extension points. Generation and compilation do not prove their runtime reliability.