Release Notes

What changed in the ShellUI 0.3 line, and how to upgrade.

The full history, including every 0.3.0 alpha and release candidate, is in RELEASE_NOTES.md on GitHub.

v0.3.6

A small patch: both packages now show the ShellUI logo on nuget.org, and the ShellUI.Components safelist includes the classes it was missing.

Fixes

  • Safelist: shellui-classes.txt, which apps building their own Tailwind CSS from the package use, was missing 181 classes the components render: every class passed to Shell.Cn("...") inside a class attribute, plus those in conditional expressions. Among them were the dialog's centring (translate-x-[-50%], translate-y-[-50%]), sm:rounded-lg and the Sonner variant colours, so in those apps dialogs weren't centred. The precompiled shellui-all.css wasn't affected.
  • Package icon: ShellUI.CLI and ShellUI.Components showed nuget.org's default icon. They now use the ShellUI logo.

Upgrading

  • NuGet package: update ShellUI.Components to 0.3.6. If you build your own Tailwind CSS from shellui-classes.txt, rebuild it afterwards.
  • CLI: update the tool to 0.3.6. Nothing changes in projects it set up.
bash
dotnet tool update -g ShellUI.CLI --version 0.3.6
dotnet add package ShellUI.Components --version 0.3.6

Full changelog: v0.3.5...v0.3.6

v0.3.5

A patch release that brings the 0.4 prerelease fixes to the stable line. init no longer downloads the Tailwind CLI into every project, update keeps your changes, add never downgrades a NuGet package, a component's Class overrides its own classes, overlays keep keyboard focus inside, and several component bugs are fixed. It also adds Razor class library support.

CLI

  • One Tailwind CLI per machine. init used to download the 112 MB Tailwind CLI into every project, hold it in memory and give up after five minutes, so on a slow connection it failed and left the project half set up. The CLI now lives once in ~/.shellui/bin (set SHELLUI_CACHE_DIR to move it), and init and the build both run it from there; a copy in a project's .shellui/bin still wins. Downloads resume after a dropped connection, retry, and only stop after 60 seconds without data. If the download fails, init finishes everything else and the next build tries again. .shellui/ gets its own .gitignore, so the folder stays out of git.
  • update keeps your changes. shellui.json now records a hash of each file the CLI writes. update skips files you've changed since and says so (--force overwrites them), and installs dependencies a component gained since you added it, the same way add does. Files installed by an earlier CLI have no hash; for those, update keeps app-sidebar and the dashboard-* layouts when they differ from the template.
  • update moves existing projects onto the shared Tailwind CLI. It replaces a Build/ShellUI.targets written by an earlier CLI (unless you edited it) and deletes the project's copy of the Tailwind CLI when it is identical to the shared one.
  • remove finds what install wrote. It always looked in Components/UI, so it ignored a custom ComponentsPath, couldn't remove the dashboard layouts, and reported every name as removed. It now uses the install path, reports only what it removed, and lists files that still use a removed layout.
  • add never downgrades a NuGet package. It used to set the exact version a component pins, so adding chart to an app on Blazor-ApexCharts 7 moved it back to 6.0.2. Now it adds a missing package or raises an older one, and leaves the same or newer versions, floating versions and ranges alone (including Directory.Packages.props).
  • Razor class libraries. init recognises a library shared by several apps, prints what each app needs with the library's _content path, and adds its @using to a root _Imports.razor. See Razor Class Library.

Components (package and CLI templates)

  • Class overrides a component's own classes. Shell.Cn used to join strings, so Class="max-w-lg" on a component that sets max-w-md put both on the element and the stylesheet decided. Now, when two classes set the same CSS property under the same variants, the later one (yours) wins, like tailwind-merge: p-4 replaces an earlier px-2, text colour and text size stay separate, and unknown classes are kept. You no longer need the ! modifier. Run shellui update shell to get it in a CLI project.
  • Focus stays inside open overlays. Dialog, Alert Dialog, Sheet and Drawer keep Tab and Shift+Tab inside while open and return focus to where it was when they close. The non-compositional Sheet and Drawer panels now also take focus and close on Escape.

