К основному содержанию
скилл CX Codex

shadcn-vue-inertia — скилл для Claude Code: функции и установка

Скилл shadcn-vue-inertia обучает агента адаптировать shadcn-vue под Vue 3 и Inertia Rails без Nuxt. Помогает при вёрстке форм, таблиц, диалогов и системных тостов.

MIT 122 установок ★ 72 обновлён 2026-09-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add inertia-rails/skills --skill shadcn-vue-inertia -a claude-code
Открыть на GitHub

Что делает shadcn-vue-inertia

Официальные примеры shadcn-vue ориентированы на экосистему Nuxt и библиотеку vee-validate. Этот скилл задаёт правила интеграции компонентов в стек Inertia Rails. Агент заменяет useRouter, useFetch и <NuxtLink> на инструменты @inertiajs/vue3, избавляя от лишних пакетов и ошибок типизации.

Компоненты FormField, FormItem и FormMessage падают без контекста vee-validate. Скилл принуждает использовать стандартные Input, Label и Select с атрибутом name внутри Inertia <Form>, считывая ошибки из слота #default. Директива v-model здесь не работает: форма читает нативные имена полей при отправке запроса.

Плагин vite-plugin-ruby уже настраивает псевдоним @/, поэтому прописывать его в vite.config.ts нельзя — алиас добавляют только в tsconfig.json. Для переключения темной темы скилл встраивает проверку в заголовок страницы во избежание мерцания стилей.

Какие задачи решает

  • переписать формы shadcn-vue с vee-validate на Inertia Form
  • настроить тёмную тему без Nuxt color-mode и вспышек FOUC
  • реализовать серверную сортировку строк в таблицах shadcn-vue
  • подключить уведомления Sonner к flash-сообщениям Rails

Примеры запросов агенту

  • Собери форму создания пользователя на компонентах shadcn-vue внутри Inertia Form
  • Сделай диалоговое окно shadcn-vue с синхронизацией состояния через router.replaceProp
  • Настрой переключение темы через класс dark на теге html без плагинов Nuxt

Как установить shadcn-vue-inertia

1Через Skills CLI (Vercel)

npx skills add inertia-rails/skills --skill shadcn-vue-inertia -a claude-code

2Вручную: положить файлы

~/.claude/skills/shadcn-vue-inertia/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/shadcn-vue-inertia/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о shadcn-vue-inertia

Как установить shadcn-vue-inertia в Claude Code?

Выполните команду npx skills add inertia-rails/skills --skill shadcn-vue-inertia -a claude-code.

Зачем нужен shadcn-vue-inertia?

Он переводит примеры shadcn-vue с архитектуры Nuxt на соглашения Inertia Rails, сохраняя нативную валидацию и серверные пропсы.

Почему нельзя использовать shadcn FormField в Inertia?

Эти компоненты завязаны на контекст vee-validate и ломают приложение без него. В Inertia поля связывают через атрибут name и объект errors.

Исходный текст

SKILL.md · MIT
---
name: shadcn-vue-inertia
description: >-
  shadcn-vue component integration for Inertia Rails Vue 3 (NOT Nuxt): forms, dialogs, tables, toasts, dark mode,
  and more. Use when building UI with shadcn-vue components in an Inertia + Vue app or adapting shadcn-vue
  examples from Nuxt. Wire shadcn-vue inputs to Inertia Form via name attribute and #default scoped slot.
  Flash toasts require Rails flash_keys initializer config.
---

# shadcn-vue for Inertia Rails

shadcn-vue patterns adapted for Inertia.js + Rails + Vue 3. NOT Nuxt.

**Before using a shadcn-vue example, ask:**
- **Does it use Nuxt-specific APIs?** (`useRouter`, `useFetch`, `<NuxtLink>`) → Replace with Inertia `router`, server props, `<Link>`
- **Does it use `vee-validate` + `zod`?** → Replace with Inertia `<Form>` + `name` attributes. Inertia handles CSRF, errors, redirects, processing state.

## Key Differences from Nuxt Defaults

