MAUI Base Template — Agent handbook

Canonical spec: ConnectSoft.Documentation — MAUI Base

Naming: two “bases”

Name	Stack
ConnectSoft.BaseTemplate	ASP.NET microservices (Layer 2 backend)
ConnectSoft.MauiBaseTemplate	.NET MAUI client apps (mobile/desktop kernel)

Agents must not add base-template/ submodule pointers between them unless a future extended mobile template explicitly introduces that pattern.

Scaffold contract

• dotnet new connectsoft-maui-base --service-name {PascalName} — {PascalName} replaces MauiBase everywhere (projects, folders, namespaces).
• Framework: net9.0 or net10.0 — keep test TFMs aligned.

Feature flags (Use*)

Treat as file / doc excludes from template.json — re-read modifiers before assuming code is gone. Observability, localization RESX trees, offline/sync folders, and selected docs/ markdown honor these flags.

Pipelines expectations

Repo ships multi-pipeline CI (Windows/Android, iOS/macOS, template pack, docs). 80% line coverage is a typical gate — do not delete tests to “fix” builds.

Topic map

See hub: MAUI Base Template.