Quick Start Guide

Create your first board in 5 minutes

Quick Start

This guide walks you from an empty board to a working Kanban setup in under 5 minutes using the Markdown panel.

ℹ️

Note

Before starting: open your board, click the Markdown button, and make sure you are in the Editor tab.

Step 1 — Define your columns

Inside the columns array, add one object per workflow stage. Each needs an id, title, color, and order.

JSON

{
  "version": 1,
  "board": {
    "id": "my-board-001",
    "title": "My First Board"
  },
  "columns": [
    { "id": "todo",  "title": "To Do",  "color": "#64748b", "order": 0 },
    { "id": "doing", "title": "Doing",  "color": "#6366f1", "order": 1 },
    { "id": "done",  "title": "Done",   "color": "#10b981", "order": 2 }
  ],
  "tasks": []
}

A minimal 3-column board with no tasks yet

💡

Tip

Run Dry-run after this step to confirm your columns are valid before adding tasks.

Step 2 — Add tasks

Populate the tasks array. Reference your column ID in each task's columnId field.

JSON

"tasks": [
  {
    "id": "task-001",
    "columnId": "todo",
    "position": 0,
    "title": "Set up project structure",
    "description": "Initialize repo, install dependencies.",
    "priority": "high",
    "tags": ["setup"],
    "assigneeIds": [],
    "mentionMemberIds": [],
    "estimatePoints": 2,
    "dueDate": null,
    "plannedStartAt": null,
    "plannedEndAt": null,
    "timeboxMinutes": null,
    "isCompleted": false,
    "archivedAt": null,
    "checklist": [
      { "title": "Init git repo", "isDone": true },
      { "title": "Add .gitignore", "isDone": false }
    ]
  }
]

First task in the To Do column with a 2-item checklist

Step 3 — Dry-run, then Apply

Click Dry-run — confirm ok: true and review the diff summary
Fix any diagnostics errors if present
Click Apply — your board updates instantly

💡

Next steps

See the full Markdown & JSON Reference for all task fields including assignees, time-boxing, Mermaid diagrams in notes, and archiving.