This page ships a Markdown twin for AI tools.

ComponentsAvatarGroupGrid

displaytexulinot agent-emittableapp

AvatarGroupGrid

avatar-group-grid

Up to four faces in one avatar circle, +N past four.

One token contract, every theme. Display components take color, radius, density and state styling from the --tx-* token contract — the same variables the theme strip below overrides — so a theme swap re-colors them without per-component fixes.

Live examples

Group chat

Group chat

Loading demo…

In your theme

This page renders in the site theme, enterprise-neutral. Every one of the 210 library themes re-colors every component through the --tx-* contract. The three below carry real token values from the library, rendered at build — no island, no extra requests.

  • Violet

    light mode · AA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

  • Monochrome

    light mode · AA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

  • Accessible Dark Contrast

    dark mode · AAA contrast

    • background
    • surface
    • primary
    • accent
    • border
    Open Theme Studio

Props

Public props for AvatarGroupGrid
NameKindRequiredDefaultDescription
itemsarrayyes—{ name, src?, srcset? }[]
sizeenum (xs, sm, md, lg)no"md"—
labelstringno—Accessible name
overflowLabelstringno"+{n}"—
classstringno——

Keyboard

Keyboard behavior for AvatarGroupGrid
KeyAction
—See accessibility notes for keyboard behavior.

Accessibility

  • One image named by label or the member names.

Evidence for avatar-group-grid

Latest committed gates for avatar-group-grid (as of 2026-10-23). Static snapshot — not live CI.

Behavior

n/ano behavior scenario

No dedicated behavior scenario for this catalog id (a styled or display surface, covered by its unit and axe tests).

Size (gzip)

texuli/avatar-group-grid · budget 12.0 KiB

Budget from texuli.budgets.json; re-measure with `pnpm size --filter <entry>`.

Axe

documented

  • tests/e2e/site-component-pages.spec.ts
  • docs/quality (a11y-*)

Site component pages axe gate; package-level a11y docs under docs/quality when present.

Browsers

  • chromium
  • webkit
  • mobile

Playwright projects: Desktop Chrome, Desktop Safari, Pixel 7. Firefox is a known gap on this host.

When to use

Use when

  • A group chat shown as one avatar

Don’t use when

Prefer another component

  • A row of people (use AvatarGroup)