Skip to content
Design System
GitHub

Sortable

v0.23.0Beta

A list or grid people reorder by dragging a handle, by touch or by keyboard, with announcements (dnd-kit).

Patrol order
  • 1Dock Astart
  • 2North gate30 s
  • 3Parking lot1 min
  • 4Loading dock45 s
  • 5Hall B entrance30 s

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.

When to use

  • Waypoint and patrol order.
  • Rule priorities.
  • Column order, camera layout, playlist steps.

Use something else

  • Ordering by a value (date, name): sort a Table or Data grid.
  • Moving items between lists: compose dnd-kit directly.

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

  • Dock A
  • North gate
  • Parking lot
  • Loading dock

Sortable with overlay

When rules conflict, the higher one wins
Emergency stopAlways first, always on

Sortable priorities

  • Front
  • Rear
  • Left
  • Right
  • Thermal
  • Arm

Sortable grid

Column order
  • Robot
  • Status
  • Battery
  • Site
  • Last seen

Sortable compact

  • intro.mp4Step 1
  • hall-b-walkthrough.mp4Step 2
  • safety-briefing.pdfStep 3

Sortable files

  • 1.Dock A
  • 2.North gate
  • 3.Parking lot
  • 4.Loading dock
  • 5.Hall B entrance

Sortable removable

  • Fleet status
  • Open alarms
  • Battery
  • Patrols today

Sortable dashboard

Sortable columns with visibility

  • Waypoint 1
  • Waypoint 2
  • Waypoint 3
  • Waypoint 4
  • Waypoint 5
  • Waypoint 6
  • Waypoint 7
  • Waypoint 8
  • Waypoint 9
  • Waypoint 10
  • Waypoint 11
  • Waypoint 12
  • Waypoint 13
  • Waypoint 14

Sortable long list

  • Inventory scan · aisle 1–12done by +24 min
  • Deliver to floor 3done by +32 min
  • Night patrol · northdone by +77 min
Total 77 min

Sortable queue

  • 1People
  • 2Forklifts
  • 3Doors
  • 4Spills
  • 5Boxes

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 renderOverlay the 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.

How to upgrade