Item

A flexible list item component for contacts, notifications, settings rows, and more.

Jane Appleseed

Product designer · San Francisco

Installation

pnpm dlx stera-ui add item

Usage

import {
  Item,
  ItemContent,
  ItemTitle,
  ItemDescription,
  ItemMedia,
} from "@/components/ui/item"
<Item>
  <ItemMedia variant="icon">
    <SiUser />
  </ItemMedia>
  <ItemContent>
    <ItemTitle>Jane Appleseed</ItemTitle>
    <ItemDescription>Product designer · San Francisco</ItemDescription>
  </ItemContent>
</Item>

All Variants

Default variant

No border, transparent background.

Outline variant

Visible border, transparent background.

Muted variant

Subtle muted background, no border.

VariantDescription
defaultNo border, transparent background
outlineVisible border, transparent background
mutedSubtle muted background, no border

All Sizes

Default size

Standard padding and spacing.

Small size

Reduced padding and spacing.

Extra small size

Compact padding and spacing.

SizeDescription
defaultStandard padding and spacing
smReduced padding and spacing
xsCompact padding and spacing

With Actions

Notifications

You have new activity.

4
Team member request

Notification List

Deployment successful

Production build v2.4.1 deployed without errors.

Done
3 new mentions

You were mentioned in the #design channel.

3
Team invite accepted

Jordan joined the workspace.

API Reference

Item

PropTypeDefault
variant"default" | "outline" | "muted""default"
size"default" | "sm" | "xs""default"
renderReactElement

ItemMedia

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

Subcomponents

ComponentDescription
ItemContentFlex column container for title and description
ItemTitlePrimary label text
ItemDescriptionSecondary supporting text
ItemActionsRight-aligned slot for badges, buttons, or controls
ItemGroupWrapper for a list of items
ItemSeparatorHorizontal divider between items
ItemHeaderOptional header row for a group
ItemFooterOptional footer row for a group