A list or grid people reorder by dragging a handle, by touch or by keyboard, with announcements (dnd-kit).
Sortable waypoints
Install
npx shadcn add @syncrobotic/sortable Also installs: @dnd-kit/core, @dnd-kit/sortable, @dnd-kit/utilities, lucide-react, @syncrobotic/cn
Overview
A reorderable list or grid with a grip on each item, usable with a mouse, a finger or the keyboard.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Sortable with overlay
Sortable priorities
Sortable grid
Sortable compact
Sortable files
Sortable removable
Sortable dashboard
Sortable columns with visibility
Sortable long list
Sortable queue
Sortable chips
Usage rules
- Only the handle drags; the rest of the row stays clickable.
- Give getLabel so moves are announced by name.
- Keyboard: Space to lift, arrows to move, Space to drop, Escape to cancel.
Changelog
- 0.23.02026-11-20Every word it says can be translated without editing the source:
labels(SortableLabels): every drag announcement and the keyboard instructions. - 0.13.12026-11-19The drag overlay renders on <body>, so it stays under the pointer and drops back to the right place inside a transformed container (an entrance animation, a sheet). Without
renderOverlaythe item itself follows the pointer, lifted, instead of fading and staying put. - 0.10.02026-11-18The handle uses radius 4 (radius-2xs) inside its row.