vibecodng.com

Free MCP betaIndex and tools live

Measured entry

magicui-avatar-circles

avatarbento

A client-side React component that renders linked profile images as an overlapping avatar row, with an optional remaining-people badge. It ships as shadcn registry source, declares no package dependencies, and relies on Tailwind utility classes plus the customary cn helper imported through the project alias.

Specimen
Harness screenshot of magicui-avatar-circles at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-avatar-circles at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of magicui-avatar-circles at 1440 pixels wide
Harness screenshot at 1440 pixels wide. No horizontal overflow recorded.

Measured

Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.

Harness measurements recorded for magicui-avatar-circles
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious0
Axe moderate0
Axe minor0
Gzip marginal26.0 KB (91.4 KB build, 65.4 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

BARE BUILD

✗ Build failed in 25.20s
error during build:
[vite:load-fallback] Could not load <sandbox>/src/lib/utils (imported by src/cut/avatar-circles.tsx): ENOENT: no such file or directory, open '<sandbox>/src/lib/utils'

Verdict

Useful as a tiny source component in an existing design system, but the provided demo does not mount because the required avatar list is omitted. The bare version also needs a shadcn-style setup, including its utility import. Adopt it only if you are comfortable wiring props and project conventions yourself.

Use it if

  • You need a compact row of linked member or customer avatars.
  • Your app already uses Tailwind and a shadcn-style utility setup.
  • You can supply the required avatar URL and profile URL data explicitly.

Skip it if

  • You need a drop-in component that renders safely without required props.
  • Your project does not use Tailwind utility classes and you do not want to translate the styling.
  • You need a non-linking avatar group or richer overflow interactions such as a popover.

Install

Installation record for magicui-avatar-circles
Declared dependenciesnone declared
Missing on installnone
Bare installfails once the shadcn-style helpers are removed, so it needs that setup
Providerno provider required in the harness

In a non-shadcn project, add Tailwind or replace the utility classes, provide a cn class-merging helper, and either configure the project alias used by the import or change it to a local path. Always pass an avatar list, even when it is empty.

Source and credit

This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.

Author repository

github.com/magicuidesign/magicui
License
MIT
Record published
2026-08-13

Alternatives

Other published entries for the avatar pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.