> ## Documentation Index
> Fetch the complete documentation index at: https://docs.8space.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Kanban Board

> Visualize workflow stages and move tasks across columns with drag-and-drop cards

The Kanban Board view provides a visual workflow representation where tasks appear as cards organized in columns. Each column represents a stage in your workflow, and you can drag cards between columns to update task status as work progresses.

## Understanding the Board Layout

The board displays your workflow columns from left to right, typically:

* **Backlog**: Tasks planned but not yet started
* **To Do**: Ready to be worked on
* **In Progress**: Currently being executed
* **Done**: Completed tasks
* **Custom columns**: Any additional workflow stages you've configured

<Info>
  Workflow columns are configured at the project level and shared across all views. The Board view simply visualizes your existing workflow structure.
</Info>

## Column Headers

Each column header shows:

* **Column name**: The workflow stage name
* **Task count**: Number of tasks currently in that column
* **Definition of Done** (if configured): Acceptance criteria for tasks in this stage

<Tip>
  Definition of Done helps teams maintain quality by clearly stating what "done" means for each stage.
</Tip>

## Task Cards

Each task appears as a card displaying:

* **Title**: The task name
* **Priority badge**: P0, P1, or P2 indicator
* **Assignee**: Display name or "Unassigned"
* **Due date**: Formatted date or "No due"
* **Tags**: Colored labels with tag names (if any)
* **Overdue indicator**: Red warning badge for tasks past their due date

### Overdue Tasks

Tasks that are past their due date and not yet done display a prominent overdue indicator with an alert icon. The entire card gets a red border and ring to draw attention.

<Card title="Overdue Detection" icon="triangle-exclamation">
  A task is considered overdue when:

  * The due date is in the past (before today)
  * AND the task is not marked as complete
</Card>

## Creating Tasks on the Board

Each column has a quick-add form at the top for creating tasks directly in that workflow stage:

<Steps>
  <Step title="Enter task details">
    Type the task title in the input field for the column where you want to create the task.
  </Step>

  <Step title="Set dates">
    Use the date pickers to set the start date and due date. Both fields default to reasonable values (today and tomorrow).
  </Step>

  <Step title="Add the task">
    Press **Enter** or click the **Quick add** button to create the task with P1 priority.
  </Step>
</Steps>

<Note>
  Tasks created on the board are automatically assigned to the column where you created them. You can move them to other columns by dragging afterward.
</Note>

### Date Validation

When creating tasks, the due date must be the same as or later than the start date. If you try to create a task with an invalid date range, you'll see an error message at the top of the board.

## Drag-and-Drop Workflow

Move tasks between workflow stages using drag-and-drop:

<Steps>
  <Step title="Grab a card">
    Click and hold on any task card. The card becomes semi-transparent and follows your cursor.
  </Step>

  <Step title="Drag to target column">
    Move your cursor to the column where you want to move the task. Columns highlight when you drag over them.
  </Step>

  <Step title="Drop to update">
    Release the mouse button to drop the card in the new column. The task's status updates automatically.
  </Step>
</Steps>

<Warning>
  Drag-and-drop is only available to users with **Editor** or **Owner** roles. Viewers can see the board but cannot move cards.
</Warning>

### Column Order

When you drop a task into a column, it's added to the bottom of that column. Tasks within each column maintain their order rank, which you can adjust in the Backlog view.

## Deleting Tasks

Each task card has a delete button (trash icon) that appears in the top-right corner:

1. Click the trash icon on a card
2. Confirm the deletion in the dialog
3. The task is permanently removed from the board

<Warning>
  Deletion is permanent and cannot be undone. Make sure you want to delete the task before confirming.
</Warning>

## Empty Columns

Columns with no tasks display a helpful message: "Drop cards here or add one quickly."

This serves as both an empty state indicator and a reminder that you can drag tasks into empty columns.

## Viewer Mode

If you have **Viewer** role on the project, you'll see a notice at the top: "Viewer role: drag and create are disabled."

In viewer mode:

* You can see all cards and their details
* You cannot drag cards between columns
* You cannot create new tasks
* You cannot delete tasks

<Info>
  Viewer mode is perfect for stakeholders who need visibility without editing capabilities.
</Info>

## Column Layout

The board uses a responsive grid layout that adapts to your screen size:

* **Minimum column width**: 260px
* **Grid adapts** to the number of workflow columns
* **Horizontal scroll** appears when columns exceed viewport width

This ensures all columns remain readable regardless of how many workflow stages you have.

## Best Practices

<CardGroup cols={2}>
  <Card title="Limit WIP" icon="gauge-high">
    Keep the number of tasks in "In Progress" manageable to maintain focus and flow. Consider setting WIP limits on your workflow columns.
  </Card>

  <Card title="Regular Updates" icon="arrows-rotate">
    Move cards across the board as work progresses to keep the board current and useful for the team.
  </Card>

  <Card title="Use Tags" icon="tags">
    Add tags to cards for additional categorization that works alongside your workflow columns.
  </Card>

  <Card title="Watch Overdue" icon="clock">
    Pay attention to overdue indicators and address blocked tasks promptly.
  </Card>
</CardGroup>