---
title: "Vue Kit Components (shadcn-vue)"
description: "Common form components, the confirm dialog, shadcn-vue primitives, icons, toasts and app shell components in the Vue kit, with a small usage example."
---
# Components
## Overview
You'll find the components in `resources/js/components`, split into these folders:
| Folder | What it holds |
| --- | --- |
| `components/common/` | The kit's own form kit: `Common*` inputs, buttons, tooltip, icon and `ConfirmDialog` |
| `components/ui/` | shadcn-vue primitives built on reka-ui |
| `components/` | App shell and feature components (`AppSidebar`, `AppHeader`, `UserMenuContent`, …) |
When you build a page, reach for the `Common*` components first. They take care of the label, the `id`, the `aria-*` attributes and the error message, so most fields fit on one line.
If a component is only used by one page, keep it in a `Partials/` folder next to that page (for example `pages/tenants/Partials/DomainModal.vue`) rather than in `components/`.
## Common form components
| Component | Purpose |
| --- | --- |
| `CommonInput` | Text-like input (`type` defaults to `text`) |
| `CommonPassword` | Password input with a show/hide toggle. Exposes `focus()` via a template ref |
| `CommonTextarea` | Textarea with `rows` (default `3`) and `maxlength` |
| `CommonSelect` | shadcn-vue `Select` with a label. Takes `options: SelectOption[]` and exports the `SelectOption` type |
| `CommonRadio` | reka-ui radio group. Takes `options: SelectOption[]` |
| `CommonCheckbox` | Checkbox with a boolean `v-model` and optional `value` |
| `CommonLabel` | Label with `required` (asterisk), `optional` (translated tag) and `hint` |
| `CommonError` | Renders `message` in a `role="alert"` paragraph, nothing when empty |
| `CommonButton` | Button with a `loading` state (disabled + spinner) |
| `CommonButtonRow` | Save / Discard bar for settings forms, shown when the form is dirty |
| `CommonTooltip` | Wraps its slot in a tooltip (`content`, `side`) |
| `ConfirmDialog` | Global confirm dialog, opened with `useConfirmDialog()` |
The input components behave the same way. They share the props `name`, `id`, `label`, `error`, `required` and `disabled`, and if you leave out the `id`, one is generated for you. Any other attribute you add (`autofocus`, `class`, `data-test`, …) is passed through to the underlying element.
Inside an Inertia `
```
### Confirm dialog
The app layouts mount `ConfirmDialog` once. From any page you call `confirm()`, which returns a `Promise`.
```ts
const { confirm } = useConfirmDialog();
if (await confirm({ title, message, confirmVariant: 'destructive' })) {
router.delete(destroy.url(user.id), { preserveScroll: true });
}
```
You can also pass any of these: `warning`, `itemDetails`, `confirmText`, `icon` (`danger`, `warning`, `info`, `question`, `success`), `size` (`sm` to `xl`), `warningVariant`, `highlight`, `confirmationKeyword` (the user has to type it before the button enables), `closeOnBackdrop`, `closeOnEscape` and `showCancelButton`. To put a spinner on the confirm button, call `setLoading(true)`.
::: warning
Only `AppSidebarLayout` and `AppHeaderLayout` mount `ConfirmDialog`. On pages that use `AuthLayout`, or no layout at all, `confirm()` won't work.
:::
::: details View full example (delete user)
```ts
import { useConfirmDialog } from '@/composables/useConfirmDialog';
const { confirm } = useConfirmDialog();
const isConfirmed = await confirm({
title: __('modules.user.index.delete_confirm.title'),
message: __('modules.user.index.delete_confirm.message', { name: user.name }),
warning: __('modules.user.index.delete_confirm.warning'),
itemDetails: [{ label: __('modules.user.index.delete_confirm.email'), value: user.email, code: true }],
confirmText: __('modules.user.index.delete_confirm.confirm'),
confirmVariant: 'destructive',
});
if (isConfirmed) {
router.delete(destroy.url(user.id), { preserveScroll: true });
}
```
:::
## UI primitives (shadcn)
The shadcn-vue components are in `components/ui//`, using the new-york-v4 style set in `components.json`. Every folder has an `index.ts`. These are included:
`alert`, `avatar`, `badge`, `breadcrumb`, `button`, `card`, `checkbox`, `collapsible`, `dialog`, `dropdown-menu`, `input`, `input-otp`, `label`, `navigation-menu`, `select`, `separator`, `sheet`, `sidebar`, `skeleton`, `sonner`, `spinner`, `tooltip`.
```ts
import { Badge } from '@/components/ui/badge';
import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog';
```
Use them as they are for layout and display, like cards, badges and dialogs. For form fields, the `Common*` wrappers are the better choice.
## Icons & toasts
| Need | Use |
| --- | --- |
| Icon in a template | `@lucide/vue` components, e.g. `import { Plus } from '@lucide/vue'` |
| Icon stored as a string (menus in the database) | `CommonIcon` (Iconify) |
| Toast from the server | `Inertia::flash('toast', …)`, see [Inertia → Flash toasts](/docs/vue/inertia#flash-toasts) |
| Toast from the client | `import { toast } from 'vue-sonner'` |
`CommonIcon` accepts `icon`, `class` and `click`. A PascalCase name is turned into a Lucide icon (`LayoutGrid` → `lucide:layout-grid`), and a name that already has a prefix is used unchanged.
```vue
```
::: warning
The `Toaster` lives in `AppSidebarLayout` and `AppHeaderLayout` only, so you won't see toasts on auth pages or on pages without a layout.
:::
## Usage example
Here's a typical field, an action button with a tooltip, and a submit button:
```vue
{{ __('modules.auth.login.submit') }}
```
::: details View more examples
```vue
{{ __('modules.auth.common.password') }}
```
:::
## App shell components
| Component | Purpose |
| --- | --- |
| `AppShell`, `AppContent` | Wrap the sidebar provider and main content (`variant: 'sidebar' \| 'header'`) |
| `AppSidebar` | Sidebar with `NavMain` (from `menus`) or the setup menu (`setupMenus` on `/setup/*`) |
| `AppSidebarHeader` | Top bar of the sidebar layout with the trigger and `Breadcrumbs` |
| `AppHeader` | Top navigation for the header layout (menus, breadcrumbs, user menu) |
| `NavMain`, `NavFooter` | Sidebar menu tree, footer links |
| `AppHeaderActions`, `NotificationBell`, `LanguageSwitcher`, `UserMenuButton` | Header actions next to the breadcrumbs: notification bell, language switcher and profile menu. See [Notifications](/docs/core/notifications) |
| `UserMenuContent` | User dropdown: settings link, language switcher (`useLanguage().changeLanguage`), logout |
| `Breadcrumbs` | Renders `BreadcrumbItem[]`; titles are translation keys |
| `Heading` | Page or section heading. Props: `title`, `description?`, `variant?: 'default' \| 'small'` |
| `TextLink` | Styled Inertia `Link`. Props: `href`, `tabindex?`, `method?`, `as?` |
| `ErrorStatus` | Body of the error page for 403/404/500/503. Prop: `status: number` |
| `AlertError` | Destructive alert listing `errors: string[]` |
| `AppLogo`, `AppLogoIcon`, `PlaceholderPattern`, `UserInfo`, `AppearanceTabs` | Branding, placeholders, avatar + name, theme switcher |
| `DeleteUser` | Delete-account section on the profile page |
| `ManageTwoFactor`, `TwoFactorSetupModal`, `TwoFactorRecoveryCodes` | Two-factor setup on the security page |
| `ManagePasskeys`, `PasskeyRegister`, `PasskeyItem`, `PasskeyVerify` | Passkey management and passkey login |