Back to projects
Projectintermediate 8 steps ~100 min

Kanban Board

Build a sprint board with a flat data model, a tested moveCard, keyboard moves with focus restoration and announcements, native drag and drop, WIP limits enforced on every path, and a saved board.

What you'll build

A Kanban board you can use with a mouse, a keyboard, or a screen reader, with WIP limits on every path.

  • React
  • drag and drop
  • keyboard a11y
  • focus management
  • localStorage
Project briefrequirements and design decisions

Requirements

  • Three columns with cards that move between them
  • Add and delete cards
  • Board state survives a refresh

Architecture decisions

  • Flat cards list with a columnId field instead of nested arrays per column
  • Moving a card is a single field update
  • Column order and card order are explicit data, not array position side effects

Stretch goals

  • Accessible drag and drop (keyboard moves too)
  • WIP limits per column
  • Multiple boards

Production checklist

  • Optimistic updates with rollback when syncing to a server
  • Conflict handling for multiple users
  • Keyboard shortcuts with discoverable help

1What we're building

A Kanban board (like Trello, Jira, or Linear) is a list of cards in columns. Building one well touches problems you'll meet in any app that lets people organize things: choosing a data model that makes updates easy, drag and drop, keyboard accessibility for drag and drop, and business rules that every input path must respect.

You'll build a sprint board with:

  • Three columns, with a work-in-progress limit on "In progress"
  • Move cards with buttons, keyboard shortcuts, and drag and drop
  • Add and delete cards
  • Screen reader announcements for every change
  • A board that survives a reload
1board.js pure logic: group, move, drop position, WIP limits 2data.js starting cards 3Board.jsx columns, cards, drag and drop 4storage.js save and load 5App.jsx state, and one move function every input path uses

The key design decision: cards live in one flat array, each with a columnId. Array order is the order within each column. The tempting alternative, { todo: [...], doing: [...] }, makes every move a two-array splice, and makes "find card by id" a search across columns. With a flat list, moving a card is "change one field and position", and anything that needs all cards (search, counts, saving) is trivial.

Kanban Board project | Bloom