v0.1 public beta early access on GitHub
Home / Components / avatar

AvatarAndroid

Circular user image with fallback initials and status dot.

$ npx lumioui add avatar
import { Avatar } from "@/components/ui/avatar/avatar";
Avataravatar.tsx
avatar/avatar.tsx open

Live preview — the real component, driven by the props below.

Props7
size? "sm" | "md" | "lg" | "xl"
source? ImageSourcePropType Image source for the avatar — fades in when it loads.
fallback? string Fallback initials shown when no image (or it fails).
status? keyof typeof statusColors Presence dot in the corner — chat/status lists.
onPress? (e: GestureResponderEvent) => void Makes the avatar tappable (profile → detail).
className? string
alt? string Accessibility label — defaults to "Avatar".
Avatar — Fallbackfallback.tsx
avatar/variants/fallback.tsx open

Circular user image with fallback initials and status dot.

Avatar — Presencepresence.tsx
avatar/variants/presence.tsx open

Circular user image with fallback initials and status dot.

Avatar — Sizessizes.tsx
avatar/variants/sizes.tsx open

Circular user image with fallback initials and status dot.