Avatar
Displays a user avatar image with fallback initials. Install Avatar from the VLLNT UI registry with the shadcn CLI.
Displays a user avatar image with fallback initials. Part of the core family in VLLNT UI, it ships as a machine-readable registry entry — copy the source directly into your app with the shadcn CLI and own it, no runtime dependency on a component library.
Preview
Switch between light and dark to inspect the embedded Storybook preview.
Installation
Add Avatar to your project with the shadcn CLI. The source lands in your codebase, ready to adapt:
pnpm dlx shadcn@latest add https://ui.vllnt.ai/r/avatar.jsonSource
"use client";
import * as AvatarPrimitive from "@radix-ui/react-avatar";
import { cn } from "../../lib/utils";
const Avatar = ({
className,
ref,
...props
}: React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root> & {
ref?: React.Ref<React.ComponentRef<typeof AvatarPrimitive.Root>>;
}) => (
<AvatarPrimitive.Root
className={cn(
"relative flex size-10 shrink-0 overflow-hidden rounded-full",
className,
)}
ref={ref}
{...props}
/>
);
Avatar.displayName = AvatarPrimitive.Root.displayName;
const AvatarImage = ({
className,
ref,
...props
}: React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Image> & {
ref?: React.Ref<React.ComponentRef<typeof AvatarPrimitive.Image>>;
}) => (
<AvatarPrimitive.Image
className={cn("aspect-square h-full w-full", className)}
ref={ref}
{...props}
/>
);
AvatarImage.displayName = AvatarPrimitive.Image.displayName;
const AvatarFallback = ({
className,
ref,
...props
}: React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Fallback> & {
ref?: React.Ref<React.ComponentRef<typeof AvatarPrimitive.Fallback>>;
}) => (
<AvatarPrimitive.Fallback
className={cn(
"flex h-full w-full items-center justify-center rounded-full bg-muted",
className,
)}
ref={ref}
{...props}
/>
);
AvatarFallback.displayName = AvatarPrimitive.Fallback.displayName;
export { Avatar, AvatarFallback, AvatarImage };
Stories
Explore every variant and state in the interactive Storybook:
Preview
Switch between light and dark to inspect the embedded Storybook preview.