Runbook

Common tasks

Task	Command
Build CSS	npm run build:css
Run	dotnet run --project src/ConnectSoft.Blazor.Mfe.Identity.SelfService
Build	dotnet build
Test	dotnet test

Troubleshooting

Symptom	Likely cause	Action
Login/register fails	IdentityApi.BaseUrl wrong or backend down	Verify base URL and that the Identity API is reachable
Session drops unexpectedly	Refresh not configured	Check Authentication keys and TokenExpirationBufferMinutes
2FA setup hidden	Feature flag off	Enable EnableTwoFactorAuthentication
Transient 5xx	Backend instability	Polly retries; inspect Serilog logs and circuit state

See the repo's docs/Deployment.md for hosting guidance.

See also

• Getting started
• Configuration