> ## 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.

<Note>
  **Payment note from the author:** Stripe doesn't currently support fee transfers between the Netherlands (where AnyStack is based) and Brazil (where the author is based). If you hit a payment issue related to this, email [andreiabohner@gmail.com](mailto:andreiabohner@gmail.com) for an alternative.
</Note>

## Purchase and activate

Filament Cotton Candy Theme uses AnyStack to handle payment, licensing, and distribution.

<Card title="Buy a license" icon="cart-shopping" href="https://checkout.anystack.sh/filament-cotton-candy-theme">
  Purchase Filament Cotton Candy Theme on AnyStack.
</Card>

During checkout, AnyStack provides a license key. Once it's activated, proceed with the Composer installation below.

<Steps>
  <Step title="Add the private repository">
    ```json composer.json theme={null}
    {
        "repositories": [
            {
                "type": "composer",
                "url": "https://filament-cotton-candy-theme.composer.sh"
            }
        ]
    }
    ```
  </Step>

  <Step title="Require the package">
    ```bash theme={null}
    composer require filament-handbook/filament-cotton-candy-theme
    ```

    Composer will prompt for credentials — your **username** is the email you purchased with, your **password** is your license key:

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

  <Step title="Add the theme to your Vite config">
    Add a new item to the `input` array of your `vite.config.js` file:

    ```js theme={null}
    'vendor/filament-handbook/filament-cotton-candy-theme/resources/css/theme.css'
    ```
  </Step>

  <Step title="Build assets">
    ```bash theme={null}
    npm run build
    ```
  </Step>

  <Step title="Register the plugin">
    ```php theme={null}
    use FilamentHandbook\FilamentCottonCandyTheme\FilamentCottonCandyThemePlugin;

    $panel
      ->plugin(FilamentCottonCandyThemePlugin::make())
    ```
  </Step>
</Steps>

You're all set! Next: pick a [color palette](/filament/cotton-candy-theme/color-palettes) — the default is CandyGum.
