Skip to content
RevoGrid [Pro]

Work in Progress Limits

Work in progress (WIP) is the number of cards currently in a workflow stage. A limit helps avoid starting more work than a team can finish.

Interactive example

Limit work in progress

In progress allows one task and already contains Build onboarding.

Try it: Try moving research into In progress. Finish onboarding, then try again.

Loading example…

What to notice: The full column blocks the first move and accepts it after a slot is free.

TypeScript source

Install the packages from Getting Started, then use this source in your app.

board-actions.ts
import type { KanbanPlugin, KanbanConfig } from '@revolist/kanban';
import type { WorkCard } from './first-board';


export function moveResearch(kanban: KanbanPlugin<WorkCard>, columnProp: string) {
  return kanban.moveCards(['task-1'], { columnProp });
}
export function moveResearchToPlatform(kanban: KanbanPlugin<WorkCard>) {
  return kanban.moveCards(['task-1'], { columnProp: 'todo', swimlaneId: 'platform' });
}
export function selectTodoCards(kanban: KanbanPlugin<WorkCard>) {
  kanban.setSelectedCardIds(kanban.getCards().filter(card => card.status === 'todo').map(card => card.id));
}
export const workInProgress: Partial<KanbanConfig<WorkCard>> = {
  columns: [{ prop: 'todo', name: 'To do' }, { prop: 'doing', name: 'In progress', wipLimit: 1 }, { prop: 'done', name: 'Done' }],
  wipBehavior: 'block',
};
export const startBeforeDone: Partial<KanbanConfig<WorkCard>> = {
  rules: { canDrop: ({ cards, targetColumn }) => targetColumn.prop === 'done' && cards.some(card => card.status === 'todo') ? 'Start the task before marking it done.' : true },
};
export function frenchBoard(config: KanbanConfig<WorkCard>): KanbanConfig<WorkCard> {
  return { ...config, locale: 'fr-FR', columns: config.columns?.map(column => ({ ...column, name: ({ todo: 'À faire', doing: 'En cours', done: 'Terminé' } as Record<string, string>)[String(column.prop)] ?? column.name })), labels: { ...config.labels, emptyColumn: 'Aucune carte', dropCardHere: 'Déposer une carte ici', moveCancelled: 'Déplacement annulé', editCard: 'Modifier la carte', deleteCard: 'Supprimer la carte' } };
}
Download board-actions.ts

Try it: choose Move research to In progress: the full column blocks the move. Choose Finish onboarding, then try moving research again. The freed slot now accepts it.

Start with Your First Board; config is its existing configuration.

grid.kanban = {
  ...config,
  columns: [
    { prop: 'todo', name: 'To do' },
    { prop: 'doing', name: 'In progress', wipLimit: 1 },
    { prop: 'done', name: 'Done' },
  ],
  wipBehavior: 'block',
};

WIP behavior

Section titled “WIP behavior”

Set a column wipLimit, or a lane wipLimits entry for a more specific bucket limit. wipBehavior defaults to warn:

  • warn permits the move and renders/announces the over-limit state.
  • block rejects the entire proposed move.

Multi-card moves validate the final batch count, not each card independently. A failed card or capacity check cancels the full move.

Counts

Section titled “Counts”

Column and swimlane headers distinguish:

  • visible count: cards passing RevoGrid filters, Kanban search, and the optional predicate;
  • total count: all canonical cards in that bucket.

WIP limits always use total counts so a filter cannot accidentally permit over-capacity work.

In append mode, both counts describe the cards loaded so far. In indexed mode, known placeholder positions participate in total and visible counts, so loading a page does not change an unfiltered header count. Placeholders remain non-interactive, and active filters can exclude positions that cannot match. Enforce server-side rules in the application whenever Kanban does not have the authoritative records needed for the decision.

Limits with server-side pages

Section titled “Limits with server-side pages”

A partial board cannot know cards that have not loaded. In append mode, local counts and WIP checks describe loaded cards. Indexed placeholders can reserve known positions, but the server must still enforce full-board capacity and concurrent changes atomically. See load pages and save changes.

Next steps

Section titled “Next steps”

Continue with move rules and filtering. See the Kanban API for exact types and signatures.