| shadcn-vue default (Nuxt) | Inertia equivalent |
|---|---|
| `useFetch` / `useAsyncData` | Server-rendered props via controller |
| `useRouter()` (Nuxt) | `router` from `@inertiajs/vue3` |
| `<NuxtLink>` | `<Link>` from `@inertiajs/vue3` |
| `vee-validate` + `zod` | Inertia `<Form>` component |
| `FormField`, `FormItem`, `FormMessage` | Plain `<Input name="...">` + `errors.field` |
| `useHead()` (Nuxt) | `<Head>` from `@inertiajs/vue3` |

**NEVER use shadcn-vue's `FormField`, `FormItem`, `FormLabel`, `FormMessage` components** —
they depend on vee-validate's form context internally and will crash without it.
Use plain shadcn-vue `Input`/`Label`/`Select` with `name` attributes inside Inertia `<Form>`,
and render errors from the scoped slot's `errors` object.

## Setup

`npx shadcn-vue@latest init`. Add `@/` resolve aliases to `tsconfig.json` if not present.
**Do NOT add `@/` resolve aliases to `vite.config.ts`** — `vite-plugin-ruby` already provides them.

## shadcn-vue Inputs in Inertia `<Form>`

Use plain shadcn-vue `Input`/`Label`/`Button` with `name` attributes inside Inertia `<Form>`.
See `inertia-rails-forms` skill (+ `references/vue.md`) for full `<Form>` API.

**The key pattern:** Replace shadcn-vue's `FormField`/`FormItem`/`FormMessage` with plain
components + manual error display:

```vue
<script setup lang="ts">
import { Form } from '@inertiajs/vue3'
import { Input } from '@/components/ui/input'
import { Label } from '@/components/ui/label'
import { Button } from '@/components/ui/button'
</script>

<template>
  <Form method="post" action="/users">
    <template #default="{ errors, processing }">
      <div class="space-y-4">
        <div>
          <Label for="name">Name</Label>
          <Input id="name" name="name" />
          <p v-if="errors.name" class="text-sm text-destructive">{{ errors.name }}</p>
        </div>

        <div>
          <Label for="email">Email</Label>
          <Input id="email" name="email" type="email" />
          <p v-if="errors.email" class="text-sm text-destructive">{{ errors.email }}</p>
        </div>

        <Button type="submit" :disabled="processing">
          {{ processing ? 'Creating...' : 'Create User' }}
        </Button>
      </div>
    </template>
  </Form>
</template>
```

**`<Select>` requires `name` prop** for Inertia `<Form>` integration:

```vue
<template>
  <Select name="role" default-value="member">
    <SelectTrigger><SelectValue placeholder="Select role" /></SelectTrigger>
    <SelectContent>
      <SelectItem value="admin">Admin</SelectItem>
      <SelectItem value="member">Member</SelectItem>
    </SelectContent>
  </Select>
</template>
```

## Dialog with Inertia Navigation

```vue
<script setup lang="ts">
import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog'
import { router } from '@inertiajs/vue3'

defineProps<{ open: boolean; user: User }>()
</script>

<template>
  <Dialog
    :open="open"
    @update:open="(isOpen) => { if (!isOpen) router.replaceProp('show_dialog', false) }"
  >
    <DialogContent>
      <DialogHeader>
        <DialogTitle>{{ user.name }}</DialogTitle>
      </DialogHeader>
      <!-- content -->
    </DialogContent>
  </Dialog>
</template>
```

## Table with Server-Side Sorting

```vue
<script setup lang="ts">
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
import { router } from '@inertiajs/vue3'

defineProps<{ users: User[]; sort: string }>()

const handleSort = (column: string) => {
  router.get('/users', { sort: column }, { preserveState: true })
}
</script>

<template>
  <Table>
    <TableHeader>
      <TableRow>
        <TableHead class="cursor-pointer" @click="handleSort('name')">
          Name {{ sort === 'name' ? '↑' : '' }}
        </TableHead>
        <TableHead>Email</TableHead>
      </TableRow>
    </TableHeader>
    <TableBody>
      <TableRow v-for="user in users" :key="user.id">
        <TableCell>{{ user.name }}</TableCell>
        <TableCell>{{ user.email }}</TableCell>
      </TableRow>
    </TableBody>
  </Table>
</template>
```

