Save this content to: .claude/skills/kinetix-mail-templates/SKILL.md

# Kinetix Mail Templates

## When to Apply

Activate this skill when:
- Building editable/configurable email templates (admins edit copy without code).
- Rendering or sending templated emails with variable placeholders.

## Documentation

For full details, reference `docs/mail-templates.md` (published at https://happones.github.io/kinetix/mail-templates).

## Installation

```bash
php artisan vendor:publish --tag=kinetix-mail-templates-migrations
php artisan migrate
```

```php
'mail_templates' => ['enabled' => env('KINETIX_MAIL_TEMPLATES_ENABLED', false)],
Gate::define('viewKinetixMail', fn ($user) => $user->isAdmin()); // prod
```

## Manager

```vue
<KinetixMailTemplates />
```

List + editor (subject + Markdown/HTML body with `{{ variable }}`), live preview
with sample values, and send-test. Gated by `viewKinetixMail`.

## Sending from your app

```php
use Happones\Kinetix\Mail\KinetixMail;

KinetixMail::send($user->email, 'welcome', ['name' => $user->name]);
KinetixMail::render('welcome', [...]); // {subject, html} without sending
KinetixMail::sendFor($order->team_id, $to, 'receipt', [...]); // jobs, console
KinetixMail::mailableFor($team, 'digest', [...]); // a Mailable, e.g. for toMail()
```

`send()` returns false if the template is missing/disabled. It reads the team
from the request: outside one (a queued job, a console command) use
`sendFor($team, ...)`, or the global default goes out instead of the team's
override. Variable values are
HTML-escaped in Markdown bodies; HTML templates render as-is; the subject is
plain text.

> i18n note: never put literal `{{ }}` or `@` in vue-i18n translation strings —
> both are reserved (nested placeholder / linked message) and crash compilation.

## UUID / ULID Host Models

This feature's migration builds `team_id` with
`Happones\Kinetix\Support\HostKeys`, which types each column after YOUR model
at migrate time from its primary key (`HasUlids` -> ulid, `HasUuids` -> uuid, string `$keyType` ->
string, else bigint). Pin `kinetix.key_types.user|team` when detection cannot
see the setup; morph ids follow `kinetix.key_types.morph` (default bigint) —
set it when the referenced models use UUIDs/ULIDs. Apps migrated on an older
Kinetix have bigint columns on disk and need their own ALTER migration. Full
recipe: the `kinetix-boost` skill, section "UUID / ULID Host Models".