Studio
Studio/Kits
New kit
Canonical inventory
Data display · core

Card

surface.card

Card: A structured display for reading, comparing, or inspecting information.

cardthe structured information blockthe data display
States4
Touch targetDisplay
Evidence4
Introduced by8 kits
Visual specimen

Same contract. Every kit voice.

Card

Card

Card: A structured display for reading, comparing, or inspecting information.

MAVAN renderingdefault
Translation table

What code calls it.

Websemantic data structureThis component is composed from multiple web primitives.pattern
ARIAtable, list, or groupNo single ARIA role represents the complete component.pattern
SwiftUICustom View compositionSwiftUI has no single direct equivalent; compose and name the behavior explicitly.approximation
AppKitCustom NSView compositionAppKit has no single direct equivalent; use a custom view or controller composition.approximation
Anatomy

Every part, named.

  1. 1Data container
  2. 2Primary values
  3. 3Labels or headers
  4. 4Grouping or separators
  5. 5Empty and error treatment
Often confused with

Similar shape. Different contract.

Feature cardsurface.feature-card

Shares a visual family, but has a different role, state model, or interaction contract.

Glass cardsurface.glass-card

Shares a visual family, but has a different role, state model, or interaction contract.

Spotlight cardsurface.spotlight-card

Shares a visual family, but has a different role, state model, or interaction contract.

Prompt · paste into your agent

Ask for the exact thing.

Implement the canonical Card component (surface.card). Card: A structured display for reading, comparing, or inspecting information. Support these states: default, loading, empty, error. Use semantic design tokens rather than raw visual values. Preserve a minimum appropriatepx touch target where interactive. Provide and verify: implementation, state-matrix, responsive, reduced-motion. Keep the component API stable so every Studio kit can supply its own rendering without changing the behavior contract.
Studio contract

What must be proven.

Required states

default · loading · empty · error

Required evidence

implementation · state-matrix · responsive · reduced-motion

Source union

mavan · jade · lumen · aurora · cabana · purple-rain · spatial · margin