Runbook
This is a library, not a deployable host - operational tasks center on building, packing, and publishing the NuGet package.
Common tasks
| Task |
Command |
| Restore Tailwind toolchain |
npm install (in the RCL project) |
| Rebuild CSS |
npm run build (emits wwwroot/css/app.css) |
| Build |
dotnet build -c Release |
| Test |
dotnet test |
| Pack |
dotnet pack src/<Name> -c Release |
Troubleshooting
| Symptom |
Likely cause |
Action |
| Build fails with markup-safety diagnostic |
SecurityAnalyzers flagged raw HTML / MarkupString |
Remove unsafe markup or justify per analyzer rule |
| Styles missing in consuming host |
Token CSS / app.css not referenced |
Reference _content/<Name>/... static assets in host layout |
| Unused theming pulled into WASM host |
Referencing more than one adapter |
Reference a single adapter project; verify with LinkerTest |
app.css stale |
Tailwind not rebuilt |
Run npm run build before dotnet build |
Notes
- Some unit tests reference components that may not yet exist in
src/ (e.g. AsyncButton, Select); treat these as authoring drift and reconcile before publishing.
- CI badge text is driven by the
buildDefinitionNumber parameter.
See also