Images Badge, animated React component
A pill of overlapping avatars that fans open along a gentle arc on hover or focus, each face springing into place a beat after the last while the +N count rolls down. A name tag glides from face to face under the pointer or the arrow keys, and faces without a picture show initials.
- Free
- Motion Effects
- Hover
- Spring
Like Images Badge? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Images Badge stays free.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| images | BadgeImage[] | 7 people | People in the stack, front first: { src?, alt, color? }. Without src the face shows initials. |
| maxVisible | number | 3 | How many show while the stack is closed. |
| revealCount | number | 2 | How many more fan out when it opens. The rest are counted in the +N chip. |
| label | string | — | Text after the stack. |
| size | "sm" | "md" | "lg" | "md" | Face size and pill height. |
| shape | "circle" | "rounded" | "square" | "circle" | Shape of each face. |
| autoplay | boolean | false | Opens the stack and walks the name tag along it until someone hovers or focuses it. |
| onClick | () => void | — | Makes the whole badge a button. |
| className | string | — | Extra classes on the pill. |
| imageClassName | string | — | Extra classes on every face. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry
Run this once per project. It writes the Nexus UI entry into
components.jsonfor you:npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"Type it exactly as shown.
{name}is filled in by the CLI with the component you ask for, so you never replace it.
- 3
Add the component
Run this from your project root. It adds the component, the helpers it imports and its npm packages.
npx shadcn@latest add @nexus-labs/images-badge
- 4
Check what was added
With a project made as in the Quick Start (a
src/folder), these files land in it:components/images-badge/images-badge.tsxindex.ts - 5
Copying by hand? Skip the registry
Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that
cn()exists. Install the packages:npm install framer-motion
Then show the source and create each file at the path it gives:
- 6
Use it in a page
Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:
// src/app/page.tsx import { ImagesBadge } from "@/components/images-badge"; export default function Page() { return ( <main> <ImagesBadge /> </main> ); }
Like Images Badge? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Images Badge stays free.
About Images Badge
The Images Badge renders a compact overlapping avatar group with a spring entrance animation. Avatars stack with slight offsets and fan out slightly on hover using Framer Motion spring physics. Display count is configurable and overflows into a "+N more" label. Use it as a social proof element to display team size, active user counts, or collaboration participant counts. A compact, high-impact social signal for SaaS landing pages.
Good for
- Team and collaborator count indicators
- Active user and customer count badges
- Social proof elements
- Collaboration feature highlights
Images Badge questions
How do I install the images badge?
Run `npx shadcn@latest add @nexus-labs/images-badge`. It adds the ImagesBadge component and installs framer-motion.
How many images does it show?
`maxVisible` (default 3) sets how many are visible when collapsed and `revealCount` (default 2) how many more appear on hover. Any images beyond that are summarized in a "+N" chip.
Can the badge be clickable?
Yes. Pass `onClick` and the badge gets a button role, becomes focusable, and responds to Enter and Space.
Which sizes and shapes are available?
`size` takes "sm", "md" or "lg" and `shape` takes "circle", "rounded" or "square". `label` adds text after the stack, and dark mode is handled with Tailwind `dark:` classes.