ns-ui
Avatar stack that mills as a live boids flock and resolves into the classic overlapping row on hover, with the +N badge appearing only once the formation settles.
Use when a team or presence avatar cluster that should feel alive at idle and still resolve to the conventional overlapping row plus +N badge on hover or focus, so the flocking never costs legibility the moment someone actually looks; pick dock-shelf-lean instead when the row is a dock of actions rather than people, or typing-indicator-trace when the question is who is active right now rather than who is on the team.
Install
npx shadcn add https://design.helpmarq.comns-ui / avatar-stack-flock
10 people shipped to production this week.
hover the flock: it lines up for the group photo
3 invites pending
| Prop | Type | Default | Description |
|---|---|---|---|
| members? | FlockMember[] | DEFAULT_MEMBERS | flocking avatars (<=12 recommended; sim is O(n^2)) |
| overflow? | number | 3 | count in the "+N" badge shown once the flock resolves |
| avatarSize? | number | 28 | avatar diameter in px |
| className? | string | "h-[120px]" | — |
| aria-label? | string | — | — |