> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devdeia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Purchase a license, install the package, and register the plugin.

## Purchase and activate

Filament Cappuccino Theme is commercial software. You can buy a license through [AnyStack](https://anystack.sh) or via Stripe directly.

<CardGroup cols={2}>
  <Card title="Buy on AnyStack" icon="cart-shopping" href="https://checkout.anystack.sh/filament-cappuccino-theme">
    Payment, licensing, and distribution handled by AnyStack.
  </Card>

  <Card title="Buy on Stripe" icon="credit-card" href="https://buy.stripe.com/eVq4gB6Rn9Cy6NG0MBdby03">
    Direct checkout via Stripe.
  </Card>
</CardGroup>

During checkout, you'll receive a license key by email. Once it's activated, you can proceed with the Composer installation below.

<Note>
  Run into any issues with purchasing or activation? Email [andreiabohner@gmail.com](mailto:andreiabohner@gmail.com).
</Note>

## Install with Composer

<Steps>
  <Step title="Add the private repository">
    Add the package repository to your project's `composer.json`:

    ```json composer.json theme={null}
    {
        "repositories": [
            {
                "type": "composer",
                "url": "https://filament-cappuccino-theme.composer.sh"
            }
        ]
    }
    ```
  </Step>

  <Step title="Require the package">
    Install it like any other Composer package:

    ```bash theme={null}
    composer require dev-deia/filament-cappuccino-theme
    ```

    Composer will prompt for credentials:

    ```bash theme={null}
    Loading composer repositories with package information
    Authentication required (filament-cappuccino.composer.sh):
    Username: [license-email]
    Password: [license-key]
    ```

    Your **username** is the email you purchased with, and your **password** is your license key. For example:

    ```bash theme={null}
    Contact email: your@email.com
    License key: 04c21df8f-4890-7024-y2vk-6bny143ta642
    ```

    ```bash theme={null}
    Loading composer repositories with package information
    Authentication required (filament-cappuccino.composer.sh):
    Username: your@email.com
    Password: 04c21df8f-4890-7024-y2vk-6bny143ta642
    ```
  </Step>

  <Step title="Publish the assets">
    ```bash theme={null}
    php artisan filament:assets
    ```

    This copies the pre-built stylesheet into your `public/` directory. Re-run it after every `composer update`, or wire it into your Composer post-update hook so it happens automatically.
  </Step>

  <Step title="Register the plugin">
    ```php theme={null}
    use DevDeia\FilamentCappuccinoTheme\CappuccinoThemePlugin;
    use Filament\Panel;

    public function panel(Panel $panel): Panel
    {
        return $panel
            ->plugin(CappuccinoThemePlugin::make());
    }
    ```

    That's it — the panel now uses the Cappuccino theme.
  </Step>
</Steps>