Markdown Mail Theme - DevDeia Docs

App emails can share the panel’s look and feel. The installer publishes Laravel’s markdown mail components (layout, header, button, panel, table, footer) plus a Cappuccino CSS theme.

Install

php artisan cappuccino-theme:install-mail

Files land in resources/views/vendor/mail/. The installer reads shade 600 from the plugin’s primary palette — from primaryColor() if you’ve set one, otherwise the default gold.

Command options

string

Filament panel ID to read the primary color from. Required when more than one Cappuccino-themed panel exists in the app.

string

A hex color to bake into the CSS directly, skipping panel detection entirely. For example: --primary=#b5963a.

boolean

Overwrite mail views that were published earlier.

# Multiple Cappuccino panels? Pick one explicitly
php artisan cappuccino-theme:install-mail --panel=admin

# Or skip panel detection with an explicit color
php artisan cappuccino-theme:install-mail --primary=#b5963a

The color is written into the CSS at install time. Re-run the command after changing the panel’s primary color.

Apply the theme

Set it globally in config/mail.php:

config/mail.php

'markdown' => [
    'theme' => 'cappuccino',
    // ...
],

Or per mailable:

return $this->markdown('mail.welcome')->theme('cappuccino');

Branding

Default logos come from environment variables:

.env

CAPPUCCINO_MAIL_LOGO=https://example.com/logo.png
CAPPUCCINO_MAIL_LOGO_DARK=https://example.com/logo-dark.png

For tenant-specific branding, pass the same keys as view data on the mailable. They’re stored with the queued job, so queued mail keeps the correct brand:

return new Content(
    markdown: 'mail.welcome',
    with: [
        'logo' => $this->tenant->logo_url,
        'logoDark' => $this->tenant->logo_dark_url,
        'brand' => $this->tenant->name,
        'brandUrl' => $this->tenant->url,
    ],
);

When set, brand replaces config('app.name') in the header label, footer copyright, document title, and logo alt text. brandUrl replaces config('app.url') as the header link.

Clients and dark mode

Apple Mail, iOS Mail, and Outlook.com respect prefers-color-scheme and can show the dark variant — including CAPPUCCINO_MAIL_LOGO_DARK, when provided.

Gmail and Outlook desktop often recolor messages on their own. The light layout — cream outer background, white content card — is the reliable baseline for those clients.

​Install

​Command options

​Apply the theme

​Branding

​Clients and dark mode

Install

Command options

Apply the theme

Branding

Clients and dark mode