ChronicStone/nuxt-ui-tools / skills/consumer/display
nuxt-ui-tools-display
VerifiedUse this skill when showing read-only content with nuxt-ui-tools display blocks, inside a form (the `info` field with `display` and `props`) or on their own (`UiDisplay`). Covers the 19 kinds (heading, text, alert, facts, stat, breakdown, meter, chart, table, diff, record, person, list, timeline, date, media, code, empty, accordion) and their variants, props that follow form values or load through a promise or TanStack Query options with skeleton and error states, the form api in props callbacks, the label shell, lazy file links, presets, slot classes, and tones, including tones an app registers.
nuxt-ui-tools Display
Display blocks draw read-only content: notices, label/value facts, totals, gauges, records, people, lists, timelines, dates, media, code, empty states. Each block is one kind with a few variants, configured by plain props.
Use them in two places:
- in a form, as an
infofield withdisplayandprops, wherepropscan read the form values, load data, and act on the form; - anywhere else, with the
UiDisplaycomponent (NutDisplaywith theNutprefix).
import { defineFormSchema } from '#ui-tools/form'
defineFormSchema({
fields: [
{ key: 'seats', type: 'number', label: 'Candidates', default: 30 },
{
key: 'quote',
type: 'info',
display: 'breakdown',
dependencies: ['seats'],
props: ({ deps }) => ({
lines: [
{ label: 'Licences', detail: `${deps.get<number>('seats')} × €96`, value: total(deps) },
],
total: { label: 'Total', value: totalWithVat(deps) },
}),
},
],
})
<UiDisplay
display="facts"
:props="{
layout: 'grid',
items: [{ label: 'Status', chip: { label: 'Active', tone: 'success' } }],
}"
/>
References
skills/consumer/display/references/kinds.md— every kind, its variants and props, with examplesskills/consumer/display/references/info-field.md— the forminfofield: static, derived and loaded props, the formapi, the label shell, presets, the legacy noticeskills/consumer/display/references/theming.md— tones (built-in and registered), slot classes, presets, icons, CSS variables, translations
Kinds at a glance
| Kind | Variants | For |
|---|---|---|
heading | title (sm, md, lg), eyebrow | titling a group of fields |
text | body, lead, muted, caption, quote, legal, prose | copy, quotes, legal notes |
alert | soft, outline, subtle, solid, callout, inline, banner | notices with items, lists, details, actions |
facts | ledger, grid, inline, columns, tiles | label → value pairs |
stat | hero, price, row, trend | one figure or a row of them |
breakdown | open, collapsible, compare | lines adding up to a total |
meter | bar, segments, split, ring, scale | usage, shares, scores, levels |
chart | bars, line, donut, funnel | small charts in the dashboard palette |
table | — | a light read-only table |
diff | inline, columns | what a change will do |
record | row, card, compact, stack | one entity or a stack of them |
person | user, group, contact | people |
list | bullets, numbered, icons, checks, steps, columns, files, chips | lists |
timeline | vertical, log, pipeline, schedule | history and plans |
date | tile, range, countdown | a moment, a span, a deadline |
media | image, gallery, video, document, link | files and links |
code | block, value, secret | values people copy |
empty | dashed, plain | nothing yet, and how to fix it |
accordion | separated, flush | folded content, nested blocks |
Shared props
Every kind takes loading (draws its skeleton) and ui (slot classes). Most take some of:
tone:primary,secondary,success,info,warning,error,neutral, or a tone the app registered (see theming)surface:plain,muted,bordered,elevatedsize:sm,md,lgmax,step,emptyon lists: fold aftermaxitems with a « Show more · N » button, revealstepmore at a time, and say what is missing when there is nothingactions:UButtonprops with a lazylabelcopyon facts, people and code values
Text props accept a string, a lazy translation (() => t('key')), a VNode, or a render function.
Gotchas
propsis required on an info display field; with apreset, the preset fills the props you leave out.- A registered tone needs both the
display.tonesentry (its colors) and theDisplayToneRegistryaugmentation (its name in types). - Pass dates as
Date, ISO strings or epoch milliseconds; blocks format them with the locale. - File links can be functions returning a signed URL; they run only when the link is used.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |