> A component of a Premium AI Canvas design system. Index of every system, component and install setup: https://aicanvas.me/llms.txt

# Item (Andromeda Pro)

Lays out one row of a list or a menu: a glyph, a name with a line under it, and its actions.

- Design system: [Andromeda Pro](https://aicanvas.me/design-systems/andromeda-pro.md)
- License: Premium (proprietary)
- Install slug: `andromeda-pro-item`
- Page: https://aicanvas.me/design-systems/andromeda-pro/item

## Install

```bash
npx shadcn@latest add @aicanvas/andromeda-pro-item
```

Requires Premium. Without a Premium token the command writes a placeholder instead of the component.

Every Andromeda Pro component at once: `npx shadcn@latest add @aicanvas/andromeda-pro`.

Token setup: the Install section of https://aicanvas.me/llms.txt.

## Props

### Item

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `variant?` | `'default'\|'outline'` | `'default'` | `default` is the frameless row of a menu or list (spacing[2] padding, transparent); `outline` is a row on its own (hairline border.subtle, surface.raised ground, spacing[3] padding). |
| `size?` | `'sm'\|'md'` | `'md'` | Rung: sm 12px title, 16px glyph, 28px minimum height; md 14px title, 18px glyph, 32px minimum height. The description is 12px at both. |
| `asChild?` | `boolean` | `false` | Renders via Radix Slot, merging the row onto its single child (a button, link, menuitemradio, option). A child that is interactive takes the row states: hover surface.hover, pressed and aria-checked surface.active, aria-selected or data-active surface.hover, the inset focus ring. |
| `render?` | `React.ReactElement` |  | The same as asChild, in the Base UI form some installers rewrite asChild into: the row renders this element with its props merged onto it, and the row's children, when given, become the element's children. |
| `children?` | `React.ReactNode` |  | ItemMedia, ItemContent and ItemActions, in that order. |
| `className?` | `string` |  | Extra classes merged onto the row. |
| `style?` | `React.CSSProperties` |  | Inline styles merged onto the row. Leave background to the row: its states depend on it. |

### ItemMedia

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `variant?` | `'plain'\|'icon'` | `'plain'` | `plain` is the bare glyph in text.muted at the rung's icon size (16 sm / 18 md); `icon` is a 32px box (spacing[8]) with a hairline border.subtle frame and an 18px glyph. |
| `children?` | `React.ReactNode` |  | An icon element (sized here, any `size` prop is overridden) or an Avatar. |
| `className?` | `string` |  | Extra classes merged onto the media slot. |
| `style?` | `React.CSSProperties` |  | Inline styles merged onto the media slot. |

### ItemPart

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children?` | `React.ReactNode` |  | Content rendered inside the component. |
| `className?` | `string` |  | Extra classes merged onto the part. |
| `style?` | `React.CSSProperties` |  | Inline styles merged onto the part. |

## Remix prompt

The public part of this component's remix prompt. The rest of the build spec is part of Premium.

```markdown
Build **Item**: one row of a list or a menu. A leading glyph that says what kind of thing it is, a name with an optional line under it, and whatever acts on it at the trailing end. React + TypeScript, one file, named exports `Item`, `ItemMedia`, `ItemContent`, `ItemTitle`, `ItemDescription`, `ItemActions`, the `ItemProps` and `ItemMediaProps` types, and `itemVariants` (the row's variant class builder). Use `@radix-ui/react-slot` for `asChild` and `class-variance-authority` for the variant classes.

It is drawn to sit on a near-black ground, `oklch(0.135 0.002 286.2)`, usually inside a floating panel of `oklch(0.187 0.002 286.2)`. The `default` row paints no ground of its own. Typeface: Manrope, falling back to the system sans.

The row is NOT a control until it is rendered as one. Through `asChild` it can BE a button, a link, a menu item or a listbox option, and only then does it take the row states. A plain row holding its own control (a switch, a button) stays still under the pointer: the control is the hit area, and a row that lifted on hover would promise a click it does not take.
```

## More Andromeda Pro components

- [Waveform](https://aicanvas.me/design-systems/andromeda-pro/waveform.md)
- [Logo Cloud](https://aicanvas.me/design-systems/andromeda-pro/logo-cloud.md)
- [Marquee](https://aicanvas.me/design-systems/andromeda-pro/marquee.md)
- [Media Card](https://aicanvas.me/design-systems/andromeda-pro/media-card.md)
- [Message](https://aicanvas.me/design-systems/andromeda-pro/message.md)
