Skip to content
Titan Docs Titan Docs

Use Kanban and timeline boards

Uses

Section titled “Uses”

Prerequisites

Section titled “Prerequisites”
  • Open a project with write access.
  • Be ready to create either a .kanban or .timeline file.

Steps

Section titled “Steps”
  1. Create a new board file from the new-file flow: Kanban Board (.kanban) or Gantt Chart (.timeline).
  2. Open the board file.
  3. Add board items and organize them visually.
  4. For Kanban, set up columns and move cards between columns.
  5. For Timeline, define phases and place items in the correct phase sequence.
  6. Reorder items as your plan changes.
  7. Save and reopen the board to confirm layout persistence.

Verification

Section titled “Verification”
  • The board file opens in visual board mode and is editable.
  • New cards/items appear in the board and can be moved.
  • Reopening preserves board structure and item placement.
  • Board primitives use Column/New Task in Kanban and Tasks/Add phase/Add task in Timeline UI.
  • On disk, boards serialize as MyST fenced directives (```{kanban} / ```{timeline}) with board metadata (:id:, timeline :phases:) and list/heading bodies.

If Something Goes Wrong

Section titled “If Something Goes Wrong”
  • Board file opens as plain text
  • Confirm the extension is .kanban or .timeline, then reopen from File workspace.
  • Drag-and-drop does not work
  • Reload the board tab and retry item movement.
  • Saved board structure is missing
  • Save, close, and reopen once more; if it still fails, compare the file text against expected MyST board syntax (```{kanban} with headings/cards, or ```{timeline} with :phases: and item rows) to isolate malformed content.