Avatar

User image or initials display with size, shape, status, and group variants.

Image Avatar

When a photo is available. Crops to fill the circle.

Andi Pratama
xs
Andi Pratama
sm
Andi Pratama
md
Andi Pratama
lg
Andi Pratama
xl
Andi Pratama
2xl

Initials Fallback

Deterministic colour palette from 8 named variants — assign by hashing user ID.

AP
AP
SR
SR
BS
BS
DL
DL
RW
RW
NK
NK
FH
FH
YP
YP

Sizes:

AP
AP
AP
AP
AP
AP

Icon Fallback

Use when neither photo nor name is known — anonymous or deleted users.

Square Shape

Better for brand logos, workspace icons, or bot avatars.

AP
xs
AP
sm
AP
md
AP
lg
AP
xl
AP
2xl

Status Dot

Overlay dot for presence indicators. Wrap the avatar in .av-wrap so the dot sits outside the clipped circle.

AP
Online
SR
Busy
BS
Away
DL
Offline
Online
Busy
Away
Offline

Avatar Group

Stacked avatars for "members", "seen by", or collaborator lists. Groups are flex-direction: row-reverse so left-most avatar visually sits on top.

3 members

BS
SR
AP

5 members, showing 4 + overflow

+2
DL
BS
SR
AP

Large (lg)

+8
BS
SR
AP

Small (sm)

+3
RW
DL
BS
SR
AP

Real-world: Comment Thread

How avatar + name + status compose into a comment list.

AP
Andi Pratama Product Manager · 2 min ago

Looks great — the filter chip behaviour matches what we discussed. Can we also show a count badge when a filter is active?

DL
Dewi Lestari Designer · 15 min ago

I think the selected state contrast is good. Maybe bump the border-radius to match the new button style?

BS
Budi Santoso Engineer · 1 hr ago

Done. Used --radius-sm across the board as per the design token guide.

Real-world: Team Member List

Compact list combining avatar, name, status indicator, and role badge.

AP

Andi Pratama

Admin
SR

Siti Rahayu

Editor
BS

Budi Santoso

Editor
DL

Dewi Lestari

Viewer
RW

Rizki Wahyu

Viewer