Kanban
ProMove work between stages: columns of cards that people drag with the pointer or move with the arrow keys.
Playground
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Tax calculation for EU VAT
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Installation
Kanban comes with WunderUI Core and Pro, in the package from your plan. See the plans.
Then import what you need:
import {
Kanban,
ColumnHeader,
KanbanCard,
KanbanCardData,
KanbanCardItem,
KanbanCardProps,
KanbanColumn,
KanbanColumnAction,
KanbanColumnHeader,
KanbanColumnHeaderProps,
KanbanColumnStatus,
KanbanIndicator,
KanbanLayout,
} from "@wunderui/react"Then use it:
import { Kanban, type KanbanColumn } from "@/components/ui/kanban"
const COLUMNS: KanbanColumn[] = [
{ id: "todo", title: "To do", cards: [{ id: "k1", title: "Design onboarding flow", tag: { label: "Design", color: "purple" } }] },
{ id: "done", title: "Done", cards: [{ id: "k2", title: "Ship the area chart", tag: { label: "Shipped", color: "green" } }] },
]
export function Board() {
return <Kanban columns={COLUMNS} />
}Expected result: You see two columns, To do and Done, each with one card and a count of 1. Drag a card to the other column, or Tab to a card, press Space, then ArrowRight and Space.
When to use
Use Kanban for
- Tasks, deals or tickets that move through stages
- A roadmap whose cards carry a progress value
- A board that has to work with the keyboard as well as the pointer
Use something else for
- Data Table for many items that people sort, filter or edit field by field
- List Group for one list of similar rows with no stages
- Item Card for a single object on its own row, with one action
Card types
Every card can carry tags, a due date, comments, a checklist and people. On top of that a card shows a picture, a progress bar or an icon tile, so the kind of work reads at a glance.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Layout
Board puts the columns side by side and scrolls sideways; Framed joins them in one frame. Stacked puts them under each other, for narrow places.
Address autocomplete for the shipping form
Apple Pay and Google Pay buttons
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form
Apple Pay and Google Pay buttons
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Address autocomplete for the shipping form
Apple Pay and Google Pay buttons
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
Moving cards
Drag any card with the pointer, or use the arrow keys to pick it up, move it and drop it. The board is one tab stop, so no move needs a mouse.
Address autocomplete for the shipping form

Redesign the product grid
Apple Pay and Google Pay buttons
Fix the double submit on slow networks
Copy review for the error messages
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
- TabGo to the board. Its first card takes focus.
- ↑↓←→Move focus from card to card.
- SpacePick up the focused card.
- ↑↓←→Move it inside its column or to the next one.
- SpaceDrop it. Esc puts it back.
AnnouncedPick up a card to hear the first message.
- Drag a card onto a column to drop it at the end of that column.
- Drop it onto another card to put it in that card's place.
- A dashed Drop here slot shows where the card will land, and the column takes a dark grey rim.
- Release outside every column and the card stays where it was.
Card
KanbanCard is the card of the board outside a board: for a task list, a search result or a detail view. It takes the content of a board card, tags, a due date, comments, a checklist and people, plus a picture, a progress bar or an icon tile. With onClick it is a button, and selected draws the indigo rim. It replaces KanbanCardItem.
Redesign the onboarding checklist
Press the card, or focus it and press Enter or Space.

