Runbook¶
Common tasks¶
| Task | Command |
|---|---|
| Restore frontend | npm install (in shell project) |
| Run | dotnet run --project src/<Name> |
| Build | dotnet build |
| Test | dotnet test |
| Add MFE | Edit Shell:MicroFrontends in appsettings.json |
Troubleshooting¶
| Symptom | Likely cause | Action |
|---|---|---|
| New MFE not in nav | Missing config entry | Add a MicroFrontendOptions to Shell:MicroFrontends |
| Styles missing | UIKit CSS / app.css not loaded |
Verify _content/ConnectSoft.Blazor.UIKit/... references in App.razor; run npm run build |
| SDK mismatch | Wrong .NET SDK | global.json pins 10.x; install matching SDK |
| Looking for sample WASM MFEs | This template ships none | Use connectsoft-blazor-mfe for sample MFEs |