Skip to content

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