Measured entry

ruixen-avatar-spring-stack

statsunclassifiedmotion on file

A client-side React avatar group that overlaps profile images, pushes neighboring items apart with Motion springs on hover, reveals a label, and ends with an overflow count. It ships as a shadcn registry component and depends on Motion, the shadcn Avatar primitive, Tailwind theme classes, and the local cn utility.

Specimen
Motion capture of the mounted demo, recorded by the harness. No audio track.
Harness screenshot of ruixen-avatar-spring-stack at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-avatar-spring-stack at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of ruixen-avatar-spring-stack 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 ruixen-avatar-spring-stack
BuildOK
MountOK
Console errors5
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious1
Axe moderate0
Axe minor0
Gzip marginal75.1 KB (140.6 KB build, 65.5 KB baseline)
Bare modeFAIL
Provider requiredNO
Demo usedwritten from the component source API

What the harness recorded

CONSOLE

Failed to load resource: the server responded with a status of 404 (Not Found)

CONSOLE

Failed to load resource: the server responded with a status of 404 (Not Found)

CONSOLE

Failed to load resource: the server responded with a status of 404 (Not Found)

Verdict

A polished fit for an existing shadcn app, but not ready as an accessible identity control: labels rely on hover and the muted text needs contrast work. It needs a shadcn-style setup to build and mount, so plain React teams should budget for adaptation.

Use it if

  • You need a compact face pile for collaborators, attendees, reviewers, or team members.
  • Your product already uses shadcn conventions and Motion, so the registry imports fit the codebase.
  • Labels are supplementary and the animated hover treatment is appropriate for pointer users.

Skip it if

  • Names or controls must be discoverable by keyboard and touch users, since the label is driven only by mouse hover.
  • You need a lightweight static avatar group and do not otherwise use Motion.
  • Your theme cannot be adjusted to fix the muted label and overflow text contrast.
  • You need a drop-in component for a plain React project without shadcn aliases, utilities, and theme tokens.

Install

Installation record for ruixen-avatar-spring-stack
Declared dependenciesmotion, radix-ui, clsx, tailwind-merge
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 Motion and an Avatar implementation backed by Radix, provide the cn helper with clsx and tailwind-merge, configure the import aliases, and supply Tailwind classes plus the background, muted, and muted-foreground theme tokens. Replace mouse-only label behavior with focus and touch support if names matter.

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.

Alternatives

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