Theme

AvatarGroup

display @dryui/ui

Overlapping avatar stack with overflow indicator

avatarsgroupteampeoplesocial-proof

Start Here

Start from the smallest working snippet, then move to interactive examples and the full API contract below.

Styled quick start

Copy this entrypoint first. It includes the imports required to get the component on screen.

svelte
<script lang="ts">
  import '@dryui/ui/themes/default.css';
  import '@dryui/ui/themes/dark.css';
  import { AvatarGroup } from '@dryui/ui';
</script>

<AvatarGroup count={5} maxVisible={4} label="Trip attendees">
  <Avatar src="/avatar-1.jpg" alt="Maya Chen" fallback="MC" />
  <Avatar src="/avatar-2.jpg" alt="Jordan Lee" fallback="JL" />
  <Avatar src="/avatar-3.jpg" alt="Priya Patel" fallback="PP" />
  <Avatar src="/avatar-4.jpg" alt="Sam Rivera" fallback="SR" />
</AvatarGroup>

Import options

Root package

ts
import { AvatarGroup } from '@dryui/ui'

Per-component subpath

ts
import { AvatarGroup } from '@dryui/ui/avatar-group'

Customize

Use the interactive examples to see common variants, states, and composition patterns before building your own.

Stacked avatars

Maya ChenJordan LeePriya PatelSam Rivera
svelte
<AvatarGroup count={5} maxVisible={4} label="Trip attendees">
  <Avatar src="https://i.pravatar.cc/96?img=12" alt="Maya Chen" fallback="MC" />
  <Avatar src="https://i.pravatar.cc/96?img=32" alt="Jordan Lee" fallback="JL" />
  <Avatar src="https://i.pravatar.cc/96?img=47" alt="Priya Patel" fallback="PP" />
  <Avatar src="https://i.pravatar.cc/96?img=18" alt="Sam Rivera" fallback="SR" />
</AvatarGroup>

Compact crew

svelte
<AvatarGroup count={3} maxVisible={3} size="sm" label="Design team">
  <Avatar fallback="AB" size="sm" />
  <Avatar fallback="CD" size="sm" />
  <Avatar fallback="EF" size="sm" />
</AvatarGroup>

Compose

The full API contract lives here: props, CSS variables, and the public data attributes you can target when styling.

Prop Type Default Required Bindable
count
number
0 — —
maxVisible
number
4 — —
size
smmdlg
 'md' — —
overlap
smmdlg
 'md' — —
status
onlineofflinebusyaway
 — — —
label
string
'Avatar group' — —
children
Snippet
— ✓ —

Forwards <div> attributes via rest props. Common examples: id, style, role.