Skip to main content

Overview

Every Tesslate Studio project includes a built-in Kanban board for tracking features, bugs, and tasks. The board is stored in the database and fully integrated with the project workspace, so you can manage your workflow without leaving the editor.

Visual Workflow

Drag-and-drop task management with customizable columns

AI Integration

Create tasks from AI agent conversations automatically

Per-Project Boards

Each project has its own dedicated board with independent columns and tasks

Rich Task Metadata

Priority levels, task types, assignees, due dates, and tags

Board Structure

Each project has one KanbanBoard with customizable KanbanColumn entries. By default, boards are created with four columns, but you can add, remove, or rename columns to fit your workflow.
Ideas and future workThe backlog column (marked with is_backlog = true) is for:
  • Feature ideas and brainstorms
  • Future enhancements
  • Low-priority items
  • Unplanned work
Tasks here are not yet scheduled for development.

Creating Tasks

1

Open the Kanban Board

Click the Kanban icon in the project toolbar, or use the keyboard shortcut if configured.
2

Add a Task

Click + Add Task at the top or bottom of any column.
3

Enter Task Details

Fill in the task form:
  • Title: A clear, concise description of the work
  • Description: Detailed explanation, acceptance criteria, or notes (supports rich text)
  • Priority: Urgent, High, Medium, or Low
  • Task Type: Feature, Bug, Enhancement, Refactor, Docs, or Testing
  • Assignee: Assign to yourself or a team member
  • Due Date: Optional deadline
  • Tags: Custom labels for categorization (stored as JSON)
4

Create

Click Create. The task appears in the selected column and is saved to the database immediately.

Task Types

Feature

New functionality to build

Bug

Issues that need fixing

Enhancement

Improvements to existing features

Refactor

Code cleanup and optimization

Docs

Documentation tasks

Testing

Test writing and QA

Moving Tasks

Drag and drop tasks between columns to update their status. When you move a task:
  1. The task’s column assignment updates in the database
  2. The task’s position within the column is preserved
  3. Other tasks in both the source and destination columns reorder automatically
You can also reorder tasks within a column by dragging them up or down.

Task Comments

Each task supports a comment thread for collaboration:
1

Open a Task

Click on any task card to open its detail view
2

Add a Comment

Type your comment in the text area at the bottom of the task detail panel
3

Submit

Click Post to save the comment. Comments include the author and timestamp.
Comments are stored in the KanbanTaskComment model and linked to both the task and the commenting user.

Customizing Columns

Adding Columns

You can add new columns to your board to match your team’s workflow. For example, you might add a “Review” column between “In Progress” and “Done.”

Column Properties

Each column has configurable properties:
PropertyDescription
nameDisplay name of the column
positionOrder in the board (0-based)
is_backlogMarks the column as the backlog (special styling)
is_completedMarks the column as the completion column
task_limitOptional WIP limit; visual warning when exceeded

Project Notes

In addition to the Kanban board, each project includes a Notes panel for freeform documentation. Notes use a rich text editor (TipTap) and are stored in the ProjectNote model. Use notes for:
  • Architecture decision records
  • Meeting notes
  • Quick reference documentation
  • Design specifications

AI-Powered Task Creation

You can create tasks directly from your AI agent conversations:
  1. While chatting with an agent about a feature or bug, the agent can suggest tasks
  2. Tasks created by the agent automatically populate with relevant details from the conversation
  3. You can review and adjust the task before it is added to the board
This is especially useful when the agent identifies multiple subtasks during a feature discussion.

Best Practices

Good task titles:
  • “Create product card component”
  • “Add pagination to product list”
  • “Fix mobile navigation overflow”
Avoid vague titles like:
  • “Work on products”
  • “Fix bugs”
Smaller tasks lead to faster completion and clearer progress tracking.
Set a WIP limit of 3 to 5 tasks on your “In Progress” column. This:
  • Reduces context switching
  • Forces you to finish before starting new work
  • Makes blockers visible sooner
  • Move tasks to “Done” as soon as they are complete
  • Update task descriptions with learnings or blockers
  • Review the backlog weekly to prioritize upcoming work
  • Archive or delete tasks that are no longer relevant
Tags are stored as JSON arrays and support any custom labels. Useful tag categories:
  • Component: header, sidebar, auth-flow
  • Effort: quick-win, large-effort
  • Area: frontend, backend, infrastructure

Data Model Reference

For developers and advanced users, here is the underlying data structure:
ModelKey FieldsDescription
KanbanBoardproject_id, name, settingsOne board per project
KanbanColumnname, position, is_backlog, is_completed, task_limitOrdered columns within a board
KanbanTasktitle, description, priority, task_type, assignee_id, due_date, tagsIndividual task cards
KanbanTaskCommenttask_id, user_id, contentComment thread on tasks
ProjectNoteproject_id, content, content_formatRich text notes

Next Steps

Chat Interface

Create tasks from AI agent conversations

Using Agents

Let AI build features based on your tasks

GitHub Integration

Link tasks to commits and branches

Projects

Manage your project settings and structure