KanbanBoard

Planned · 2

Review componentsMove to
Publish release notesMove to

Done · 1

Design tokensMove to

Usage

import { KanbanBoard } from "@devvy-ui/react";

<KanbanBoard label="Project board" columns={columns} items={cards} onItemsChange={setCards} />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
columns	{id,label}[]	required	Named workflow columns.
items	KanbanItem[]	required	Controlled cards with columnId.
onItemsChange	(items: KanbanItem[]) => void	required	Updated card collection.
disabled	boolean	false	Disable movement.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add kanban-board

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

KanbanBoard.tsxREACT / TSX

import { forwardRef, useEffect, useRef, useState, type HTMLAttributes } from 'react';
export interface KanbanItem {
  id: string;
  title: string;
  columnId: string;
  description?: string;
}
export interface KanbanBoardProps extends HTMLAttributes<HTMLDivElement> {
  label: string;
  columns: readonly { id: string; label: string }[];
  items: readonly KanbanItem[];
  onItemsChange: (items: KanbanItem[]) => void;
  disabled?: boolean;
}
export const KanbanBoard = forwardRef<HTMLDivElement, KanbanBoardProps>(function KanbanBoard(
  { label, columns, items, onItemsChange, disabled, className, ...props },
  ref,
) {
  const [message, setMessage] = useState(''),
    focusTarget = useRef(''),
    controls = useRef(new Map<string, HTMLSelectElement>());
  useEffect(() => {
    if (focusTarget.current) {
      controls.current.get(focusTarget.current)?.focus();
      focusTarget.current = '';
    }
  }, [items]);
  return (
    <div
      {...props}
      ref={ref}
      role="region"
      aria-label={label}
      className={['dvy-kanban', className].filter(Boolean).join(' ')}
    >
      {columns.map((column) => (
        <section key={column.id} aria-label={column.label}>
          <h3>
            {column.label}
            <span> · {items.filter((item) => item.columnId === column.id).length}</span>
          </h3>
          <ul>
            {items
              .filter((item) => item.columnId === column.id)
              .map((item) => (
                <li key={item.id}>
                  <strong>{item.title}</strong>
                  {item.description && <p>{item.description}</p>}
                  <label>
                    Move to
                    <select
                      disabled={disabled}
                      ref={(node) => {
                        if (node) controls.current.set(item.id, node);
                        else controls.current.delete(item.id);
                      }}
                      aria-label={'Move ' + item.title + ' to column'}
                      value={item.columnId}
                      onChange={(event) => {
                        const next = event.target.value;
                        focusTarget.current = item.id;
                        onItemsChange(
                          items.map((v) => (v.id === item.id ? { ...v, columnId: next } : v)),
                        );
                        setMessage(
                          item.title +
                            ' moved to ' +
                            columns.find((c) => c.id === next)?.label +
                            '.',
                        );
                      }}
                    >
                      {columns.map((choice) => (
                        <option key={choice.id} value={choice.id}>
                          {choice.label}
                        </option>
                      ))}
                    </select>
                  </label>
                </li>
              ))}
          </ul>
          {!items.some((item) => item.columnId === column.id) && <p>No cards yet.</p>}
        </section>
      ))}
      <p role="status" className="dvy-sr-only">
        {message}
      </p>
    </div>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Planned · 2

Done · 1

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.