Avatar Circles

A component displaying user avatars in a stacked, overlapping circle layout with an optional count badge.

Installation

pnpm dlx shadcn-svelte@latest add https://sv-animations.vercel.app/r/avatar-circles.json

Usage

<script lang="ts">	import { AvatarCircles } from "#lib/components/magic/avatar-circles/index.js";
	const avatars = [		{			imageUrl: "https://github.com/shadcn.png",			profileUrl: "https://github.com/shadcn",		},	];</script>
<AvatarCircles avatarUrls={avatars} numPeople={12} />

Props

Avatar Circles

A component that displays user avatars in a stacked, overlapping circle layout.

NameTypeDefaultDescription
avatarUrlsAvatar[]requiredArray of avatar objects with imageUrl and profileUrl properties
numPeoplenumberundefinedOptional number to display in the count badge (e.g., +99)
classClassValue""Additional CSS classes to apply