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

JavaScript
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" })