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, Layer 3 extended installers (Identity, Worker, ApiGateway, and so on), and ConnectSoft.MauiBaseTemplate (connectsoft-maui-base).

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
ConnectSoft.AISkillsLibraryTemplate connectsoft-aiskills-library ConnectSoft AI-Enabled Skills Library ConnectSoft.AISkillsLibraryTemplate
ConnectSoft.Blazor.Mfe.AIChatTemplate connectsoft-blazor-mfe-aichat ConnectSoft Blazor Microfrontend AI Chat Template ConnectSoft.Blazor.Mfe.AIChatTemplate
ConnectSoft.Blazor.Mfe.AuthorizationServer.AdminTemplate connectsoft-blazor-mfe-auth-admin ConnectSoft Blazor Microfrontend Authorization Server Admin Template ConnectSoft.Blazor.Mfe.AuthorizationServer.AdminTemplate
ConnectSoft.MauiBaseTemplate connectsoft-maui-base ConnectSoft MAUI Base Template ConnectSoft.MauiBaseTemplate

Other template families (Blazor starter packs without a row here, Blazor MFE repos without published short names, and so on) may use their own packaging; see Blazor MFE and AI templates and each repo’s .template.config. The table above covers the Base + microservice extended alignment, MAUI base, and published Blazor MFE / AI Skills short names used in Templates registry.

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.