Avatar
Freev1.0.0The shadcn Avatar with initials, photos, presence and an agent variant.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { Avatar } from "@/components/ui/notchset/avatar";
export function AvatarExample() {
return (
<Avatar name="Maya Kerr" presence="on" />
);
}Props
name–stringInitials and label come from it.
src–stringA photo; falls back to initials.
size–"s" | "m" | "l"28, 40, 56px.
tone–"ink" | "line" | "soft"Default picked from the name.
kind–"person" | "agent"An agent draws a reticle.
presence–"on" | "away" | "off"The node.
Anatomy
- Same name as shadcn's Avatar, in one part.
- No primitive needed: one file serves both builds.
- Avatar Group builds on its node and tones.
Avatardata-slot="avatar"The avatar.
PresenceNodedata-slot="—"The cut-out node.
Source
components/ui/notchset/avatar.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/avatar.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/avatar.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/avatar.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- lib/beautiful-ui/notchset/calendar.tsx
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- People and agents beside their work
Use something else when
- Logos: use an image
Mistakes to avoid
- Pass a stable name (or tone) so a person keeps their tone
Agents find it by
- avatar, user avatar, profile picture, initials, presence, online status, agent avatar, shadcn avatar, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/avatar.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- —
- Not interactive on its own
Accessibility
- An image labelled with the name and presence
- Wrap in a button for actions; pad small ones to 44px
Motion
- Photo
- Cross-fades in over the initials (200ms)
- Presence
- The node and halo resize (320ms pop)
Responsive
- Fixed sizes.
Performance
- No primitive; the photo loads lazily by the browser.
Changelog
v1.0.0 · 2026-10-02
First release
