Installation
Usage
Examples
Basic Avatar Stack
With Overflow Count
Custom Styling
Component API
AvatarCircles
Array of avatar objects containing image and profile URLs.Each
Avatar object has:imageUrl: string - URL of the avatar imageprofileUrl: string - URL to navigate when avatar is clicked
Number of additional people to display in the overflow indicator. When provided and greater than 0, shows a “+N” circle at the end.
Additional CSS classes to apply to the container. Default includes
-space-x-4 for overlapping effect.Features
- Overlapping avatar display with negative margin spacing
- Clickable avatars that link to profile pages
- Optional overflow count indicator
- Automatic RTL support with
rtl:space-x-reverse - Border styling for visual separation
- Responsive design with fixed dimensions
- Dark mode support
Styling
The component includes:- Avatar size: 40px × 40px (h-10 w-10)
- Border: 2px white border (dark: gray-800)
- Overlap: -1rem spacing (-space-x-4)
- Shape: Fully rounded (rounded-full)
- Overflow indicator: Black background (dark: white) with centered text