Catalog

Per-component entries grouped by task, mirroring the skill's component references. Real rendered instances live here; props and full usage live in the references — follow the Usage link on each entry.

Buttons / actions

UButton

Primary action trigger across variants, sizes, icons, and states.

Usage

Variants

Sizes

With icon

States

UButtonGroup

Joins related buttons into one segmented control with shared borders.

Usage

Segmented

Forms

UFormField

Wraps a control to wire up label, description, error, and ARIA.

Usage

Label + description

Used for sign-in

Error state

Enter a valid email address

UForm

Binds reactive state (and an optional schema) for validated submits.

Usage

State-bound form

控件 · Controls

The control primitives — always placed inside a UFormField.

Usage

Text inputs

Select

Toggles

Feedback

UAlert

Inline message pairing icon, semantic color, title, and description.

Usage

Semantic colors

Payment received
Your subscription is now active.
Usage nearing limit
You have used 90% of your quota.
Deployment failed
Check the build logs for details.

UToast

Transient notification fired via the useToast() composable.

Usage

Trigger

UProgress

Determinate or indeterminate progress indicator.

Usage

Values

USkeleton

Loading placeholder built from Tailwind size classes.

Usage

Content placeholder

Overlays

UModal

Modal dialog with focus trap, overlay, and Esc-to-close.

Usage

Dialog

USlideover

Edge-anchored panel with the same modal semantics as UModal.

Usage

Right panel

UPopover

Non-modal floating panel that can hold interactive content.

Usage

Click trigger

AnnotationPopover

Inline annotation trigger anchored to a non-modal popover, with hover enhancement and async chrome.

Usage

Inline term

Rate limits use a algorithm to smooth out bursts.

Loading

The variant refills at a constant rate.

Error

A drains requests at a fixed pace.

UTooltip

Assistive hint only — never place buttons or links inside.

Usage

Icon hint

UDropdownMenu

Keyboard-accessible action menu grouped into sections.

Usage

Actions

Data display

UCard

Content container with header, body, and footer slots.

Usage

With header + footer

Project settings

Body content coloured with semantic tokens.

UTable

Semantic data table with custom column definitions.

Usage

Rows

ProjectStatus
Landing pagePublished
Docs siteDraft
DashboardPublished

UBadge

Non-interactive status, category, or count marker.

Usage

Colors

PublishedPendingFailedDraft

SemanticBadge

Tone atom over UBadge: a curated semantic tone (success/warning/neutral/error/info/secondary) paired with an icon + label. Domain→tone mapping stays in presets.

Usage

Tones

AvailableDeprecatedSunsetRemovedRead-onlyAlternate

InlineCode

Inline code token on a tonal surface (Nuxt UI ProseCode calibrated to Geist: 6px radius, Copy 13 Mono). For values, defaults and allowed values within prose.

Usage

In a sentence

Set timeout_ms to a value such as 3000.

InlineMarkdown

Synchronous, SSR-stable renderer for the inline markdown subset (code, links, bold, em, strikethrough). Lighter than MDC for authored copy that is always inline.

Usage

Inline subset

Supports bold, em, code, strikethrough and links.

UKbd

Keyboard key hint (display only).

Usage

Shortcut

KEsc

USeparator

Divider line, optionally labelled.

Usage

Variants

UAvatar

User avatar with icon or initials fallback; group to stack.

Usage

Single + group

AL
GHATAL

geist-nuxt · 基于 Nuxt UI 的 Geist 设计语言

geist-nuxt · Source-first