Ballmac UI home

Item

A flexible list row with media, title, description and actions, in outline, muted and plain variants, that can also render as a link.

Two-factor authentication On

Codes from your authenticator app protect sign-in.

Deploy alerts

Email when a production deploy fails.

Connected accounts

1 connected: GitHub

Installation

$ pnpm dlx shadcn@latest add @ballmac/item

Usage

import { Item, ItemGroup, ItemSeparator, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemHeader, ItemFooter } from "@/components/ballmac/item"

The full example is in the Code tab above.

Examples

Files and footer

Brand guidelines.pdf

4.2 MB · edited 2 hours ago

Launch checklist.md

12 KB · edited yesterday

Pricing model.xlsx

88 KB · edited Monday

Storage
6.4 of 10 GB

Upgrade to keep uploading past your limit.

Resets monthly

API reference

<Item>

PropTypeDefault
asChild

Render the child (a link or button) with item styles and behavior.

booleanfalse
variant"default" | "outline" | "muted""default"
size"default" | "sm""default"

<ItemMedia>

PropTypeDefault
variant"default" | "icon" | "image""default"

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Tab / EnterWhen rendered as a link or button, behaves as one

Use with AI

Compose rows from ItemMedia, ItemContent, ItemTitle, ItemDescription and ItemActions. asChild styles a link or button as a whole-row target. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Item (@ballmac/item) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Settings, connected accounts and file lists
  • Rows with an icon or avatar, text and an action

Not for

  • Tabular data with columns; use table
  • Long card layouts; use card

Registry JSON: https://ui.ballmac.com/r/item.json

Credits

Based on shadcn/ui Item, adapted by Ballmac. Free to use in personal and commercial projects.

Registry
shadcn/utils