Runbook¶
Common tasks¶
| Task | Command |
|---|---|
| Build CSS | npm run build:css |
| Run demo | dotnet run --project samples/AIChatDemo.BlazorServer |
| Build | dotnet build |
| Test | dotnet test |
| Pack RCL | dotnet pack src/<Name> -c Release |
Troubleshooting¶
| Symptom | Likely cause | Action |
|---|---|---|
| Chat works but always mock replies | MockAIService still registered |
Swap for a real IChatClient in AddAIChatServices() |
| Components missing in host | AddAdditionalAssemblies not called |
Add the RCL's assembly via AddAdditionalAssemblies(typeof(...Home).Assembly) |
| Unstyled UI | UIKit CSS / Flowbite JS not loaded, or app.css stale |
Reference UIKit assets; run npm run build:css |
| Wrong TFM at build | Manifest net9.0 vs source net10.0 |
Use the SDK matching the generated .csproj |