Components

Avatar Group

Overlapping facepile; extra people collapse into a “+N” chip.

ALGHLT+2

Usage

Use it to:

  • show who is on a page, project or thread at a glance

Don’t use it to:

  • a full member list (use a list with names)

Installation

Install the package (React 19):

terminal
npm install @krackedui/motion

Import the styles once, in your app entry or root layout:

/src/main.tsx
import '@krackedui/motion/styles.css';

Use it anywhere inside your app's <Theme> (see Installation):

/src/AvatarGroupExample.tsx
import { Avatar, AvatarGroup } from '@krackedui/motion';

export function Collaborators() {
  return (
    <AvatarGroup max={3}>
      <Avatar name="Ada Lovelace" />
      <Avatar name="Grace Hopper" />
      <Avatar name="Linus Torvalds" />
      <Avatar name="Margaret Hamilton" />
      <Avatar name="Alan Turing" />
    </AvatarGroup>
  );
}

Examples

Size

AGL
AGL
AGL
AGL
AGL

Workspaces

Children default to the circular user shape; set shape to keep squares.

DTE

Dark theme

AG+1

API Reference

AvatarGroup

A <div role="group">; supports all of its props. Adds:

PropTypeDefault
max
number
4
size
"xs""sm""md""lg""xl"1620242832
"md"

Accessibility

  • A group; each avatar is an image named after its person, and the chip is named “N more”.
  • Add aria-label to the group (“Collaborators”) when its purpose is not clear from context.
© 2026 Motion. Internal documentation.