Skip to main content

KanbanQuick

Project Management Made Simple

Saved
0 selected

Add New Task

Hold Ctrl/Cmd to select multiple

Keyboard Shortcuts

New Task N
Search F
Toggle View V
Export E
Print P
Help ?

Choose Column Color

Import Format Documentation

JSON schema for board imports

Overview

KanbanQuick uses a JSON format for importing and exporting boards. You can create your own JSON files following this schema to import custom boards, or export your current board to save/share it.

Root Structure

{
  "version": "2.0",
  "exportDate": "2024-12-23T10:00:00.000Z",
  "columns": [...],
  "tasks": {...}
}

Column Schema

Each column in the columns array:

{
  "id": "string",           // Unique identifier (e.g., "backlog", "col-1234567890")
  "title": "string",        // Display name (e.g., "High Priority")
  "color": "string",        // Tailwind color name (e.g., "blue", "emerald", "red")
  "locked": boolean         // Whether column is locked from drag-and-drop
}
Available colors: slate, gray, zinc, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose

Tasks Schema

The tasks object maps column IDs to arrays of tasks:

"tasks": {
  "columnId": [
    {
      "id": "string",                    // Unique task ID (e.g., "t1234567890")
      "title": "string",                 // Task title (required)
      "description": "string",           // Task description (optional)
      "priority": "high|medium|low",     // Priority level (optional, default: "medium")
      "tags": ["string", ...],           // Array of tag strings (optional)
      "dueDate": "YYYY-MM-DD",          // ISO date format (optional)
      "estimatedTime": number,           // Estimated hours (optional)
      "actualTime": number,              // Actual hours tracked (optional)
      "dependencies": ["taskId", ...],   // Array of dependent task IDs (optional)
      "subtasks": [                      // Array of subtasks (optional)
        {
          "text": "string",
          "completed": boolean
        }
      ],
      "comments": [                      // Array of comments (optional)
        {
          "text": "string",
          "timestamp": "ISO 8601 string"
        }
      ]
    }
  ]
}

Example: Minimal Board

{
  "version": "2.0",
  "exportDate": "2024-12-23T10:00:00.000Z",
  "columns": [
    {
      "id": "todo",
      "title": "To Do",
      "color": "blue",
      "locked": false
    },
    {
      "id": "done",
      "title": "Done",
      "color": "green",
      "locked": false
    }
  ],
  "tasks": {
    "todo": [
      {
        "id": "t1",
        "title": "Complete project setup",
        "priority": "high",
        "tags": ["Setup", "Urgent"]
      }
    ],
    "done": []
  }
}

Example: Complete Task

{
  "id": "t123",
  "title": "Build survey analysis tool",
  "description": "Create Python Flask app for analyzing DWP survey data",
  "priority": "high",
  "tags": ["Feature", "Research", "Python"],
  "dueDate": "2024-12-31",
  "estimatedTime": 8,
  "actualTime": 5.5,
  "dependencies": ["t122"],
  "subtasks": [
    {
      "text": "Set up Flask project structure",
      "completed": true
    },
    {
      "text": "Create data processing module",
      "completed": false
    }
  ],
  "comments": [
    {
      "text": "Started initial research on best practices",
      "timestamp": "2024-12-20T09:30:00.000Z"
    }
  ]
}

Tips for Creating Import Files

  • All task IDs and column IDs must be unique
  • Column IDs in the tasks object must match column IDs in the columns array
  • Dependencies should reference valid task IDs that exist in your board
  • Dates should be in YYYY-MM-DD format
  • Export an existing board to see a working example
  • The version field helps ensure compatibility (current version: 2.0)

Column Templates

Choose a template to quickly set up your board