# CLI Installation > Install ShellUI via the CLI tool for full component ownership and automatic Tailwind setup Source: https://shellui.dev/docs/v0.4/installation/cli The ShellUI CLI copies component source files directly into your project, giving you **full ownership and customization control**. It also handles Tailwind CSS setup, Bootstrap cleanup, folder creation, and MSBuild integration automatically. The CLI runs on .NET 8 or later and sets up Blazor projects on .NET 8, 9 and 10. (The 0.3 line and the 0.4 prereleases needed the .NET 10 runtime.) ## Install the CLI Tool **Global Install** ### Global Installation Global installation makes the `shellui` command available system-wide. **Best for individual developers, quick prototyping, and personal projects.** ```bash # Install globally dotnet tool install -g ShellUI.CLI ``` After installation, use the CLI without the `dotnet` prefix: ```bash shellui init shellui add button input card shellui list ``` **Local Install (Teams)** ### Local Tool Installation Local installation locks the CLI version per-project and shares it via source control. **Best for teams, CI/CD pipelines, and enterprise projects.** ```bash # Step 1: Create a tool manifest (one-time, in project root) dotnet new tool-manifest # Step 2: Install as a local tool dotnet tool install ShellUI.CLI ``` This creates a `.config/dotnet-tools.json` file — commit it to source control: ```json { "version": 1, "isRoot": true, "tools": { "shellui.cli": { "version": "0.4.0", "commands": ["shellui"] } } } ``` Local tools require the `dotnet` prefix: ```bash dotnet shellui init dotnet shellui add button input card dotnet shellui list ``` > **Team onboarding:** New team members just run `dotnet tool restore` to get the exact same CLI version. ### Global vs Local — When to Use Which | Aspect | Global (`-g`) | Local (manifest) | |--------|--------------|------------------| | **Command** | `shellui init` | `dotnet shellui init` | | **Install location** | User profile | Project directory | | **Sharing** | Each dev installs separately | Auto-restored via manifest | | **Version lock** | Latest (unless pinned) | Locked in manifest file | | **CI/CD** | Requires explicit install step | `dotnet tool restore` | | **Best for** | Individual developers | Teams & CI/CD | --- ## Initialize Your Project Navigate to your Blazor project directory and run init: **Global** ```bash cd your-blazor-project shellui init ``` **Local** ```bash cd your-blazor-project dotnet shellui init ``` The init command will: 1. **Detect** your Blazor project type (Server, WASM, Hybrid, etc.) 2. **Clean up** the template's Bootstrap files and restyle its sample pages (Home, Counter, Weather, Error, NotFound) with Tailwind, when you haven't edited them 3. **Set up Tailwind CSS**: choose between standalone CLI (no Node.js) or npm 4. **Download** the Tailwind CSS v4.3.2 standalone CLI once per machine into `~/.shellui/bin` (if selected). Later projects reuse it, even offline 5. **Create** component folders, config files, and CSS entry point 6. **Configure** MSBuild integration for automatic Tailwind compilation 7. **Offer a dashboard layout**: sticky header (`dashboard-02`), scrolling header (`dashboard-01`), or none. See the [dashboard guide](https://shellui.dev/docs/v0.4/dashboard.md) Choose your Tailwind CSS setup method when prompted: - **Standalone CLI** (recommended): No Node.js required, uses Tailwind v4.3.2 - **npm**: Traditional setup with Node.js, uses tailwindcss@^4.3.2 In an app created with `--auth Individual`, `init` also keeps the `/Account` pages working. See [Authentication](https://shellui.dev/docs/v0.4/authentication.md). ### Options | Option | What it does | |--------|--------------| | `--yes` | No prompts. Uses standalone Tailwind and adds no dashboard unless the options below say otherwise | | `--tailwind ` | `standalone` or `npm`. Picks the Tailwind setup and skips that prompt | | `--dashboard ` | `01`, `02` or `none`. Sets up a dashboard layout, or skips it, without asking | | `--replace-layout` | Lets the dashboard replace a layout you have customized | | `--style