Redesign the product grid
Press the card, or focus it and press Enter or Space.
Apple Pay and Google Pay buttons
Press the card, or focus it and press Enter or Space.
Fix the double submit on slow networks
Press the card, or focus it and press Enter or Space.
Column header
KanbanColumnHeader is the top of a column on its own: a coloured dot, the title, a count badge, and the buttons to add a card (onAdd) or open the menu (onMenu). It is 40 px high with or without buttons, so the cards of neighbouring columns start on one line. It replaces ColumnHeader.
Keyboard interactions
The board is one tab stop: Tab reaches the card that had focus last, or the first card, and the arrow keys do the rest. Space or Enter picks a card up and drops it.
- TaborShift+Tab
- Moves focus into the board, to the card that had focus last or to the first card, and out of it again. The other cards are not tab stops.
- ArrowUporArrowDown
- Moves focus to the card above or below in the same column. At the first or last card nothing happens.
- ArrowLeftorArrowRight
- Moves focus to the card at the same row in the next column to the left or right. Empty columns are skipped, and a shorter column gives its last card.
- SpaceorEnter
- Picks up the focused card. The card lifts and its focus ring stays on it. Press either key again to drop it where it is shown, which calls once. Dropping a card where it started changes nothing.
- ArrowUporArrowDown
- While a card is held: moves it up or down inside its column. It stops at the first and last place.
- ArrowLeftorArrowRight
- While a card is held: moves it to the next column on that side, to the same row or to the end of a shorter column.
- Escape
- Puts the held card back where it started and announces it. It does not close a dialog the board sits in.
A board wider than its container takes a tab stop of its own first, so the arrow keys can scroll it. Tab or a click elsewhere while a card is held cancels the move.
Behavior and motion
What the board does with state, content, the DOM and motion.
- Controlled or not
- With a change handler the board is controlled: it shows the columns you pass and reports the new columns after each drop. Without one it keeps its own copy and ignores new columns.
- Pointer
- Cards use the browser's native drag and drop. A dashed Drop here slot follows the pointer: over the upper half of a card it sits above it, over the lower half below it. Dropping puts the card there; releasing outside every column does nothing.
- Keyboard
- The keyboard move is previewed on the board while the card is held and reported once, at the drop. Losing focus or moving focus to another card cancels the move.
- Announcements
- A polite live region reads each step: picked up with column and position, the new place after every move, dropped, or move cancelled. Cards describe themselves as sortable items.
- Empty columns
- A column without cards shows its title, a count of 0 and a dashed box that says it is empty, and takes a drop at its start.
- Layouts and scrolling
- Board scrolls sideways when the columns are wider than the container and then takes focus for the arrow keys; framed does the same in a frame. On a narrow screen a column takes the board's width. Stacked makes every column full width.
- Height
- Each column is as tall as its cards; pass in to keep shorter columns short, or give the board a fixed height to keep the page still while cards move.
- Limits and status strips
- A column with counts against it; when it is full the count turns yellow, a warning strip appears and Add item is disabled. Cards can still be moved into it. A strip shows your own message, with Retry or Undo as a plain button; a new strip is announced in the live region.
- Motion and reduced motion
- Fill, rim and shadow change with a short colour transition. The picked-up lift is set at once because the keyboard drives it, and nothing moves along a path, so reduced motion needs no fallback.
Anatomy
The parts a board is made of, numbered in the figure. The figure shows the framed layout so the outline of the board is visible.
Dark mode for charts
Data table filters
Press Space or Enter to pick up the card. Then use the arrow keys to move it within its column or to the next column, Space or Enter to drop it, and Escape to cancel.
- 1
The board, drawn from your columns: a row that scrolls sideways, columns sharing one 16 px frame, or columns stacked. Cards move by drag or keyboard, and every move is reported.
- 2
One stage, 352 px wide (the board's width on a narrower screen), in the page tone with a 1 px rim, 12 px padding and 12 px corners. While a card is dragged over it the rim turns dark grey and a dashed Drop here slot marks where the card lands. An empty column shows a dashed box and still takes a drop.
- 3
The column title in 14 px semibold, the card count as a grey pill badge ("2 / 3" against a limit, yellow when the column is full) and, with column actions, a … button that opens the column menu.
- Optional
A strip under the header from the column's : a warning, a failed save with Retry or a done move with Undo, in the tint of its tone. A full column without its own status shows the limit warning. A new strip is read out once.
- Optional
A plain button at the end of every column, drawn with . It is disabled while the column is at its limit.
- 4
One draggable item with a button role, a 12 px radius and 12 px padding, and a grip in the top right corner. It has hover, pressed and focus looks, and a picked-up look with a small lift. A card can also show a picture or an icon tile.
- 5
The card title in 14 px medium, next to the icon tile when there is one. It wraps onto more lines when it is long.
- 6Optional
A bar with its percentage under the title, drawn when the card has a progress value from 0 to 100. It is named after the card title for assistive technology.
- 7Optional
Light Badges in pill shape, from (or the older single ), in the Badge colours you choose.
- 8Optional
The footer: due date, comments and checklist with 12 px icons in 11 px tertiary text, and the people on the right as a small avatar stack.
- Optional
A hidden live region that reads out each pick-up, move, drop and cancel with the column title and position. It is not in the figure.
- data-slot="kanban-column"Optional
- data-slot="kanban-column-header"Optional
- data-slot="kanban-column-indicator"Optional
- data-slot="kanban-column-meta"Optional
- data-slot="kanban-column-empty"Optional
- data-slot="kanban-drop-placeholder"
- data-slot="kanban-column-status"
- data-slot="kanban-card"Optional
The task card of the board on its own, with the content of a board card: tags, a due date, comments, checklist progress and people, plus a picture, a progress bar or an icon tile. With it is a button, and draws the indigo rim. It replaces KanbanCardItem.
- data-slot="kanban-header"Optional
The top of a column on its own: a coloured dot, the title, a count badge and the buttons to add a card and open the menu. It is 40 px high with or without buttons. It replaces ColumnHeader.
- Optional
- Optional
Best practices
- Do
Pass the columns change handler and store the result. Without it the board keeps its own copy: moves aren't reported and a new columns value is ignored.
- Do
Give columns short, distinct titles. Screen readers hear them with every move, for example column Done, position 2 of 4.
- Do
Give the board a height when other things sit around it. A board is as tall as its tallest column, so it changes height as cards move.
- Do
Switch to the stacked layout on narrow screens. The board layout scrolls sideways, and columns past the edge are easy to miss.
- Do
Offer another way to move a card on touch screens, such as a menu on your own card. Dragging uses the browser's native drag and drop, which many touch browsers don't start with a finger.
- Don’t
Don't add your own key or drag handlers to the cards. Space or Enter picks a card up, the arrow keys move it, and Escape puts it back.
- Do
Keep the column title the stage name: the total goes into meta and the stage colour into indicator.
API reference
Kanban renders a div and takes only the props below. A column has an id, title and cards; a card has an id, title and optional tag, meta and progress. KanbanCard and KanbanColumnHeader are the same parts the board draws, for use outside a board. Their types are `KanbanColumn` and `KanbanCardData` (the older type name `KanbanCard` still works).
The board, drawn from your columns: a row that scrolls sideways, columns sharing one 16 px frame, or columns stacked. Cards move by drag or keyboard, and every move is reported.
| Prop | Type | Default | Description |
|---|---|---|---|
| columns required | KanbanColumn[] | — | The columns and their cards. A column is : is a work-in-progress limit, is with tone warning, error or success. A card is plus any of , , , , , (0 to 100), (), with , and the older and . Every must be unique on the board. Without this is only the starting state. |
| onColumnsChange | (columns: KanbanColumn[]) => void | — | Called with the new columns after a drop, from the pointer or the keyboard. Passing it makes the board controlled: store the result and pass it back as . |
| onAddCard | (columnId: string) => void | — | Draws Add item at the end of every column and is called with the column's id. Add the card to your columns yourself. |
| columnActions | { label: string; onSelect: (columnId: string) => void }[] | — | Entries of the column menu behind the … button in each column header. Without them the button is not drawn. |
| layout | "board" | "stacked" | "framed" | "board" | puts grey columns side by side and scrolls sideways. joins them in one frame with a line between them. puts them under each other at full width. |
| className | string | — | Classes for the board, for example a fixed height such as or a width such as . |
The task card of the board on its own, with the content of a board card: tags, a due date, comments, checklist progress and people, plus a picture, a progress bar or an icon tile. With it is a button, and draws the indigo rim. It replaces KanbanCardItem.
| Prop | Type | Default | Description |
|---|---|---|---|
| title required | ReactNode | — | The task name. Required. |
| labels | { label: ReactNode; color?: BadgeColor }[] | — | Tags above the title, each a label and a badge colour. |
| due | ReactNode | — | The due date in the footer, with a calendar icon. |
| comments | number | — | The number of comments in the footer. Hidden at 0. |
| checklist | { done: number; total: number } | — | Checklist progress as , shown in the footer. |
| assignees | Person[] | — | The people on the task, shown as a stack of avatars at the end of the footer. |
| image | { src: string; alt: string } | — | A picture at the top of the card as . Pass for a decorative one. |
| progress | number | — | 0 to 100: a progress bar with its percentage under the title. |
| icon | ReactNode | — | An icon in a 32 px tint tile left of the title. |
| iconColor | "indigo" | "blue" | "purple" | "pink" | "red" | "orange" | "yellow" | "green" | "alternative" | — | The hue of the icon tile. Indigo by default. |
| meta | ReactNode | — | Free text at the start of the footer, such as a date without an icon. |
| selected | boolean | — | Draws the indigo rim. A card that is given and is a toggle button. |
| onClick | () => void | — | Makes the card a button with hover and pressed fills, and runs on Enter and Space. |
| className | string | — | Extra classes on the card, such as its width. |
| progressLabel | string | — | Name of the progress bar for assistive technology. Default: the title when it is a string. |
| showHandle | boolean | — | A grip in the top right corner. Decorative: the whole card is the drag target. |
The top of a column on its own: a coloured dot, the title, a count badge and the buttons to add a card and open the menu. It is 40 px high with or without buttons. It replaces ColumnHeader.
| Prop | Type | Default | Description |
|---|---|---|---|
| title required | ReactNode | — | The column name. Required. |
| count | ReactNode | — | The number of cards, or a text such as when the column has a limit. |
| dotClassName | string | "bg-muted-foreground" | A background class for the dot, such as . Muted by default. |
| onAdd | () => void | — | Shows the add button, named Add card, and runs when it is pressed. |
| onMenu | () => void | — | Shows the menu button, named Column menu, and runs when it is pressed. |
| className | string | — | Extra classes on the header. |
| Prop | Type | Default | Description |
|---|---|---|---|
| title required | ReactNode | — | |
| count | ReactNode | — | Card count, or e.g. "3 / 3" when the column has a WIP limit. |
| dotClassName | string | — | Dot colour — any Tailwind bg class, defaults to muted. |
| onAdd | () => void | — | |
| onMenu | () => void | — |
| Prop | Type | Default | Description |
|---|---|---|---|
| title required | ReactNode | — | |
| assignees | Person[] | — | |
| checklist | { done: number; total: number } | — | |
| comments | number | — | |
| due | ReactNode | — | |
| icon | ReactNode | — | An icon in a 32 px tint tile left of the title. |
| iconColor | "indigo" | "blue" | "purple" | "pink" | "red" | "orange" | "yellow" | "green" | "alternative" | — | Hue of the icon tile. Default indigo. |
| image | { src: string; alt: string } | — | A picture at the top of the card. says what it shows; pass for a purely decorative one. |
| labels | { label: ReactNode; color?: BadgeColor }[] | — | |
| meta | ReactNode | — | Free text at the start of the footer, e.g. a date without an icon (the board's older ). |
| onClick | () => void | — | |
| progress | number | — | 0 to 100: a progress bar with its percentage under the title. |
| progressLabel | string | — | Name of the progress bar for assistive technology. Default: the title when it is a string. |
| selected | boolean | — | |
| showHandle | boolean | — | A grip in the top right corner. Decorative: the whole card is the drag target. |
Notes for AI
Give your coding assistant the Markdown reference instead of screenshots.
get_component("kanban")The full library index for assistants is at /llms.txt.
Related components
- 14 rows
INV-2001 Nora Lindgren Paid Pro $299 INV-2002 Daniel Okafor Pending Core $398 INV-2003 Priya Raman Paid Core $597 INV-2004 Tomás Ferreira Overdue Pro $299 INV-2005 Maya Kessler Paid Core $398 0 of 14 rows selectedRows per pageData & Tables11 stylesProData TableA data table on TanStack Table: sort on several columns, filter from the column definitions, select rows with a floating action bar, expand, pin, resize columns, page and export to CSV, and show rows as cards on small screens, with controlled state for server-side data. - 3
Team
- NLNora LindgrenOwnerOwner
- DODaniel OkaforEngineeringAdmin
- PRPriya RamanDesignMember
Data & Tables8 stylesProList GroupA 400 px card of list rows with an optional header — sixteen ready patterns: basic, icon, avatar, brand, metric, selectable, toggle, sortable, expandable, grouped, ranking, comparison, tree, action, discussion and master–detail.