Use `<Link>` (not `<a>`) for row links to preserve SPA navigation.

## Toast with Flash Messages

Flash config (`flash_keys`) is in `inertia-rails-controllers`. Flash access
(`usePage().flash`) is in `inertia-rails-pages`. This section covers **toast UI wiring only**.

**MANDATORY — READ ENTIRE FILE** when implementing flash-based toasts with Sonner:
[`references/flash-toast.md`](references/flash-toast.md) (~80 lines) — full `useFlash`
composable and Sonner toast provider. **Do NOT load** if only reading flash values without toast UI.

## Dark Mode (No Nuxt color-mode)

`npx shadcn-vue@latest init` generates CSS variables for light/dark and
`@custom-variant dark (&:is(.dark *));` in your CSS (Tailwind v4). No extra
setup needed for the variables themselves.

**CRITICAL — prevent flash of wrong theme (FOUC):** Add an inline script in
`<head>` (before Vue hydrates):

```erb
<%# app/views/layouts/application.html.erb — in <head>, before any stylesheets %>
<script>
  document.documentElement.classList.toggle(
    "dark",
    localStorage.appearance === "dark" ||
      (!("appearance" in localStorage) && window.matchMedia("(prefers-color-scheme: dark)").matches),
  );
</script>
```

Use a `useAppearance` composable (light/dark/system modes, localStorage persistence,
`matchMedia` listener) instead of Nuxt color-mode. Toggle via `.dark` class on
`<html>` — no provider needed.

## Vue-Specific Gotchas

**`v-model` does NOT work with Inertia `<Form>`** — `<Form>` reads values from
input `name` attributes on submit, not from Vue's reactivity system. Using
`v-model` creates a second source of truth that `<Form>` ignores:

```vue
<!-- BAD — v-model value is ignored by <Form> on submit -->
<Form method="post" action="/users">
  <Input v-model="name" />
</Form>

<!-- GOOD — name attribute is what <Form> reads -->
<Form method="post" action="/users">
  <Input name="name" />
</Form>
```

Use `v-model` only with `useForm` (where you explicitly manage `form.name`).

**`usePage()` returns a reactive object — use `computed()` for derived values:**

```vue
<script setup lang="ts">
import { usePage } from '@inertiajs/vue3'
import { computed } from 'vue'

const page = usePage()

// BAD — not reactive, won't update when page changes:
// const user = page.props.auth.user

// GOOD — reactive, updates on navigation:
const user = computed(() => page.props.auth.user)
</script>
```

Without `computed()`, destructured values freeze at their initial state and
won't update after Inertia navigation.

**`@update:open` vs `@close` for Dialog** — shadcn-vue Dialog emits
`update:open`, not `close`. Using `@close` silently does nothing:

```vue
<!-- BAD — @close is not emitted by shadcn-vue Dialog -->
<Dialog @close="handleClose">

<!-- GOOD — @update:open fires on open AND close -->
<Dialog :open="open" @update:open="(isOpen) => { if (!isOpen) handleClose() }">
```

## Troubleshooting

| Symptom | Cause | Fix |
|---------|-------|-----|
| `FormField`/`FormMessage` crash | Using shadcn-vue form components that depend on vee-validate | Replace with plain `Input`/`Label` + `errors.field` display |
| `Select` value not submitted | Missing `name` prop | Add `name="field"` to `<Select>` |
| Dialog closes unexpectedly | Missing or wrong `@update:open` handler | Use `@update:open="(open) => { if (!open) closeHandler() }"` |
| Flash of wrong theme (FOUC) | Missing inline `<script>` in `<head>` | Add dark mode script before stylesheets |
| `v-model` value not submitted | `<Form>` reads `name` attrs, not Vue reactive state | Use `name` attribute; reserve `v-model` for `useForm` only |
| Shared props stale after navigation | Destructured `usePage()` without `computed()` | Wrap derived values in `computed(() => ...)` |

## Related Skills
- **Form component** → `inertia-rails-forms` + `references/vue.md` (`<Form>` scoped slot, useForm)
- **Flash config** → `inertia-rails-controllers` (flash_keys initializer)
- **Flash access** → `inertia-rails-pages` + `references/vue.md` (usePage().flash)
- **URL-driven dialogs** → `inertia-rails-pages` + `references/vue.md` (router.get pattern)

