Overlapping avatars cut from each other by background rings, a dashed +N chip whose count rolls, members that glide, pop in and shrink out, and a callout that names whoever you hover or tab to.
pnpm dlx shadcn@latest add @beautiful-ui-pro/avatar-groupNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Import it and pass your content. The props that matter most are listed next.
import { AvatarGroup, type GroupPerson } from "@/components/ui/notchset/avatar-group";
const reviewers: GroupPerson[] = [
{ id: "mk", name: "Maya Kerr", role: "ML lead", presence: "on" },
{ id: "jw", name: "Jonas Weber", role: "Evals", presence: "away" },
{ id: "ar", name: "Ana Ruiz", role: "Infra" },
{ id: "lp", name: "Lee Park", role: "Design" },
{ id: "so", name: "Sam Osei", role: "Support" },
];
export function Reviewers() {
return <AvatarGroup aria-label="Reviewers" people={reviewers} max={4} />;
}people–
{ id, name, role?, presence?, tone? }[]In order; the first max are shown.
max–
numberAvatars before +N (4).
components/ui/notchset/avatar-group.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.