Skip to content

ChronicStone/nuxt-ui-tools / skills/consumer/display

nuxt-ui-tools-display

Verified

Use 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 info field with display and props, where props can read the form values, load data, and act on the form;
  • anywhere else, with the UiDisplay component (NutDisplay with the Nut prefix).
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 examples
  • skills/consumer/display/references/info-field.md — the form info field: static, derived and loaded props, the form api, the label shell, presets, the legacy notice
  • skills/consumer/display/references/theming.md — tones (built-in and registered), slot classes, presets, icons, CSS variables, translations

Kinds at a glance

KindVariantsFor
headingtitle (sm, md, lg), eyebrowtitling a group of fields
textbody, lead, muted, caption, quote, legal, prosecopy, quotes, legal notes
alertsoft, outline, subtle, solid, callout, inline, bannernotices with items, lists, details, actions
factsledger, grid, inline, columns, tileslabel → value pairs
stathero, price, row, trendone figure or a row of them
breakdownopen, collapsible, comparelines adding up to a total
meterbar, segments, split, ring, scaleusage, shares, scores, levels
chartbars, line, donut, funnelsmall charts in the dashboard palette
table—a light read-only table
diffinline, columnswhat a change will do
recordrow, card, compact, stackone entity or a stack of them
personuser, group, contactpeople
listbullets, numbered, icons, checks, steps, columns, files, chipslists
timelinevertical, log, pipeline, schedulehistory and plans
datetile, range, countdowna moment, a span, a deadline
mediaimage, gallery, video, document, linkfiles and links
codeblock, value, secretvalues people copy
emptydashed, plainnothing yet, and how to fix it
accordionseparated, flushfolded 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, elevated
  • size: sm, md, lg
  • max, step, empty on lists: fold after max items with a « Show more · N » button, reveal step more at a time, and say what is missing when there is nothing
  • actions: UButton props with a lazy label
  • copy on facts, people and code values

Text props accept a string, a lazy translation (() => t('key')), a VNode, or a render function.

Gotchas

  • props is required on an info display field; with a preset, the preset fills the props you leave out.
  • A registered tone needs both the display.tones entry (its colors) and the DisplayToneRegistry augmentation (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.
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: 319kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall