Components/Avatar

Avatar

User avatar with image, initials fallback, multiple sizes, presence indicators, and AvatarGroup for stacking with overflow count.

import { Avatar, AvatarGroup } from "@animui/ui"

Sizes, presence & groups

S
M
L
X
O
A
B
O
A
B
C
D
+2

Props

PropTypeDefaultDescription
srcstringImage URL. If omitted or fails to load, falls back to the fallback text.
fallbackstring1–2 character text rendered when no image is available.
altstringAlt text for the avatar image (used for screen readers).
size"xs" | "sm" | "md" | "lg" | "xl""md"Diameter of the avatar.
status"online" | "away" | "busy" | "offline"Shows a colored dot indicator in the bottom-right corner.
classNamestringAdditional Tailwind classes on the avatar element.
© 2026 Steal Shadow. MIT License.Report an issue