Fixes

  • Radio Group (template): clicking an item did nothing, because the group never passed itself to its items. RadioGroupItem also gains Disabled.
  • ScrollArea: long content was clipped instead of scrolling. Height and MaxHeight now size the scrolling element. The scrollbar-* classes, which needed a Tailwind plugin nobody shipped, are gone.
  • Date Picker (package): day 1 was always drawn under Sunday. It now sits under its real weekday, and the picker opens on the selected month.
  • TimePicker: Step now filters the minutes (it was ignored), the picker opens on the current value, and Cancel or an outside click closes it.
  • DateRangePicker (template) closes on an outside click; EmptyState (template) applies Class and extra attributes.
  • Sheet and Drawer: clicks inside the panel no longer reach parent click handlers, and the Sheet close button shows when only Description is set.
  • Label (package) renders For as the for attribute; FileUpload (package) uses an inline SVG icon instead of the Material Symbols font; CarouselItem (template) handles zero slides.
  • Still working but deprecated: DatePicker.SelectedDate and TimePicker.SelectedTime. Use Value / @bind-Value.

Upgrading

  • CLI: update the tool, then run shellui update in each project. Commit first so you can review the changes. If the project still has a .shellui/bin/tailwindcss binary afterwards, you can delete it: the next build downloads the shared copy.
  • NuGet package: update ShellUI.Components to 0.3.5.
  • If you used Class="…!" to beat a component's own classes, you can drop the !.
bash
dotnet tool update -g ShellUI.CLI --version 0.3.5
dotnet add package ShellUI.Components --version 0.3.5

Full changelog: v0.3.4...v0.3.5

v0.3.4

A patch release with a TimePicker fix for the ShellUI.Components NuGet package and dark-theme fixes for both the package and the CLI.

Fixes

  • NuGet package: TimePicker threw a FormatException whenever Value was set, because it formatted the TimeSpan with a date pattern. It now shows the time, the same as the CLI template.
  • Dark theme: the browser kept drawing its own controls light on a dark page (the <input type="date"> calendar, number spinners, scrollbars, autofill and <select> lists). The themes now set color-scheme to light in :root and dark in .dark: in shellui-theme.css and shellui-all.css in the package, and in the theme shellui init and shellui theme apply write.

Upgrading

bash
dotnet add package ShellUI.Components --version 0.3.4

With the CLI, update the tool. Existing projects keep their input.css: add color-scheme: light; inside :root and color-scheme: dark; inside .dark, or run shellui theme apply again if you use a tweakcn theme.

Full changelog: v0.3.3...v0.3.4

v0.3.3

A patch release with fixes for both the ShellUI.Components NuGet package and the CLI templates.

Fixes

  • NuGet package: linking shellui-theme.css directly logged a 404 on every page load, because the file started with @import "tailwindcss"; and the browser requested tailwindcss as a URL. The theme file now holds only the theme; the precompiled shellui-all.css is unchanged.
  • Command ignored CommandItem.Action: selecting an item only raised CommandSelected. It now runs the item's Action, then raises CommandSelected, the same as CommandPalette.
  • Dropdown and Popover now close on Escape.
  • CLI SidebarProvider logged a JSDisconnectedException twice on every full page reload, typed URL or closed tab. It now ignores the disconnected circuit when it cleans up.

Upgrading

bash
dotnet add package ShellUI.Components --version 0.3.3

With the CLI, update the tool, then run shellui update to rewrite installed components from the new templates. update overwrites the files, so commit or back up any components you customized first.

Full changelog: v0.3.2...v0.3.3

v0.3.2

A patch release with component fixes for both the ShellUI.Components NuGet package and the CLI templates.

