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

# Configuration

> Density settings and customizing the primary color palette.

## Density settings

The theme enables Filament's dense schema spacing and compact supported components by default. Both can be disabled independently, per panel.

### Via the plugin

```php theme={null}
use DevDeia\FilamentCappuccinoTheme\CappuccinoThemePlugin;

CappuccinoThemePlugin::make()
    ->dense(false)
    ->compact(false)
```

### Via the config file

Publish the config file to change the defaults for every panel that doesn't override them explicitly:

```bash theme={null}
php artisan vendor:publish --tag=filament-cappuccino-theme-config
```

```php config/filament-cappuccino-theme.php theme={null}
return [
    'dense' => true,
    'compact' => true,

    'mail' => [
        'logo' => env('CAPPUCCINO_MAIL_LOGO'),
        'logo_dark' => env('CAPPUCCINO_MAIL_LOGO_DARK'),
    ],
];
```

<Note>
  Calling `->dense()` or `->compact()` on the plugin always takes priority over the config file.
</Note>

## Primary color palette

Pass any 50–950 color array — hex or OKLCH — to `->primaryColor()` to override the default Cappuccino gold palette:

```php theme={null}
use DevDeia\FilamentCappuccinoTheme\CappuccinoThemePlugin;

CappuccinoThemePlugin::make()
    ->primaryColor([
        50  => '#fdf6e3',
        100 => '#f9e9b0',
        // ...
        600 => '#b5963a',
        // ...
        950 => '#1e1806',
    ]);
```

<Warning>
  Use shade `600` for solid buttons and accents. That's also the shade the mail theme installer bakes into the CSS when you run `cappuccino-theme:install-mail` — see [Markdown Mail Theme](/filament/cappuccino-theme/mail-theme).
</Warning>

### Default gold palette

If you don't call `->primaryColor()`, the plugin falls back to this OKLCH gold palette:

<table>
  <thead>
    <tr><th>Shade</th><th>Preview</th><th>Value</th></tr>
  </thead>

  <tbody>
    <tr><td>50</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.974 0.026 90.1)"}} /></td><td><code>oklch(0.974 0.026 90.1)</code></td></tr>
    <tr><td>100</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.933 0.075 94.3)"}} /></td><td><code>oklch(0.933 0.075 94.3)</code></td></tr>
    <tr><td>200</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.886 0.112 92.9)"}} /></td><td><code>oklch(0.886 0.112 92.9)</code></td></tr>
    <tr><td>300</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.828 0.139 88.2)"}} /></td><td><code>oklch(0.828 0.139 88.2)</code></td></tr>
    <tr><td>400</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.768 0.146 83.3)"}} /></td><td><code>oklch(0.768 0.146 83.3)</code></td></tr>
    <tr><td>500</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.743 0.117 89.5)"}} /></td><td><code>oklch(0.743 0.117 89.5)</code></td></tr>
    <tr><td>600</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.684 0.115 90.2)"}} /></td><td><code>oklch(0.684 0.115 90.2)</code></td></tr>
    <tr><td>700</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.556 0.101 90.1)"}} /></td><td><code>oklch(0.556 0.101 90.1)</code></td></tr>
    <tr><td>800</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.424 0.076 90.4)"}} /></td><td><code>oklch(0.424 0.076 90.4)</code></td></tr>
    <tr><td>900</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.307 0.053 89.6)"}} /></td><td><code>oklch(0.307 0.053 89.6)</code></td></tr>
    <tr><td>950</td><td><span className="inline-block w-5 h-5 rounded-md border border-gray-300 align-middle" style={{background: "oklch(0.211 0.032 91.6)"}} /></td><td><code>oklch(0.211 0.032 91.6)</code></td></tr>
  </tbody>
</table>