# ShellUI Documentation > CLI-first Blazor component library inspired by shadcn/ui Source: https://shellui.dev/docs/v0.2.1/introduction Welcome to ShellUI v0.2.1, a modern, CLI-first Blazor component library inspired by shadcn/ui. Build beautiful, accessible, and performant web applications with our production-ready component library. > **You are reading the v0.2.1 docs** > > v0.3 is the current stable release. Use the version selector to switch, or read the [v0.3 introduction](https://shellui.dev/docs/v0.3/introduction.md). Code samples on these pages are not rendered live: the previews on this site run the current ShellUI package. ## Getting Started ### Installation Choose your preferred installation method: **CLI Installation (Recommended)** ```bash # Install CLI globally dotnet tool install -g ShellUI.CLI # Initialize in your Blazor project shellui init # Add components shellui add button input card table chart ``` **NuGet Package** ```bash dotnet add package ShellUI.Components ``` ### Quick Example ```razor Welcome to ShellUI Build beautiful Blazor applications

Your content goes here.

``` ## Component Categories Explore our comprehensive component library, organized by category: - [Form Components](https://shellui.dev/docs/v0.2.1/components/form.md): Buttons, inputs, selects, and form controls - [Layout Components](https://shellui.dev/docs/v0.2.1/components/layout.md): Cards, dialogs, sheets, and structural elements - [Navigation Components](https://shellui.dev/docs/v0.2.1/components/navigation.md): Menus, breadcrumbs, tabs, and navigation elements - [Data Display](https://shellui.dev/docs/v0.2.1/components/data-display.md): Tables, badges, avatars, and data presentation - [Interactive Components](https://shellui.dev/docs/v0.2.1/components/interactive.md): Dropdowns, tooltips, and interactive elements - [Advanced Components](https://shellui.dev/docs/v0.2.1/components/advanced.md): Calendars, charts, carousels, and complex UI elements ## What's New in v0.2.1 - **Chart tooltip fix**: Custom tooltip HTML now generates correctly in installed files - **ChartVariants namespace fix**: `ChartVariants` now correctly under `ShellUI.Components.Variants` - **`chart-styles` auto-install**: `shellui add chart` automatically installs `charts.css` to `wwwroot/css/` and injects the `` tag into your App.razor - **wwwroot file support**: CLI now correctly installs files with `wwwroot/` paths relative to project root ### v0.2.0 Highlights - **Charts & Data Visualization**: 7 chart components built on ApexCharts.Blazor - **Chart Themes**: Three built-in themes (Default, Colorful, Monochrome) - **Theme-Aware Charts**: Charts automatically use your theme's CSS variables - **Custom Tooltips**: Compact, shadcn-inspired chart tooltips with dark mode support - **Tailwind CSS v4.1.18**: Updated to latest stable Tailwind release ## Key Features - **CLI-First**: Copy components directly to your codebase for full control - **Hybrid Workflow**: CLI + NuGet packages for maximum flexibility - **Tailwind CSS v4.1.18**: Modern styling with standalone CLI (no Node.js required) - **Production-Ready Components**: Comprehensive component library - **Type-Safe Variants**: CVA patterns with full C# type safety - **Accessible**: WCAG 2.1 AA compliant by default - **Performance Optimized**: Built for both Server and WASM scenarios - **Customizable**: Easy theme customization with CSS variables ## Architecture ShellUI offers a unique hybrid approach: - **Copy Components**: Like shadcn/ui, components are copied to your project - **NuGet Option**: Traditional package installation for quick starts - **Tailwind Integration**: Standalone CLI or npm setup options - **Build Integration**: Automatic CSS compilation on project build ## Theming Customize your theme instantly with [tweakcn](https://tweakcn.com) or modify CSS variables: ```css :root { --background: oklch(0.9900 0 0); --foreground: oklch(0 0 0); --primary: oklch(0 0 0); --primary-foreground: oklch(1 0 0); --secondary: oklch(0.9400 0 0); --secondary-foreground: oklch(0 0 0); /* ... more variables */ } ``` ## Learn More - [GitHub Repository](https://github.com/shellui-dev/shellui) - [Installation Guide](https://shellui.dev/docs/v0.2.1/installation.md) - [Component API](https://shellui.dev/docs/v0.2.1/components.md) - [Theming Guide](https://shellui.dev/docs/v0.2.1/theming.md) - [Contributing](https://shellui.dev/docs/v0.2.1/contributing.md)