Back to blog

ShellUI v0.3.0-rc.1 – Template-compile, CSP, and CLI install fixes

June 18, 2026 · Release Candidate · ShellUI

v0.3.0-rc.1 is the release candidate for v0.3.0. It bundles five branches of integration-tested fixes against the alpha series, surfaced from real-world Blazor Server consumer use. If no blocking issues turn up during internal testing, v0.3.0 final ships from this RC unchanged.

Template compilation fixes

ChartVariants, PieChart, and DashboardLayout02 templates contained uncompilable C# because of improperly escaped quotes inside verbatim strings. The live PieChart.razor component had the same backslash-escaping bug. All four are fixed — templates now drop into a fresh project and compile on first build.

CSP-safe runtime

ThemeToggle no longer reaches for eval() and moves localStorage reads into proper Blazor lifecycle methods. InputOTP and ThemeService had the same CSP-problematic eval() calls removed. Strict CSP policies (no unsafe-eval) now Just Work.

SidebarTrigger also dropped its FontAwesome dependency for the mobile hamburger menu — it's an inline SVG now.

Idempotent shellui init

shellui init now patches App.razor with render modes, theme bootstrap scripts, and shellui.js references. The full default theme is written to input.css instead of just the Tailwind import. All patching is idempotent — re-running init on a partially-initialized project is safe and won't duplicate sections.

CLI install repairs

  • shellui add data-table now installs DataTableModels.cs
  • NuGet dependencies auto-install (System.Linq.Dynamic.Core, Blazor-ApexCharts)
  • Chart tooltips render readable text instead of invisible white-on-white
  • Typo suggestions: e.g. "Did you mean ‘data-table’?"

Component count clarified

Documentation now lists 68 installable top-level components (corrected from earlier claims of 100). Same components, more honest count.

Install

# Install the release candidate CLI
dotnet tool install -g ShellUI.CLI --version 0.3.0-rc.1

# Or upgrade from alpha.2
dotnet tool update -g ShellUI.CLI --version 0.3.0-rc.1

shellui init
shellui add button card dialog

# NuGet packages
dotnet add package ShellUI.Core --version 0.3.0-rc.1 --prerelease
dotnet add package ShellUI.Components --version 0.3.0-rc.1 --prerelease

What's next

rc.1 is feature-frozen for the v0.3.0 line. Internal testing is in progress — file blockers on GitHub. If none surface, v0.3.0 ships from this RC unchanged.