Runbook

Common tasks

Task	Command
Restore frontend	npm install (solution root)
Run shell	dotnet run --project src/Shell.BlazorServer
Build all	dotnet build
Test	dotnet test
Rebuild CSS	npm run build

Troubleshooting

Symptom	Likely cause	Action
MFE route 404	Host page catch-all missing	Confirm @page "/area/{*PageRoute}" in the Core RCL page
Wrong theme/adapter	uiKitAdapter conditional not active	Reference the correct adapter project and call its Add*Theme()
Architecture test failure	New project violates layering	Fix dependency direction per NetArchTest assertions
Looking for BFF/Shared.Contracts	Not shipped in current source	Add those projects yourself; README is ahead of the template
Port conflicts	Sample WASM uses 58085+; shell uses 7000/7001	Align launchSettings.json to your -sp/-bp/... choices

See also

• Getting started
• Development