Avatar

Represents a person or organization with an image or fallback.

CNCNCN

Installation

Install Avatar from Oros with shadcn CLI 4.13.0.

pnpm dlx shadcn@4.13.0 add @oros/avatar

Usage

import {
  Avatar,
  AvatarImage,
  AvatarFallback,
  AvatarGroup,
  AvatarGroupCount,
  AvatarBadge,
} from "@/components/ui/avatar"

Open the Source tab in the preview for a complete working example.

Anatomy

Export	Responsibility
Avatar	The root component that owns the primary structure and state.
AvatarImage	A composable part of the component anatomy.
AvatarFallback	A composable part of the component anatomy.
AvatarGroup	Groups related items into one logical set.
AvatarGroupCount	A composable part of the component anatomy.
AvatarBadge	A composable part of the component anatomy.

API Reference

Avatar exports 6 named entries. Component exports accept the props of their underlying HTML element or Base UI component, plus an optional className, unless the source defines a more focused type.

Avatar Component
AvatarImage Component
AvatarFallback Component
AvatarGroup Component
AvatarGroupCount Component
AvatarBadge Component

Accessibility

Avatar adds no application-specific accessible name by itself; use semantic content and label any interactive descendants.
Do not communicate state or meaning through color alone, and verify the composed result at text zoom and with keyboard navigation.

Source

Avatar uses the standard shadcn API and is distributed through Oros. Installing it adds the component source and required dependencies to your app. The Source tab above shows a complete usage example.

Autocomplete Badge