A sticker for the job
Type to search, click a category, or walk the grid with the arrow keys. The highlighted sticker peels its corner; Enter sticks it.
A popover of stickers to choose from: a search field, category chips and a grid you walk with the arrow keys. Reach for it in a comment box, a reaction bar or a profile editor. The highlighted sticker peels its corner.
npx shadcn@latest add @wobko/sticker-pickerFirst time here? Add the registry to components.json first. How to install
Type to search, click a category, or walk the grid with the arrow keys. The highlighted sticker peels its corner; Enter sticks it.
Offer only the stickers you want, under your own names and words. Here a reaction picker: four to a row, it stays open so you can react more than once (choose one again to take it back), and the latest choice is marked.
The picker as a composer tool: choose a sticker, it waits beside the text (click it to take it off), and posting sends both. Recent stickers come first next time.
A Popover (same open, defaultOpen, onOpenChange, modal) that also holds what the grid needs: the catalog, the recent list and what happens on choosing.
| Prop | Type | Default | Description |
|---|---|---|---|
| onSelect | (sticker: StickerPickerItem) => void | - | Called with { name, label, category, categoryLabel, tags } when one is chosen (Enter, or a tap). |
| value | string | null | - | The sticker chosen elsewhere: it is marked in the grid (aria-selected, and a check). |
| stickers | (string | { name; label?; category?; tags? })[] | - | Offer only these, in this order, under your own labels, categories and search words. Names that have not been drawn are skipped. Default: everything in the art library, grouped by the batch it was drawn in. |
| recent | string[] | - | Ids to show first under "Recent" (in the unfiltered view). Keep them in your own state. |
| closeOnSelect | boolean | true | Close after choosing. Turn off to add several in a row. |
The slip that opens: search field, category chips, the grid, and a caption naming the highlighted sticker. Its body exists only while open, so the search starts fresh every time.
| Prop | Type | Default | Description |
|---|---|---|---|
| columns | number | 5 | Stickers per row (at least 1). |
| size | number | 44 | Drawn size of a sticker in the grid, px. |
| placeholder | string | "Search stickers" | Placeholder of the search field. |
| align / side / … | PopoverContent props | - | Everything PopoverContent takes (stock, pin, tape, arrow, sideOffset). |
The files the CLI copies into your project.
Loading the source