Skip to content

Template naming guide

ConnectSoft dotnet new templates use a single naming scheme: connectsoft-* short names (kebab-case after the prefix). This applies to ConnectSoft.BaseTemplate, ConnectSoft.MicroserviceTemplate, and Layer 3 extended installers (Identity, Worker, ApiGateway, and so on).

Breaking change

Short names formerly prefixed with cs- (for example cs-microservice-base) are removed. Update automation to dotnet new connectsoft-base, reinstall packages from the feed, and replace snippets in scripts and docs.

Installers: base vs extended

Installer package Registers Purpose
ConnectSoft.BaseTemplate.Installer connectsoft-base Scaffold the base microservice kernel only.
Extended *.Installer composed packages (for example ConnectSoft.ApiGatewayTemplate.Installer) One extended short name (for example connectsoft-apigateway) The composed .nupkg must not ship a second template from base-template/.template.config; pipelines strip that folder after metadata merge. Install ConnectSoft.BaseTemplate.Installer separately when you need connectsoft-base.

Canonical short names, display names, and identities

Values below match the composed template.json / extend files as shipped from each repository.

Product shortName name identity / groupIdentity
ConnectSoft.BaseTemplate connectsoft-base ConnectSoft Microservice Base Template ConnectSoft.BaseTemplate
ConnectSoft.MicroserviceTemplate connectsoft-microservice ConnectSoft Microservice Template ConnectSoft.MicroserviceTemplate
ConnectSoft.ApiGatewayTemplate connectsoft-apigateway ConnectSoft API Gateway Template ConnectSoft.ApiGatewayTemplate
ConnectSoft.IdentityTemplate connectsoft-identity ConnectSoft Identity Template ConnectSoft.IdentityTemplate
ConnectSoft.WorkerTemplate connectsoft-worker ConnectSoft Worker Template ConnectSoft.WorkerTemplate
ConnectSoft.AuthorizationServerTemplate connectsoft-authorization-server ConnectSoft Authorization Server Template ConnectSoft.AuthorizationServerTemplate
ConnectSoft.MicrosoftBotFrameworkTemplate connectsoft-microsoft-bot-framework ConnectSoft Microsoft Bot Framework Template ConnectSoft.MicrosoftBotFrameworkTemplate
ConnectSoft.HealthChecksAggregatorTemplate connectsoft-healthchecks-aggregator ConnectSoft Health Checks Aggregator Template ConnectSoft.HealthChecksAggregatorTemplate

Other template families (Blazor, MAUI, library packs, and so on) may use their own short-name conventions; this table covers the Base + microservice extended alignment described in the single-installer work.

CLI: HealthCheckPublisher and argument order

The base template defines HealthCheckPublisher with allowMultipleValues. When you pass --healthcheck-publisher, place it after other template flags and immediately before --no-update-check in non-interactive scripts so the CLI does not bind the next option as an extra publisher value. See Extended templates — base submodule playbook.