ShellUI v0.2.1

ShellUI v0.2.1 🛠️

Hotfix release - Chart fixes & CSS auto-install

🐛 Bug Fixes

• Fixed chart tooltip escaping - Custom tooltip HTML in ChartVariantsTemplate.cs used incorrect verbatim string escaping (\"" → """") causing broken @"..." blocks in installed files
• Fixed ChartVariants namespace - ShellUI.Components.Variants.ChartVariants was incorrectly under ShellUI.Components namespace
• Fixed Chart.razor missing using - Added @using ShellUI.Components.Variants to the Components library Chart.razor
• Fixed ChartVariantsTemplate FilePath - Changed from "ChartVariants.cs" to "Variants/ChartVariants.cs" to install in correct subdirectory
• Fixed ChartVariantsTemplate IsAvailable - Set to false since it's a dependency, not a standalone component

✨ New Features

Chart Styles CSS (chart-styles)

• New charts.css file auto-installs to wwwroot/css/ as a dependency when you run shellui add chart
• Contains all ApexCharts theme CSS: tooltips, custom tooltips, legends, toolbars, grid/axis styling
• Uses ShellUI CSS variables with hardcoded fallbacks for portability
• Replaces the previous approach of requiring manual CSS setup

CLI: wwwroot File Support

• Components with FilePath starting with wwwroot/ now correctly install relative to project root instead of inside Components/UI/

CLI: Automatic CSS Link Injection

• After installing chart-styles, the CLI automatically injects <link rel="stylesheet" href="css/charts.css" /> into your App.razor (or index.html for WASM)
• Idempotent — re-running shellui add chart won't duplicate the link
• Falls back to printing manual instructions if no layout file is found

📦 What shellui add chart now installs

shellui add chart
→ Installed 'chart-variants' (Variants/ChartVariants.cs)
→ Installed 'chart-styles' (wwwroot/css/charts.css)
→ Installed 'chart' (Chart.razor)
→ Added <link rel="stylesheet" href="css/charts.css" /> to Components\App.razor

Installed 3 component(s) successfully!

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

ShellUI v0.2.0 📊

Feature release - Charts & Data Visualization

✨ New Features

Charts & Data Visualization (7 new components)

Built on ApexCharts.Blazor with full ShellUI theme integration:

• Chart - Base chart component with theme-aware styling
• BarChart - Vertical bar charts
• LineChart - Smooth line charts
• AreaChart - Filled area charts
• PieChart - Pie charts with custom tooltips
• MultiSeriesChart - Multiple data series on one chart
• ChartSeries - Flexible series composition

Chart Themes

Three built-in color themes via ChartTheme enum:

• Default - Professional blue-based palette (blue, red, green, yellow, purple)
• Colorful - Vibrant multi-color palette with 7 colors
• Monochrome - Slate grays for minimal aesthetic

Theme-Aware Chart Containers

Charts automatically use your theme's CSS variables:

• var(--radius) for border radius
• var(--shadow) for box shadow
• var(--border), var(--card), var(--card-foreground) for colors

Custom Tooltips

Fully custom HTML tooltips replacing ApexCharts defaults:

• Compact, shadcn-inspired design
• Proper marker/text alignment via flexbox
• Multi-series support (shows all values at a data point)
• Light/dark mode support via CSS variables
• Separate pie chart tooltip using seriesIndex

🐛 Bug Fixes

• Fixed version mismatch - Component versions now correctly read from assembly metadata instead of hardcoded fallback
• Fixed Tailwind version in config - shellui.json now correctly shows Tailwind v4.1.18 for all install methods
• Fixed CS1998 warnings - Removed unnecessary async from synchronous methods in ComponentInstaller

🔧 Improvements

• Tailwind CSS updated to v4.1.18
• Component count: 80 (73 existing + 7 new chart components)
• X-axis labels - Charts use XAxisType.Category for proper string label display
• Version system - Fallback version now reads AssemblyInformationalVersion baked at build time

📦 Installation

# Install CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add chart components
shellui add chart bar-chart line-chart pie-chart area-chart multi-series-chart

Or via NuGet:

dotnet add package ShellUI.Components

Note: Charts require the Blazor-ApexCharts NuGet package:

dotnet add package Blazor-ApexCharts

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

Full Changelog: v0.1.1...v0.2.0

ShellUI v0.3.0-alpha.2

ShellUI v0.3.0-alpha.2 🚧

Second alpha of v0.3.0 — fixes CLI registry for Drawer/Sheet compositional subcomponents. Report issues via GitHub Issues.

What's in this release

v0.3.0-alpha.2 fixes the CLI template registry so that Drawer and Sheet correctly ship with their compositional subcomponent pattern introduced in alpha.1.

🐛 Fixes (from alpha.1)

• Drawer/Sheet templates upgraded to v0.3.0 — Open/OpenChanged replaces IsOpen/IsOpenChanged, DrawerSide/SheetSide enums replace string-based side props, explicit Compositional parameter enables subcomponent mode
• Missing subcomponent templates added — DrawerTrigger, DrawerContent, SheetTrigger, SheetContent were missing from the registry entirely
• Missing variant templates added — DrawerVariants (with DrawerSide enum) and SheetVariants (with SheetSide enum) now installable
• Dependency direction fixed — shellui add drawer now auto-installs all 4 files (Drawer, DrawerVariants, DrawerTrigger, DrawerContent); same for shellui add sheet

✨ What changed

Command	alpha.1	alpha.2
shellui add drawer	Installed old v0.2.x Drawer only	Installs Drawer + DrawerVariants + DrawerTrigger + DrawerContent
shellui add sheet	Installed old v0.2.x Sheet only	Installs Sheet + SheetVariants + SheetTrigger + SheetContent

🔧 Improvements

• Version bump — 0.3.0-alpha.1 → 0.3.0-alpha.2
• Subcomponent dependency pattern — Follows parent-owns-children convention (same as Dialog, Collapsible, etc.)

📦 Installation

# Install CLI (alpha)
dotnet tool install -g ShellUI.CLI --version 0.3.0-alpha.2

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

Initialize and add components:

shellui init
shellui add drawer       # installs Drawer + DrawerVariants + DrawerTrigger + DrawerContent
shellui add sheet        # installs Sheet + SheetVariants + SheetTrigger + SheetContent

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

Full Changelog: v0.3.0-alpha.1...v0.3.0-alpha.2

---

ShellUI v0.3.0-alpha.1 🚧 (Historical)

First alpha of v0.3.0 — test thoroughly before stable. Report issues via GitHub Issues.

What's in this release

v0.3.0-alpha.1 includes everything from v0.2.0 (charts, Tailwind 4.x) plus new components and improvements.

✨ New Components

Docs essentials:

• Callout / CalloutVariants — Info, warning, tip, danger admonition boxes
• CopyButton — One-click copy to clipboard
• LinkCard — Card-style links for related pages
• PrevNextNav — Previous/Next page navigation for docs

Feedback & Data:

• Sonner / SonnerService / SonnerVariants — Modern toast notifications (shadcn-style)
• Stepper / StepperList / StepperStep / StepperContent — Step-by-step wizard with value-based API
• ChartVariants — Variant styling support for charts

🔧 Improvements

• Version bump — 0.2.0 → 0.3.0-alpha.1 across all packages
• CI/CD — NuGet caching, explicit solution paths, concurrency, pre-release tag support
• Documentation — Tailwind setup guide now generic for Blazor, versioning strategy updated for alpha workflow
• Release workflow — Tag pattern updated to match v0.3.0-alpha.1-style prereleases

⚠️ Known issues

• Stepper — Active-state highlighting may not always reflect current step; documented, shipping as-is

---

ShellUI v0.2.0 📊 (Historical)

Feature release - Charts & Data Visualization

✨ New Features

Charts & Data Visualization (7 new components)

Built on ApexCharts.Blazor with full ShellUI theme integration:

• Chart - Base chart component with theme-aware styling
• BarChart - Vertical bar charts
• LineChart - Smooth line charts
• AreaChart - Filled area charts
• PieChart - Pie charts with custom tooltips
• MultiSeriesChart - Multiple data series on one chart
• ChartSeries - Flexible series composition

Chart Themes

Three built-in color themes via ChartTheme enum:

• Default - Professional blue-based palette (blue, red, green, yellow, purple)
• Colorful - Vibrant multi-color palette with 7 colors
• Monochrome - Slate grays for minimal aesthetic

Theme-Aware Chart Containers

Charts automatically use your theme's CSS variables:

• var(--radius) for border radius
• var(--shadow) for box shadow
• var(--border), var(--card), var(--card-foreground) for colors

Custom Tooltips

Fully custom HTML tooltips replacing ApexCharts defaults:

• Compact, shadcn-inspired design
• Proper marker/text alignment via flexbox
• Multi-series support (shows all values at a data point)
• Light/dark mode support via CSS variables
• Separate pie chart tooltip using seriesIndex

🐛 Bug Fixes

• Fixed version mismatch - Component versions now correctly read from assembly metadata instead of hardcoded fallback
• Fixed Tailwind version in config - shellui.json now correctly shows Tailwind v4.1.18 for all install methods
• Fixed CS1998 warnings - Removed unnecessary async from synchronous methods in ComponentInstaller

🔧 Improvements

• Tailwind CSS updated to v4.1.18
• Component count: 100 installable (dependencies like *-variants auto-installed)
• X-axis labels - Charts use XAxisType.Category for proper string label display
• Version system - Fallback version now reads AssemblyInformationalVersion baked at build time

📦 Installation

# Install CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add chart components
shellui add chart bar-chart line-chart pie-chart area-chart multi-series-chart

Or via NuGet:

dotnet add package ShellUI.Components

Note: Charts require the Blazor-ApexCharts NuGet package:

dotnet add package Blazor-ApexCharts

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

Full Changelog: v0.1.1...v0.2.0

ShellUI v0.3.0-alpha.1

ShellUI v0.3.0-alpha.1 🚧

First alpha of v0.3.0 — test thoroughly before stable. Report issues via GitHub Issues.

What's in this release

v0.3.0-alpha.1 includes everything from v0.2.0 (charts, Tailwind 4.x) plus new components and improvements.

✨ New Components

Docs essentials:

• Callout / CalloutVariants — Info, warning, tip, danger admonition boxes
• CopyButton — One-click copy to clipboard
• LinkCard — Card-style links for related pages
• PrevNextNav — Previous/Next page navigation for docs

Feedback & Data:

• Sonner / SonnerService / SonnerVariants — Modern toast notifications (shadcn-style)
• Stepper / StepperList / StepperStep / StepperContent — Step-by-step wizard with value-based API
• ChartVariants — Variant styling support for charts

🔧 Improvements

• Version bump — 0.2.0 → 0.3.0-alpha.1 across all packages
• CI/CD — NuGet caching, explicit solution paths, concurrency, pre-release tag support
• Documentation — Tailwind setup guide now generic for Blazor, versioning strategy updated for alpha workflow
• Release workflow — Tag pattern updated to match v0.3.0-alpha.1-style prereleases

⚠️ Known issues

• Stepper — Active-state highlighting may not always reflect current step; documented, shipping as-is

📦 Installation

# Install CLI (alpha)
dotnet tool install -g ShellUI.CLI --version 0.3.0-alpha.1

# Or via NuGet
dotnet add package ShellUI.Components --version 0.3.0-alpha.1

Initialize and add components:

shellui init
shellui add button card chart
shellui add sonner stepper callout copy-button file-upload

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

Full Changelog: v0.2.0...v0.3.0-alpha.1

---

ShellUI v0.2.0 📊 (Historical)

Feature release - Charts & Data Visualization

✨ New Features

Charts & Data Visualization (7 new components)

Built on ApexCharts.Blazor with full ShellUI theme integration:

• Chart - Base chart component with theme-aware styling
• BarChart - Vertical bar charts
• LineChart - Smooth line charts
• AreaChart - Filled area charts
• PieChart - Pie charts with custom tooltips
• MultiSeriesChart - Multiple data series on one chart
• ChartSeries - Flexible series composition

Chart Themes

Three built-in color themes via ChartTheme enum:

• Default - Professional blue-based palette (blue, red, green, yellow, purple)
• Colorful - Vibrant multi-color palette with 7 colors
• Monochrome - Slate grays for minimal aesthetic

Theme-Aware Chart Containers

Charts automatically use your theme's CSS variables:

• var(--radius) for border radius
• var(--shadow) for box shadow
• var(--border), var(--card), var(--card-foreground) for colors

Custom Tooltips

Fully custom HTML tooltips replacing ApexCharts defaults:

• Compact, shadcn-inspired design
• Proper marker/text alignment via flexbox
• Multi-series support (shows all values at a data point)
• Light/dark mode support via CSS variables
• Separate pie chart tooltip using seriesIndex

🐛 Bug Fixes

• Fixed version mismatch - Component versions now correctly read from assembly metadata instead of hardcoded fallback
• Fixed Tailwind version in config - shellui.json now correctly shows Tailwind v4.1.18 for all install methods
• Fixed CS1998 warnings - Removed unnecessary async from synchronous methods in ComponentInstaller

🔧 Improvements

• Tailwind CSS updated to v4.1.18
• Component count: 100 installable (dependencies like *-variants auto-installed)
• X-axis labels - Charts use XAxisType.Category for proper string label display
• Version system - Fallback version now reads AssemblyInformationalVersion baked at build time

📦 Installation

# Install CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add chart components
shellui add chart bar-chart line-chart pie-chart area-chart multi-series-chart

Or via NuGet:

dotnet add package ShellUI.Components

Note: Charts require the Blazor-ApexCharts NuGet package:

dotnet add package Blazor-ApexCharts

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

Full Changelog: v0.1.1...v0.2.0

ShellUI v0.2.0

ShellUI v0.2.0 📊

Feature release - Charts & Data Visualization

✨ New Features

Charts & Data Visualization (7 new components)

Built on ApexCharts.Blazor with full ShellUI theme integration:

• Chart - Base chart component with theme-aware styling
• BarChart - Vertical bar charts
• LineChart - Smooth line charts
• AreaChart - Filled area charts
• PieChart - Pie charts with custom tooltips
• MultiSeriesChart - Multiple data series on one chart
• ChartSeries - Flexible series composition

Chart Themes

Three built-in color themes via ChartTheme enum:

• Default - Professional blue-based palette (blue, red, green, yellow, purple)
• Colorful - Vibrant multi-color palette with 7 colors
• Monochrome - Slate grays for minimal aesthetic

Theme-Aware Chart Containers

Charts automatically use your theme's CSS variables:

• var(--radius) for border radius
• var(--shadow) for box shadow
• var(--border), var(--card), var(--card-foreground) for colors

Custom Tooltips

Fully custom HTML tooltips replacing ApexCharts defaults:

• Compact, shadcn-inspired design
• Proper marker/text alignment via flexbox
• Multi-series support (shows all values at a data point)
• Light/dark mode support via CSS variables
• Separate pie chart tooltip using seriesIndex

🐛 Bug Fixes

• Fixed version mismatch - Component versions now correctly read from assembly metadata instead of hardcoded fallback
• Fixed Tailwind version in config - shellui.json now correctly shows Tailwind v4.1.18 for all install methods
• Fixed CS1998 warnings - Removed unnecessary async from synchronous methods in ComponentInstaller

🔧 Improvements

• Tailwind CSS updated to v4.1.18
• Component count: 80 (73 existing + 7 new chart components)
• X-axis labels - Charts use XAxisType.Category for proper string label display
• Version system - Fallback version now reads AssemblyInformationalVersion baked at build time

📦 Installation

# Install CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add chart components
shellui add chart bar-chart line-chart pie-chart area-chart multi-series-chart

Or via NuGet:

dotnet add package ShellUI.Components

Note: Charts require the Blazor-ApexCharts NuGet package:

dotnet add package Blazor-ApexCharts

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

Full Changelog: v0.1.1...v0.2.0

ShellUI v0.1.1

ShellUI v0.1.1 🔧

Hotfix release - Package publishing fix

🐛 Bug Fixes

Fixed Package Publishing

• Prevented ShellUI.Core from being published separately - Set IsPackable=false on ShellUI.Core project
• Updated release workflow - Now only publishes the 2 intended packages:
  • ✅ ShellUI.CLI - CLI tool for component management
  • ✅ ShellUI.Components - Component library package
• Updated documentation - README now correctly reflects that only 2 packages are published

What Changed

• ShellUI.Core is an internal dependency of ShellUI.Components and should not be published as a standalone package
• Future releases will only publish the 2 intended packages

📦 Installation

No changes to installation process:

# Install CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add components
shellui add button badge alert card

Or via NuGet:

dotnet add package ShellUI.Components

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

---

Full Changelog: v0.1.0...v0.1.1

ShellUI v0.1.0

ShellUI v0.1.0 🎉

Beautiful, accessible Blazor components inspired by shadcn/ui

✨ Highlights

This is the first official release of ShellUI - a CLI-first Blazor component library that brings the shadcn/ui philosophy to .NET developers.

🚀 What's Included

CLI Tool (ShellUI.CLI)

• shellui init - Initialize your Blazor project with Tailwind CSS
• shellui add <component> - Add individual components to your project
• shellui list - List all available components
• shellui remove <component> - Remove installed components
• shellui update - Update components to the latest version

Components Library (ShellUI.Components)

Pre-built components for NuGet installation:

• Button - Interactive button with variants (default, destructive, outline, secondary, ghost, link)
• Badge - Status indicators with multiple variants
• Alert - Notification banners with icons
• Card - Content containers with header, content, and footer sections
• Input - Form input fields
• Label - Accessible form labels
• Separator - Visual dividers
• Shell utilities - Shell.Cn() for Tailwind class merging

📦 Installation

Option 1: CLI (Recommended)

# Install the CLI globally
dotnet tool install -g ShellUI.CLI

# Initialize your project
shellui init

# Add components
shellui add button badge alert card

Option 2: NuGet Package

dotnet add package ShellUI.Components

🎨 Styling

ShellUI uses Tailwind CSS v4 with CSS variables for theming. The shellui init command automatically sets up:

• Tailwind CSS standalone CLI (no Node.js required)
• CSS variables for light/dark themes
• Component styling aligned with shadcn/ui

📋 Requirements

• .NET 9.0 or later
• Blazor Server, WebAssembly, or Interactive modes

🔗 Links

• Documentation: https://shellui.dev
• GitHub: https://github.com/shellui-dev/shellui
• NuGet: https://www.nuget.org/packages/ShellUI.Components

🙏 Acknowledgments

Inspired by shadcn/ui - the beautiful React component library.

---

Full Changelog: https://github.com/shellui-dev/shellui/commits/v0.1.0

v0.0.3 - Fixed v0.0.2 Issues

Version 0.0.3 (Current) - 30 November 2025

🎉 Release v0.0.3 - Fixed v0.0.2 Issues

ShellUI v0.0.3 is now available on NuGet! This release fixes issues from v0.0.2 and includes improved documentation and package metadata.

What's Included

• ✅ CLI Tool (ShellUI.CLI v0.0.3) - Install globally: dotnet tool install -g ShellUI.CLI
• ✅ Components Package (ShellUI.Components v0.0.3) - Install: dotnet add package ShellUI.Components
• ✅ Templates Package (ShellUI.Templates v0.0.3) - Internal dependency for CLI

Features

1. 69 Production-Ready Components

   • Form: Button, Input, Textarea, Select, Checkbox, Switch, RadioGroup, Slider, etc.
   • Layout: Card, Dialog, Sheet, Drawer, Popover, Tooltip, Separator, etc.
   • Navigation: Navbar, Sidebar, NavigationMenu, Menubar, Breadcrumb, Pagination, Tabs
   • Data Display: Table, DataTable, Badge, Avatar, Alert, Toast, Skeleton, Progress, Loading
   • Interactive: Dropdown, Accordion, Toggle, ThemeToggle, Command, ContextMenu, HoverCard
   • Advanced: Carousel, Stepper, EmptyState, FileUpload, Calendar, DatePicker, etc.

2. Hybrid Distribution Model

   • CLI-First: Copy components to your project for full customization
   • NuGet Option: Traditional package install for quick starts
   • Use both together - NuGet for speed, CLI for customization

3. Tailwind CSS v4.1.14

   • Standalone CLI (no Node.js required!)
   • Automatic dark mode support
   • Theme-aware components
   • Customizable design tokens

4. Developer Experience

   • Simple setup: dotnet shellui init
   • Add components: dotnet shellui add button card dialog
   • Full source code ownership
   • Easy customization

ShellUI v0.0.1

First release!

What's Changed

• Added 53 components to shellui by @Shewart in #1
• Fix/cli updates by @Shewart in #2

New Contributors

• @Shewart made their first contribution in #1

Full Changelog: https://github.com/Shelltechlabs/shellui/commits/v0.0.1