Timace

Avatar

components/ui/avatar.tsx
import type { ComponentProps, ReactNode } from "react";

const join = (...classes: (string | undefined)[]) => classes.filter(Boolean).join(" ");

// The ring is in the colour of what the avatar sits on, so one that overlaps another looks cut out of it.
const base =
  "relative inline-flex shrink-0 items-center justify-center rounded-(--tui-avatar-radius) bg-(--tui-avatar-bg) font-(family-name:--tui-font) leading-none font-(--tui-avatar-font-weight) text-(--tui-avatar-fg) select-none [box-shadow:0_0_0_var(--tui-avatar-ring-width)_var(--tui-avatar-ring)]";

const sizes = {
  sm: "size-[calc(var(--tui-avatar-size)_-_10px)] text-[length:calc(var(--tui-avatar-font-size)_-_2px)]",
  md: "size-(--tui-avatar-size) text-(length:--tui-avatar-font-size)",
  lg: "size-[calc(var(--tui-avatar-size)_+_14px)] text-[length:calc(var(--tui-avatar-font-size)_+_3px)]",
};

const statuses = {
  online: "bg-(--tui-avatar-online)",
  away: "bg-(--tui-avatar-away)",
  off: "bg-(--tui-avatar-off)",
};

export interface AvatarProps extends Omit<ComponentProps<"span">, "children"> {
  /** An image address. Without one the children show, usually initials. */
  src?: string;
  /** Who it is. Read out in place of the image or the initials. */
  alt: string;
  size?: keyof typeof sizes;
  /** A dot at the corner for whether they are around. */
  status?: keyof typeof statuses;
  children?: ReactNode;
}

export function Avatar({ src, alt, size = "md", status, className, children, ...props }: AvatarProps) {
  return (
    <span data-slot="avatar" {...props} role="img" aria-label={status ? `${alt}, ${status === "off" ? "offline" : status}` : alt} className={join(base, sizes[size], className)}>
      {src ? <img src={src} alt="" className="size-full rounded-[inherit] object-cover" /> : <span aria-hidden>{children}</span>}
      {status && (
        <span
          aria-hidden
          data-slot="avatar-status"
          className={`absolute right-0 bottom-0 z-10 size-(--tui-avatar-status-size) rounded-full [box-shadow:0_0_0_var(--tui-avatar-ring-width)_var(--tui-avatar-ring)] ${statuses[status]}`}
        />
      )}
    </span>
  );
}

/** Avatars in a row, each overlapping the one before. */
export function AvatarGroup({ className, ...props }: ComponentProps<"div">) {
  return <div {...props} className={join("flex items-center *:not-first:ml-[calc(var(--tui-avatar-overlap)_*_-1)]", className)} />;
}
styles/timace-ui.css
:root {
  color-scheme: light;
  --tui-bg: #ffffff;
  --tui-fg: #0a0a0a;
  --tui-muted: #f5f5f5;
  --tui-muted-fg: #737373;
  --tui-border: #e5e5e5;
  --tui-primary: #171717;
  --tui-primary-fg: #fafafa;
  --tui-ring: #a3a3a3;
  --tui-success: #16a34a;
  --tui-warning: #d97706;
  --tui-danger: #dc2626;
  --tui-radius: 8px;
  --tui-border-width: 1px;
  --tui-space: 4px;
  --tui-shadow: none;
  --tui-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
  --tui-text: 14px;
  --tui-duration: 150ms;

  /* Avatar */
  --tui-avatar-size: calc(var(--tui-space) * 11);
  --tui-avatar-overlap: calc(var(--tui-space) * 2);
  --tui-avatar-status-size: 11px;
  --tui-avatar-radius: calc(var(--tui-radius) * 6);
  --tui-avatar-ring-width: 3px;
  --tui-avatar-font-size: var(--tui-text);
  --tui-avatar-font-weight: 600;
  --tui-avatar-bg: light-dark(color-mix(in oklab, var(--tui-bg) 91%, var(--tui-fg)), color-mix(in oklab, var(--tui-bg) 78%, var(--tui-fg)));
  --tui-avatar-fg: var(--tui-fg);
  --tui-avatar-ring: light-dark(var(--tui-bg), color-mix(in oklab, var(--tui-bg) 90%, var(--tui-fg)));
  --tui-avatar-online: var(--tui-success);
  --tui-avatar-away: var(--tui-warning);
  --tui-avatar-off: var(--tui-muted-fg);
}

.dark,
[data-theme="dark"] {
  color-scheme: dark;
  --tui-bg: #0a0a0a;
  --tui-fg: #fafafa;
  --tui-muted: #1c1c1c;
  --tui-muted-fg: #a3a3a3;
  --tui-border: #2a2a2a;
  --tui-primary: #fafafa;
  --tui-primary-fg: #171717;
  --tui-ring: #737373;
  --tui-success: #22c55e;
  --tui-warning: #f59e0b;
  --tui-danger: #ef4444;
}

Needs Tailwind CSS v4. Import the stylesheet once, after Tailwind.