DocumentationMasked Avatars

Masked Avatars

A stunning avatar stack with masked overlapping effects and animated text rings on hover. Each avatar reveals the person’s name in a circular pattern when hovered.

  • Garou
  • Johan
  • Light Yagami
  • Vegeta
  • Light Yagami

Install using CLI

npx shadcn@latest add "https://obsidianui.dev/r/masked-avatars.json"

Install Manually

1

Install dependencies

npm install framer-motion clsx tailwind-merge
2

Copy the source code

Copy into components/ui/masked-avatars.tsx

Note: This is a complex component with 200+ lines. Install via CLI for the full source code.

Props

Prop NameTypeDefaultDescription
avatarsAvatar[][...defaults]Array of avatars with avatar URL and name
sizenumber70Base size of each avatar
bordernumber8Border width
columnnumber40Column spacing
movementnumber0.72Hover lift sensitivity
transitionnumber0.18Animation duration
ringedbooleantrueShow text ring on hover
blurOnRestbooleantrueBlur non-hovered avatars
classNamestring-Additional CSS classes