Measured entry

neu-avatar

avatarneumorphismfirst party

A single React avatar component with image and initials modes, three named sizes, and an optional online-style status dot. It ships as source styled entirely with Tailwind utility classes, including arbitrary neumorphic shadows and fixed colors, and has no declared package dependencies or provider requirement.

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

Verdict

A focused, dependency-light avatar that builds, mounts, and fits its tested layouts, but it is not ready unchanged for accessibility-sensitive production use. Fix the invalid ARIA treatment on the initials or status element and replace the fixed palette with project tokens before adopting it broadly.

Use it if

  • You need a compact avatar that can fall back from a photo to initials.
  • Your interface already uses the same light neumorphic surface and can accept its fixed palette.
  • You want an optional presence dot and are prepared to correct its accessibility markup.

Skip it if

  • You need an accessible status announcement without modifying the component, because the current ARIA markup is invalid.
  • Your design system requires theme tokens, dark mode, or flexible color variants instead of embedded colors.
  • You need image loading states, error fallback behavior, or a semantic profile link built in.

Install

Installation record for neu-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. Add the component to a React project and ensure Tailwind scans its file so the utility classes and arbitrary shadow styles are generated. No shadcn setup, provider, or extra package is required. Adjust the status markup to expose its label through a permitted semantic pattern.

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.