# Installation > Install ShellUI via CLI or NuGet package Source: https://shellui.dev/docs/v0.3/installation ShellUI 0.3 offers a **hybrid workflow** with two installation methods. Choose the approach that fits your project. > **Installing 0.3** > > The current stable release is 0.4.0, which the [v0.4 docs](https://shellui.dev/docs/v0.4/installation.md) cover. To install 0.3, name the version: `--version 0.3.6`, as in the commands on these pages. ## Prerequisites - **.NET 10 SDK** to run the CLI; your Blazor project can target **.NET 8, 9 or 10** with the CLI, or **.NET 10** with the NuGet package - **Node.js** (optional — only needed if using npm for Tailwind) - A **Blazor project** (Server, WebAssembly, Hybrid, or Interactive Server) --- ## Installation Methods - [CLI Installation (Recommended)](https://shellui.dev/docs/v0.3/installation/cli.md): Copy components directly into your project for full ownership and customization. Automatic Tailwind setup, MSBuild integration, and component management. - [NuGet Package](https://shellui.dev/docs/v0.3/installation/nuget.md): Traditional package install for quick prototyping. Pre-compiled components with manual Tailwind CSS setup. --- ## CLI vs NuGet — Which to Choose? | Aspect | CLI Tool | NuGet Package | |--------|----------|---------------| | **Install command** | `shellui add button card` | `dotnet add package ShellUI.Components --version 0.3.6` | | **Components** | Source copied to your project | Pre-compiled, referenced as package | | **Customization** | Full source code access — edit anything | Override via CSS, limited code changes | | **Tailwind setup** | Automatic via `shellui init` | Manual setup required | | **Bundle size** | Only components you add | All components included | | **Updates** | Re-run `shellui add` per component | Bump package version | | **Best for** | Production apps, full customization | Prototyping, quick starts | > **Tip:** You can use both approaches together. Use NuGet for standard components and CLI for ones you need to customize. --- ## Quick Start The fastest way to get started with ShellUI: ```bash # 1. Install the CLI tool dotnet tool install -g ShellUI.CLI --version 0.3.6 # 2. Initialize in your Blazor project cd your-blazor-project shellui init # 3. Add components shellui add button input card dialog # 4. Run your app dotnet run ``` That's it — `shellui init` handles Tailwind CSS setup, Bootstrap cleanup, folder creation, and MSBuild integration automatically. [View full CLI guide](https://shellui.dev/docs/v0.3/installation/cli.md) | [View full NuGet guide](https://shellui.dev/docs/v0.3/installation/nuget.md) --- ## Project Types ShellUI works with all Blazor hosting models: **Blazor Server** ```bash dotnet new blazorserver -n MyApp cd MyApp shellui init shellui add button card input dotnet run ``` **Blazor WebAssembly** ```bash dotnet new blazorwasm -n MyApp cd MyApp shellui init shellui add button card input dotnet run ``` **Blazor Hybrid** Works with MAUI, WPF, and WinForms Blazor Hybrid apps. ```bash dotnet new maui-blazor -n MyApp cd MyApp shellui init shellui add button card input dotnet run ``` **Interactive Server** Supports Blazor's Interactive Server rendering mode. ```bash dotnet new blazor -n MyApp cd MyApp shellui init shellui add button card input dotnet run ``` --- ## Verification After installation, verify everything is working: 1. **Build** your project: `dotnet build` 2. **Check** that `wwwroot/app.css` was generated 3. **Run** the project: `dotnet run` ### Quick Test ```razor @page "/test" @using YourProject.Components.UI
``` If the buttons render with proper styling, your installation is successful. --- ## Getting Help - [GitHub Issues](https://github.com/shellui-dev/shellui/issues) — Report bugs or request features - [Documentation](https://shellui.dev/docs/v0.3/introduction.md) — Full ShellUI docs - [Community Discussions](https://github.com/shellui-dev/shellui/discussions) — Ask questions