Avatar · people
Initials on colours drawn from the name, images that fade in and fall back gracefully, status, badges and rings — and groups that spread on hover and list the rest.
Sizes · shapes · soft
Images · fallbacks
an image fades in when loaded · a broken one falls back to initials · no name: an icon
Status · badge · ring · clickable
Groups · hover to spread · “+N” lists the rest
With a name
Ada LovelaceEngineering lead
Linus TorvaldsKernel
Grace HopperCompilers
Alan TuringResearch
Usage
import { Avatar, AvatarGroup, AvatarLabel } from "./components/avatar.js"; Avatar({ name: "Ada Lovelace" }) // initials on a gradient from the nameAvatar({ name: "Octocat", src: "/octocat.png" }) // fades in; a broken image → initialsAvatar({ name: "Grace", size: "lg", shape: "rounded", variant: "soft" }) // status (online · away · busy · offline), a badge, a ring, clickableAvatar({ name: "Ada", status: "online", pulse: true })Avatar({ name: "Margaret", badge: 3, ring: true, onClick: openProfile }) // groups: hover spreads them; "+N" opens a list of the restAvatarGroup({ items: [{ name, src, status }, …], max: 4 })AvatarGroup({ names: ["Ada", "Linus", "Grace"], size: "sm", spacing: "tight", total: 42 }) AvatarLabel({ name: "Ada Lovelace", description: "Engineering lead", status: "online" })