Fixes

  • MultiSeriesChart threw on every render in the NuGet package. It now renders, inside the same card as Chart.
  • NuGet package: ThemeToggle flipped its icon but didn't change the theme, dialogs, sheets and drawers didn't lock page scrolling, and close-on-scroll dropdowns stayed open. The package's shellui.js now loads automatically through a Blazor JS initializer, with no <script> tag needed.
  • ThemeToggle kept a list of instances shared by every user on Blazor Server. Toggles now follow the page's dark class, so every toggle on a page stays in sync and starts from the page's actual theme.
  • DatePicker and DateRangePicker: the calendar popover has a width, so it's no longer squeezed in a flex row.
  • DataPicker and MultiSelect: option rows are left-aligned, so custom OptionTemplates no longer render centered.
  • Removed leftover Razor class library template files (Component1, ExampleJsInterop, background.png) from the package.

Upgrading

bash
dotnet add package ShellUI.Components --version 0.3.2
Remove the 0.3.x workarounds

If you load _content/ShellUI.Components/shellui.js with a <script> tag, remove it: the package loads it for you, and it's now an ES module, so a classic <script> tag fails. Remove any ShellUI.addClassToDocument / removeClassFromDocument shim too.

With the CLI, update the tool, then run shellui update to rewrite installed components, including shellui.js, from the new templates. update overwrites the files, so commit or back up any components you customized first.

Full changelog: v0.3.1...v0.3.2

v0.3.1

A patch release for the ShellUI.Components NuGet package. The CLI and its templates have no changes beyond the version number.

Fixes

  • Calendar, Command, DataTable, FileUpload, CarouselContent, CarouselDots, CarouselNext and CarouselPrevious compiled into the ShellUI.Components.Components namespace, so @using ShellUI.Components did not find them. They are now in ShellUI.Components like every other component.

Upgrading

bash
dotnet add package ShellUI.Components --version 0.3.1
Remove the 0.3.0 workaround

If you added @using ShellUI.Components.Components to _Imports.razor to work around this, remove it: that namespace no longer exists, so the line now fails the build.

Known issues

MultiSeriesChart threw when it rendered, and ThemeToggle only flipped its icon, in the 0.3.0 and 0.3.1 NuGet packages. Both are fixed in 0.3.2.

Full changelog: v0.3.0...v0.3.1

v0.3.0

The first stable release of the 0.3 line. It builds on .NET 10 and Tailwind CSS 4.3.2 and includes everything from the 0.3.0 alphas and release candidates. Until 0.4.0 was released, a plain dotnet tool install picked it up; now name the version.

Highlights since 0.2.1

  • Blazor on .NET 8, 9 and 10. The CLI needs the .NET 10 SDK, and the components it installs build in projects on .NET 8, 9 and 10. The ShellUI.Components NuGet package targets .NET 10 only.
  • Tailwind CSS 4.3.2.
  • shellui init produces an app that builds and runs. It patches App.razor (render mode, theme bootstrap, shellui.js), writes the full theme to input.css, and wires Tailwind into the build.
  • shellui add resolves everything a component needs: sub-components, models and variants, NuGet packages (Blazor-ApexCharts, System.Linq.Dynamic.Core), and the @using lines in _Imports.razor. Typos get a "did you mean" suggestion.
  • 76 components, including Command Palette, Data Picker, Multi Select, Tag Input, Typed Select, and the Donut, Radar and Radial charts.
  • Composable APIs for Select, Dropdown, Popover, ContextMenu, NavigationMenu, Carousel, HoverCard, Accordion and Tabs, installed together with their parent.
  • Themes from tweakcn: shellui theme init | apply | update.
  • NuGet package with a precompiled shellui-all.css bundle and a Tailwind safelist, so it works without a Tailwind build step.
  • Accessibility: Dialog, Sheet and Drawer take focus on open, close on Escape, and set role="dialog".
  • Class is accepted everywhere; ClassName still works but is deprecated.

Upgrading

  • From a 0.3.0 release candidate: update the tool, then run shellui update to rewrite the installed components from the new templates. update overwrites the files, so commit or back up any components you customized first.
  • From 0.2.1: install the .NET 10 SDK to run the CLI. Your project can stay on .NET 8 or 9 when you use the CLI; the NuGet package needs .NET 10.
bash
dotnet tool update -g ShellUI.CLI --version 0.3.0
bash
dotnet add package ShellUI.Components --version 0.3.0

Full changelog: v0.2.1...v0.3.0

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.