Save this content to: .claude/skills/kinetix-saved-views/SKILL.md

# Kinetix Saved Views Development

## When to Apply

Activate this skill when:
- Letting users save and switch between table presets (filters/sort/columns).
- Adding a "Views" dropdown to a Kinetix table toolbar.

## Documentation

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

## Installation & Configuration

```bash
php artisan vendor:publish --tag=kinetix-saved-views-migrations
php artisan migrate
```

```php
'saved_views' => ['enabled' => env('KINETIX_SAVED_VIEWS_ENABLED', false)],
```

Enable per-table with `->saveViews()`:

```php
Table::make(Product::query())
    ->columns([...])
    ->filters([...])
    ->saveViews();              // key defaults to the model class
// or ->saveViews('products.admin') for a custom/shared key
```

Views are per-user and team-scoped automatically when `kinetix.teams` is on.

---

## How it works

`saveViews()` sets `TableData.savedViewsKey`; `KinetixTable` then renders the
`KinetixSavedViews` dropdown in the toolbar. A view captures
`{ search, sort, direction, perPage, filters, columns }`; applying one restores
all of it (column visibility is client-only, the rest via the query string). The
default view loads automatically on first render. No extra wiring needed.

- **Backend**: `SavedViewManager` (`for`/`create`/`update`/`delete`/`makeDefault`),
  `SavedViewController` (team-aware `{prefix}/saved-views`, owner-only).
- **Frontend**: `useKinetixSavedViews(viewKey)` →
  `{ views, loading, load, create, update, remove, setDefault }`. i18n
  `saved_view*` (en/es/fr/pt).

## UUID / ULID Host Models

This feature's migration builds `user_id` and `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".