# Release Notes > What changed in the ShellUI 0.4 line, and how to upgrade. Source: https://shellui.dev/docs/v0.4/release-notes The full history is in [RELEASE_NOTES.md](https://github.com/shellui-dev/shellui/blob/main/docs/RELEASE_NOTES.md) on GitHub. For 0.3.x, see the [v0.3 release notes](https://shellui.dev/docs/v0.3/release-notes.md). ## v0.4.0 The 0.4 stable release. Compared with 0.3 it adds 19 components and three sign-in page blocks, compositional parts for eight more, `shellui add all`, `doctor` and `migrate`, .NET 8 and 9 support, and a CLI that keeps your changes on `update`. This section sums up the whole 0.4 line; the alpha sections below have the details. ### New in 0.4 - **Components.** [Kbd](https://shellui.dev/docs/v0.4/components/data-display/kbd.md), [Aspect Ratio](https://shellui.dev/docs/v0.4/components/layout/aspect-ratio.md), [Button Group](https://shellui.dev/docs/v0.4/components/form/button-group.md), [Toggle Group](https://shellui.dev/docs/v0.4/components/form/toggle-group.md), [Input Group](https://shellui.dev/docs/v0.4/components/form/input-group.md), [Number Input](https://shellui.dev/docs/v0.4/components/form/number-input.md), [Stat Card](https://shellui.dev/docs/v0.4/components/data-display/stat-card.md), [Timeline](https://shellui.dev/docs/v0.4/components/data-display/timeline.md), [Tree View](https://shellui.dev/docs/v0.4/components/data-display/tree-view.md), [QR Code](https://shellui.dev/docs/v0.4/components/data-display/qr-code.md), [Image Viewer](https://shellui.dev/docs/v0.4/components/advanced/image-viewer.md) and [Chat](https://shellui.dev/docs/v0.4/components/advanced/chat.md) with `chat-message` and `chat-input` (0.4.0-alpha.1), and since alpha.3: - **[Prompt Suggestions](https://shellui.dev/docs/v0.4/components/advanced/prompt-suggestions.md)**: clickable suggestion chips for an empty chat. - **[Reasoning](https://shellui.dev/docs/v0.4/components/advanced/reasoning.md)**: a collapsible block that streams a model's thinking, open while `IsStreaming` and folded to "Thought for N seconds" after. - **[Tool Call](https://shellui.dev/docs/v0.4/components/advanced/tool-call.md)**: a tool's name with a pending, running, done or error badge; it opens to show the arguments, result or error. - **[Field](https://shellui.dev/docs/v0.4/components/form/field.md)**: label, control, description and validation message as one unit, vertical or horizontal; `For` shows the `EditForm`'s messages. - **[JSON Viewer](https://shellui.dev/docs/v0.4/components/data-display/json-viewer.md)**: a highlighted, foldable JSON tree from a string or any object, with a copy button. - **[Resizable](https://shellui.dev/docs/v0.4/components/layout/resizable.md)** is now a real panel group: `ResizablePanelGroup`, `ResizablePanel` (`DefaultSize`, `MinSize`, `MaxSize`) and `ResizableHandle`, dragged with the pointer or moved with the arrow keys, Home and End. The browser moves the panels and reports the sizes once, so dragging doesn't wait on Blazor Server. The old `Resizable` stays in the package, deprecated. - **Blocks.** `init --dashboard 01|02` wires a [dashboard layout](https://shellui.dev/docs/v0.4/dashboard.md) into the app, and the new `auth-01`, `auth-02` and `auth-03` blocks give apps that use ASP.NET Core Identity their own [sign-in pages](https://shellui.dev/docs/v0.4/authentication.md). - **Compositional parts** for Alert Dialog, Breadcrumb, Command, Form, Menubar, Pagination, Sheet and Drawer. Each mode is opt-in, so existing markup keeps working. - **`SonnerService.Clear()`** and **`Destructive`** context menu items. - **.NET 8 and 9.** The CLI runs on .NET 8 or later, and `ShellUI.Components` targets .NET 8, 9 and 10. The 0.3 line needed .NET 10. ### CLI - **`shellui add all`** installs every component except the page blocks; `--except` leaves out a component and everything that depends on it. - **`shellui doctor`** checks the project's setup and says how to fix each problem; it exits 1 on errors, so it can run in CI. - **`shellui migrate`** rewrites your pages for template API changes after `update`: `Input.InputVariant.X`, the DatePicker and TimePicker `Selected*` parameters and `Pagination.OnPageChange`. It shows each changed line and asks first (`--dry-run`, `--yes`), and points out `Calendar` handlers that need a `DateTime?`. - **`update` keeps your changes** and installs dependencies a component gained since you added it. **`add` never downgrades** a NuGet package. **`remove`** follows your `ComponentsPath`. - **One Tailwind CLI per machine** in `~/.shellui/bin`, with resumable downloads, instead of a copy in every project. - **Razor class libraries:** `init` recognises a library shared by several apps. See [Razor Class Library](https://shellui.dev/docs/v0.4/installation/razor-class-library.md). See the [CLI guide](https://shellui.dev/docs/v0.4/installation/cli.md) for each command. ### Fixes since 0.4.0-alpha.3 - **`add` hung on .NET 8 and 9 apps.** The CLI waited for `dotnet add package`, npm and Tailwind to exit before reading their output, so once a process wrote more than a pipe buffer both sides waited forever. `shellui add all` stopped on restoring Blazor-ApexCharts. Output is now read while the process runs. - **The CLI didn't start on a machine with only .NET 9** (or a newer runtime). It now rolls forward to any .NET 8 or later runtime. - **`doctor` said `app.css` was stale right after a build.** Tailwind skips writing unchanged output, so the file kept an old timestamp. The build now touches it; `update` brings the change to projects set up by alpha.2 and alpha.3. - **`list --installed`** said "0 available" (and `--available` "0 installed"). The summary now counts every target. - **Safelist:** classes passed to `Shell.Cn("…")` and literals in ternaries never reached `shellui-classes.txt`, so 198 classes were missing for apps that build their own Tailwind CSS from the package. - Everything fixed in 0.3.5 and 0.3.6 is included. ### Breaking changes from 0.3 - **`Calendar.SelectedDateChanged`** is `EventCallback`. Handlers that take a `DateTime` must take a `DateTime?` (`shellui migrate` lists them). - **CLI templates, after `shellui update`:** `Input.InputVariant` is now `InputVariant` (new `input-variants` template); Stepper parts read the stepper's `ActiveStep` instead of a `CurrentStep` parameter; `ScrollArea` drops its `scrollbar-*` classes; `shellui add resizable` installs the panel group. `shellui migrate` fixes the `InputVariant` uses. - Still working but deprecated: `Pagination.OnPageChange`, `DatePicker.SelectedDate`, `TimePicker.SelectedTime` and the old `Resizable`. `shellui migrate` moves you off the first three. ### Upgrading from 0.3 - **CLI:** `dotnet tool update -g ShellUI.CLI`, then in each project commit, run `shellui update`, then `shellui migrate`, and build. `shellui doctor` checks the result. - **NuGet package:** update `ShellUI.Components` to `0.4.0`. If you handle `Calendar.SelectedDateChanged`, change the handler's parameter to `DateTime?`. - If you used `Class="…!"` to beat a component's own classes, you can drop the `!`. The same steps upgrade a project on a 0.4 prerelease. ```bash dotnet tool update -g ShellUI.CLI shellui update shellui migrate shellui doctor ``` ```bash dotnet add package ShellUI.Components --version 0.4.0 ``` [Full changelog: v0.3.6...v0.4.0](https://github.com/shellui-dev/shellui/compare/v0.3.6...v0.4.0) ## v0.4.0-alpha.3 The third 0.4 prerelease. A component's `Class` now overrides its own classes, dialogs and sheets keep keyboard focus inside, `add` never downgrades your NuGet packages, and the CLI templates have been brought in line with the NuGet package, fixing several template bugs on the way. It also adds Razor class library support. ### Improvements - **`Class` overrides a component's own classes.** `Shell.Cn` used to join strings, so `` 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. The NuGet package and the CLI's `Shell.cs` share the same code. - **Focus stays inside open overlays.** [Dialog](https://shellui.dev/docs/v0.4/components/layout/dialog.md), [Alert Dialog](https://shellui.dev/docs/v0.4/components/advanced/alert-dialog.md), [Sheet](https://shellui.dev/docs/v0.4/components/layout/sheet.md) and [Drawer](https://shellui.dev/docs/v0.4/components/layout/drawer.md) keep Tab and Shift+Tab inside while they're open, and return focus to where it was when they close. The legacy (non-compositional) Sheet and Drawer panels now also take focus and close on Escape. - **`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 reads the project's `PackageReference` (or `Directory.Packages.props`), adds a missing package or raises an older one, and leaves the same or newer, floating versions and ranges alone. - **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](https://shellui.dev/docs/v0.4/installation/razor-class-library.md). ### Fixes: CLI templates now match the package The CLI templates and the NuGet package had drifted apart. They're reconciled (210 of 217 components identical, the rest differ by design), and a test now compares them. Bugs this fixed: - **[Radio Group](https://shellui.dev/docs/v0.4/components/form/radio-group.md)** (template): clicking an item did nothing, because the group never passed itself to its items. `RadioGroupItem` also gains `Disabled`. - **ScrollArea** (template): long content was clipped instead of scrolling. `Height` and `MaxHeight` now size the scrolling element. - **[Date Picker](https://shellui.dev/docs/v0.4/components/advanced/date-picker.md)** (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`. - **[Sheet](https://shellui.dev/docs/v0.4/components/layout/sheet.md) and [Drawer](https://shellui.dev/docs/v0.4/components/layout/drawer.md)**: clicks inside the panel no longer reach parent click handlers; the close button shows when only `Description` is set; the templates switch to compositional mode by themselves (no `Compositional="true"` needed). - **[Label](https://shellui.dev/docs/v0.4/components/form/label.md)** renders `For` as the `for` attribute; **FileUpload** uses an inline SVG icon instead of the Material Symbols font; **CarouselItem** handles zero slides. - **[Pagination](https://shellui.dev/docs/v0.4/components/navigation/pagination.md)** supports `@bind-CurrentPage` in both copies and ignores clicks on the current page; **[Toast](https://shellui.dev/docs/v0.4/components/data-display/toast.md)** has success and warning variants, `Position`, auto-dismiss after `Duration` (0 keeps it open) and a labelled close button; **[Skeleton](https://shellui.dev/docs/v0.4/components/data-display/skeleton.md)** has `Variant` (`default`, `circle`, `text`); **NavigationMenuItem** is a dropdown when `Title` is set and a link or button otherwise. - `Table`, `Separator`, `Slider`, `Navbar`, `Checkbox`, `Switch`, `Tooltip`, `SidebarMenuButton`, `Menubar` and `ThemeToggle` templates now match the package's markup and classes. ### Breaking changes (CLI templates, after `shellui update`) - **Input variants** moved out of the component: `Input.InputVariant.Error` is now `InputVariant.Error`, from the new `input-variants` template in `Components/UI/Variants` (like `ButtonVariant`). `Textarea` gains `Variant`, `ReadOnly`, `OnFocus` and `OnBlur` through `textarea-variants`. - **[Stepper](https://shellui.dev/docs/v0.4/components/advanced/stepper.md)** parts read the stepper's `ActiveStep` instead of taking a `CurrentStep` parameter, and the template gains the package's data-driven `StepItems` mode (`StepItem` comes from the new `stepper-models` template). - **ScrollArea** drops its `scrollbar-*` classes, which needed a Tailwind plugin nobody shipped. - Still working but deprecated: `Pagination.OnPageChange` (use `@bind-CurrentPage`), `DatePicker.SelectedDate` and `TimePicker.SelectedTime` (use `Value` / `@bind-Value`). `shellui update` installs the new `input-variants`, `textarea-variants` and `stepper-models` templates for you, and skips files you've changed since installing them. ### Upgrading from 0.4.0-alpha.2 - **CLI:** update the tool, then run `shellui update`. Commit first so you can review the changes, and fix any `Input.InputVariant` and Stepper `CurrentStep` uses (see above). - **NuGet package:** update `ShellUI.Components` to `0.4.0-alpha.3`. - If you used `Class="…!"` to beat a component's own classes, you can drop the `!`. Upgrading from 0.3: follow the 0.4.0-alpha.1 and 0.4.0-alpha.2 notes below, then the steps above. ```bash dotnet tool update -g ShellUI.CLI --version 0.4.0-alpha.3 dotnet add package ShellUI.Components --version 0.4.0-alpha.3 ``` [Full changelog: v0.4.0-alpha.2...v0.4.0-alpha.3](https://github.com/shellui-dev/shellui/compare/v0.4.0-alpha.2...v0.4.0-alpha.3) ## v0.4.0-alpha.2 The second 0.4 prerelease. It fixes `shellui update`, which could leave a project upgraded from 0.3 unable to build, and makes `update` keep the files you changed. The Tailwind CLI is now downloaded once per machine instead of into every project, and the download survives slow connections. It also fixes `remove`, the dark theme and the package `TimePicker`. ### Tailwind CLI: once per machine - **Projects no longer hold the binary.** The standalone Tailwind CLI (about 110 MB) is downloaded once into `~/.shellui/bin` (or `SHELLUI_CACHE_DIR`), and `init` and the build run it from there. A new project went from about 112 MB to 130 KB, and later projects set up offline. A copy in a project's `.shellui/bin` still takes precedence. The binary is a build tool and never ships with your app. - **Nothing in `.shellui/` is committed:** it now contains a `.gitignore` of `*`. - **Slow connections work.** The download streams to a `.partial` file, resumes after a dropped connection, retries, and only gives up after a minute with no data. The build's own download uses the same cache and retries too. - **A failed download no longer stops `init`.** It finishes the rest of the setup and warns, and the next build tries again; its warning names the URL and where to save the file. ### `shellui update` and `remove` - **`update` installs new dependencies.** Components gain parts between versions; in 0.4, `breadcrumb` gained `breadcrumb-list`, `-link`, `-page`, `-separator` and `-ellipsis`, and `tabs` gained `tab-models`. `update` only rewrote existing files, so a project updated from 0.3 failed to build (`BreadcrumbList`, `TabItem` not found). It now installs missing dependencies the way `add` does, with their NuGet packages and `_Imports.razor` usings. - **`update` keeps your changes.** `shellui.json` now records a hash of each file the CLI writes. `update` skips files you have changed since and says so; `--force` overwrites them. - **`remove` finds files the way install writes them.** It honours a custom `ComponentsPath`, removes dashboard and auth layouts, lists files that still use a removed layout (usually `Routes.razor`), and counts what it removed. ### Fixes - **Dark theme:** the themes set `color-scheme`, so the browser draws its own controls (the `` calendar, number spinners, scrollbars, autofill, `