Skip to content
Blobz docs

React package

Deterministic generated avatars and complete custom faces for React 19.

@blobz/react renders Blobz avatars locally. It does not call the hosted API, require an account, or consume a request allowance.

import { Avatar } from "@blobz/react";

export function ProfileAvatar() {
  return <Avatar name="Janaki" size={64} />;
}
Blob avatar for janakiBlob avatar for vikramBlob avatar for kalpana

Entry points

ImportExportsUse it for
@blobz/reactAvatar, AvatarProps, AvatarSize, createAvatarDataUriName-generated avatars and optional indexed overrides
@blobz/react/customCustomAvatar, CustomAvatarProps, CustomAvatarValueComplete semantic custom definitions

Which component should I use?

  • Use Avatar for the common “stable seed in, avatar out” flow.
  • Add indexed choice overrides when most features should stay generated but a few must be pinned.
  • Use CustomAvatar for a complete, human-readable face definition.