Skip to content

Board Definitions

Board files live in .kiket/boards/. Each file can contain a single board or an array of boards.

Single Board Example

key: dev
name: Development Board
workflow: development
type: kanban
columns:
  - key: backlog
    name: Backlog
    wip_limit: 999
  - key: in_progress
    name: In Progress
    wip_limit: 4
    policies:
      auto_assign: true
  - key: review
    name: Review
    wip_limit: 3
  - key: done
    name: Done
swimlanes:
  group_by: priority
  order: ["critical", "high", "medium", "low"]
filters:
  default: "project = $project"
cards:
  show:
    - assignee
    - labels
    - story_points
  color_rules:
    - condition:
        field: priority
        operator: equals
        value: critical
      color: "#d73a4a"

Multiple Boards in One File

boards:
  - key: sprint
    name: Sprint Board
    workflow: development
    type: scrum
  - key: roadmap
    name: Roadmap
    workflow: roadmap
    type: timeline

Supported Properties

  • type – kanban, scrum, timeline, calendar.
  • columns[*].policies.auto_assign – Assign issue to user moving the card.
  • columns[*].policies.restrict_roles – Limit who can move into a column.
  • swimlanes.group_by – assignee, label, priority, or custom fields.
  • automations – Define actions triggered on column enter/exit.
  • provenance – Optional metadata for documentation (auto-populated by sync pipeline).

Boards are immutable through the UI. Modify the YAML and let the sync pipeline update the rendered board.

Calendar Feeds

Project members can subscribe to a board as an iCal feed. From the board screen choose Calendar Link, enable the feed, and copy the subscription URL. The feed exposes issues with due dates so Google Calendar, Outlook, or Apple Calendar stay in sync whenever the board changes. You can regenerate the token at any time to revoke old subscriptions.