Runbook¶
Common tasks¶
| Task | Command |
|---|---|
| Run shell | dotnet run --project samples/<Name>.Shell |
| Build | dotnet build |
| Test (unit) | dotnet test --filter TestCategory=Unit |
| Test (integration) | dotnet test --filter TestCategory=Integration |
| Pack RCL | dotnet pack src/<Name> -c Release |
Troubleshooting¶
| Symptom | Likely cause | Action |
|---|---|---|
| 401/empty lists | API unreachable or token missing | Verify AuthorizationServerApi.BaseUrl; confirm login succeeded and handler attaches bearer |
| Access denied on a page | Role/policy mismatch | Ensure the signed-in user has admin/viewer as required by the policy |
| Unstyled WASM app | UIKit CSS / Flowbite JS not loaded | Check Components/App.razor asset references |
| Calls time out | API slow / retry exhausted | Tune TimeoutSeconds, EnableRetry, MaxRetryAttempts |