Components
Ready-to-ship avatar components and blocks powered by @blobz/react and installed through the shadcn CLI.
Blobz components are copied into your application, so their source remains yours to adjust. Each item uses @blobz/react for deterministic avatar rendering and semantic shadcn tokens for the surrounding interface.
Every preview includes the complete code used to render it. Open View code to inspect or copy the example. The Avatar page documents rounded, circle, and square frames as separate examples, with rounded as the default.
Components
| Component | Use it for |
|---|---|
| Avatar | A styled generated avatar with size, frame, and surface variants |
| Avatar Status | Presence indicators such as online, away, busy, and offline |
| Avatar Group | Overlapping teams with an overflow count |
| Avatar Profile | Identity rows with supporting text and actions |
| Avatar Badge | Compact identity, supporting details, and a role badge |
| Avatar Chip | Compact selected users, assignees, and recipients |
| Avatar Social Proof | Avatar stacks paired with community or trust copy |
| Presence Avatar | Online, away, offline, and unread states |
Blocks
| Block | Use it for |
|---|---|
| Avatar Account Menu | Account navigation behind an avatar trigger |
| Avatar Select | A person selector with avatars in the trigger and options |
| Avatar Team List | Responsive rosters with roles, statuses, and actions |
| Group Chat | Conversation threads with participant avatars and typing presence |
| User Table | People tables with roles, statuses, and activity |
Register the Blobz registry
Until @blobz is listed in shadcn's registry index, run this once in each project that uses Blobz components. The command saves the registry URL in your project's components.json.
npx shadcn@latest registry add @blobz=https://blobz.lirena.in/r/{name}.jsonThen install any component by its @blobz name. For example:
npx shadcn@latest add @blobz/avatarThe registry setup is per project. You only need to run it once before installing your first Blobz component.