Avatar

A user avatar component with image, fallback, badge, and group support.

CG

Installation

pnpm dlx stera-ui add avatar

Usage

import {
  Avatar,
  AvatarFallback,
  AvatarImage,
} from "@/components/ui/avatar"
<Avatar>
  <AvatarImage src="/avatar.jpg" alt="Jane Appleseed" />
  <AvatarFallback>JA</AvatarFallback>
</Avatar>

Fallback Only

JD

Sizes

CGCGCG
SizeDescription
smSmall
defaultMedium (default)
lgLarge

Shapes

CGCG
ShapeDescription
circleCircular (default)
squareRounded square

With Badge

CGCGCGCGCG
Badge VariantDescription
subtleNeutral indicator
successOnline / active
dangerBusy / unavailable
warningAway
iconCustom icon inside badge

Icon Fallback

Avatar Group

CGLRJD
+4

API Reference

Avatar

PropTypeDefault
size"sm" | "default" | "lg""default"
shape"circle" | "square""circle"

AvatarBadge

PropTypeDefault
variant"subtle" | "success" | "danger" | "warning" | "icon""subtle"