Measured entry

clay-avatar

avatarclaymorphismfirst party

A self-contained React avatar with a claymorphic frame, image or initials fallback, preset sizes and colors, and an optional presence dot. It ships as a single JSX component with no package dependencies, but its styling relies on Tailwind utility classes and arbitrary values.

Specimen
Harness screenshot of clay-avatar at 375 pixels wide
Harness screenshot at 375 pixels wide. No horizontal overflow recorded.
Harness screenshot of clay-avatar at 768 pixels wide
Harness screenshot at 768 pixels wide. No horizontal overflow recorded.
Harness screenshot of clay-avatar 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 clay-avatar
BuildOK
MountOK
Console errors0
Uncaught page errors0
Horizontal overflowclean at 375, 768, 1440
Axe critical0
Axe serious1
Axe moderate0
Axe minor0
Gzip marginal18.2 KB (83.6 KB build, 65.4 KB baseline)
Bare modeOK
Provider requiredNO
Demo usedwritten from the component source API

Verdict

A focused, dependency-free avatar that builds, mounts, and stays contained across the tested layouts. It is practical for clay-styled interfaces, but the status element uses an ARIA label on a generic span, so fix that accessibility issue before production use.

Use it if

  • You need a compact profile avatar that accepts either an image or initials.
  • Your interface already uses Tailwind and a soft claymorphic visual language.
  • You want a simple optional presence indicator without adding a component library.

Skip it if

  • Your product uses a restrained, flat, or highly formal design system.
  • You need an accessible status announcement without modifying the component's current generic span markup.
  • Your project does not use Tailwind and you do not want to translate its utility-heavy styling.

Install

Installation record for clay-avatar
Declared dependenciesnone declared
Missing on installnone
Bare installbuilds and mounts without the shadcn-style helpers
Providerno provider required in the harness

First-party component from the sir-originals set. In a non-shadcn project, add the JSX component and ensure React and Tailwind CSS are configured to scan its file. Tailwind must support the arbitrary color, radius, border, inset-shadow, and sizing utilities used here. Replace the status span with accessible markup or expose its meaning in nearby text.

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

mrkeyoor/sir-originals
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.