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 toShell.Cn("...")inside aclassattribute, plus those in conditional expressions. Among them were the dialog's centring (translate-x-[-50%],translate-y-[-50%]),sm:rounded-lgand the Sonner variant colours, so in those apps dialogs weren't centred. The precompiledshellui-all.csswasn't affected. - Package icon:
ShellUI.CLIandShellUI.Componentsshowed nuget.org's default icon. They now use the ShellUI logo.
Upgrading
- NuGet package: update
ShellUI.Componentsto0.3.6. If you build your own Tailwind CSS fromshellui-classes.txt, rebuild it afterwards. - CLI: update the tool to
0.3.6. Nothing changes in projects it set up.
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.
initused 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(setSHELLUI_CACHE_DIRto move it), andinitand the build both run it from there; a copy in a project's.shellui/binstill wins. Downloads resume after a dropped connection, retry, and only stop after 60 seconds without data. If the download fails,initfinishes everything else and the next build tries again..shellui/gets its own.gitignore, so the folder stays out of git. updatekeeps your changes.shellui.jsonnow records a hash of each file the CLI writes.updateskips files you've changed since and says so (--forceoverwrites them), and installs dependencies a component gained since you added it, the same wayadddoes. Files installed by an earlier CLI have no hash; for those,updatekeepsapp-sidebarand thedashboard-*layouts when they differ from the template.updatemoves existing projects onto the shared Tailwind CLI. It replaces aBuild/ShellUI.targetswritten 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.removefinds whatinstallwrote. It always looked inComponents/UI, so it ignored a customComponentsPath, 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.addnever downgrades a NuGet package. It used to set the exact version a component pins, so addingchartto 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 (includingDirectory.Packages.props).- Razor class libraries.
initrecognises a library shared by several apps, prints what each app needs with the library's_contentpath, and adds its@usingto a root_Imports.razor. See Razor Class Library.
Components (package and CLI templates)
Classoverrides a component's own classes.Shell.Cnused to join strings, soClass="max-w-lg"on a component that setsmax-w-mdput 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-4replaces an earlierpx-2, text colour and text size stay separate, and unknown classes are kept. You no longer need the!modifier. Runshellui update shellto 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.
RadioGroupItemalso gainsDisabled. - ScrollArea: long content was clipped instead of scrolling.
HeightandMaxHeightnow size the scrolling element. Thescrollbar-*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:
Stepnow 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
Classand extra attributes. - Sheet and Drawer: clicks inside the panel no longer reach parent click handlers, and the Sheet close button shows when only
Descriptionis set. - Label (package) renders
Foras theforattribute; FileUpload (package) uses an inline SVG icon instead of the Material Symbols font; CarouselItem (template) handles zero slides. - Still working but deprecated:
DatePicker.SelectedDateandTimePicker.SelectedTime. UseValue/@bind-Value.
Upgrading
- CLI: update the tool, then run
shellui updatein each project. Commit first so you can review the changes. If the project still has a.shellui/bin/tailwindcssbinary afterwards, you can delete it: the next build downloads the shared copy. - NuGet package: update
ShellUI.Componentsto0.3.5. - If you used
Class="…!"to beat a component's own classes, you can drop the!.
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:
TimePickerthrew aFormatExceptionwheneverValuewas set, because it formatted theTimeSpanwith 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 setcolor-schemetolightin:rootanddarkin.dark: inshellui-theme.cssandshellui-all.cssin the package, and in the themeshellui initandshellui theme applywrite.
Upgrading
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.cssdirectly logged a 404 on every page load, because the file started with@import "tailwindcss";and the browser requestedtailwindcssas a URL. The theme file now holds only the theme; the precompiledshellui-all.cssis unchanged. CommandignoredCommandItem.Action: selecting an item only raisedCommandSelected. It now runs the item'sAction, then raisesCommandSelected, the same asCommandPalette.DropdownandPopovernow close on Escape.- CLI
SidebarProviderlogged aJSDisconnectedExceptiontwice on every full page reload, typed URL or closed tab. It now ignores the disconnected circuit when it cleans up.
Upgrading
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
MultiSeriesChartthrew on every render in the NuGet package. It now renders, inside the same card asChart.- NuGet package:
ThemeToggleflipped 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'sshellui.jsnow loads automatically through a Blazor JS initializer, with no<script>tag needed. ThemeTogglekept a list of instances shared by every user on Blazor Server. Toggles now follow the page'sdarkclass, so every toggle on a page stays in sync and starts from the page's actual theme.DatePickerandDateRangePicker: the calendar popover has a width, so it's no longer squeezed in a flex row.DataPickerandMultiSelect: option rows are left-aligned, so customOptionTemplates no longer render centered.- Removed leftover Razor class library template files (
Component1,ExampleJsInterop,background.png) from the package.
Upgrading
dotnet add package ShellUI.Components --version 0.3.2
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,CarouselNextandCarouselPreviouscompiled into theShellUI.Components.Componentsnamespace, so@using ShellUI.Componentsdid not find them. They are now inShellUI.Componentslike every other component.
Upgrading
dotnet add package ShellUI.Components --version 0.3.1
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.ComponentsNuGet package targets .NET 10 only. - Tailwind CSS 4.3.2.
shellui initproduces an app that builds and runs. It patchesApp.razor(render mode, theme bootstrap,shellui.js), writes the full theme toinput.css, and wires Tailwind into the build.shellui addresolves everything a component needs: sub-components, models and variants, NuGet packages (Blazor-ApexCharts,System.Linq.Dynamic.Core), and the@usinglines 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.cssbundle 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". Classis accepted everywhere;ClassNamestill works but is deprecated.
Upgrading
- From a 0.3.0 release candidate: update the tool, then run
shellui updateto rewrite the installed components from the new templates.updateoverwrites 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.
dotnet tool update -g ShellUI.CLI --version 0.3.0
dotnet add package ShellUI.Components --version 0.3.0