## References

Load [`references/components.md`](references/components.md) (~200 lines) when building
shadcn-vue components beyond those shown above (Accordion, Sheet, Tabs, DropdownMenu,
AlertDialog with Inertia patterns).

**Do NOT load** `components.md` for basic Form, Select, Dialog, or Table usage —
the examples above are sufficient.

© inertia-rails · MIT · inertia-rails/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
shadcn-vue unovue Помогает добавлять, настраивать и стилизовать компоненты shadcn-vue в проекте по официальным правилам композиции. CX Codex +1 6 300установок shadcn-vue-skilld skilld-dev Скилл shadcn-vue-skilld для Claude Code, Codex, Cursor и других агентов, покрывающий CLI shadcn-vue 2.8.2 для Vue и Nuxt. Знает точные флаги всех команд — от init до mcp, конфигурацию components.json и правила разрешения имён компонентов. CX Codex +1 174установок nuxtjs-vue-typescript Mindrally Скилл nuxtjs-vue-typescript для Claude Code задаёт правила разработки приложений на Nuxt 3 и Vue 3 с TypeScript и Tailwind CSS: архитектуру компонентов, типизацию и шаблоны выборки данных. CX Codex +1 880установок vue-typescript Mindrally Скилл vue-typescript для Claude Code задаёт правила генерации кода на Vue 3 и TypeScript с Vite, Pinia и Tailwind, включая синтаксис и оптимизацию загрузки. CX Codex +1 832установок vue-3-nuxt-3-typescript-cursorrules-prompt-file PatrickJS Правило vue-3-nuxt-3-typescript-cursorrules-prompt-file для Cursor задаёт стиль кода на Vue 3 и Nuxt 3: Composition API, TypeScript-интерфейсы, конвенции Nuxt. Помогает агенту писать код, согласованный с архитектурой проекта. CX Codex +1 ★ 41 178звёзд репо nuxtjs-vue-typescript-development-rules qdleader Правило nuxtjs-vue-typescript-development-rules задаёт стандарты фронтенд-разработки на Nuxt 3, Vue 3 и TypeScript: от структуры папок и компонентов с Tailwind до типизации без enum. CX Codex +1 ★ 571звёзд репо

Из того же набора10

Весь набор →
inertia-rails-pages Скилл inertia-rails-pages для работы со страницами Inertia Rails: постоянные лейауты, навигация через Link и router, состояние из URL, отложенная загрузка и бесконечный скролл. CX Codex +1 518установок inertia-rails-controllers Скилл inertia-rails-controllers для AI-кодинга в Claude Code, Cursor и других редакторах. CX Codex +1 505установок inertia-rails-forms Скилл inertia-rails-forms для Claude Code помогает работать с формами в Inertia.js + Rails: создавать, редактировать и удалять их, собирать многошаговые мастера и загружать файлы с отслеживанием ошибок и прогресса. CX Codex +1 500установок inertia-rails-typescript Скилл inertia-rails-typescript настраивает строгую типизацию TypeScript в Inertia Rails для React, Vue и Svelte. Помогает исправить ошибки TS2344 и TS2339. CX Codex +1 482установок inertia-rails-testing Скилл inertia-rails-testing для тестов Inertia Rails на RSpec и Minitest: проверка компонента, пропсов и flash без ручного разбора JSON. CX Codex +1 479установок shadcn-inertia Скилл shadcn-inertia адаптирует компоненты shadcn/ui для связки Inertia.js, Ruby on Rails и React вместо Next.js. Помогает переписать формы и диалоги без react-hook-form. CX Codex +1 441установок inertia-rails-setup Скилл inertia-rails-setup анализирует стек Inertia Rails в проекте, подбирает недостающие библиотеки и генерирует блок конфигурации в CLAUDE.md. Помогает при первом старте или смене инструментов. CX Codex +1 432установок alba-inertia Скилл alba-inertia настраивает сериализацию в Inertia Rails через Alba и Typelizer. Генерирует типы TypeScript и заменяет as_json на типизированные ресурсы. CX Codex +1 388установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой