@robojs/roadmap

Sync project roadmaps from external providers like Jira to organized Discord forum channels. Each card becomes a forum thread, automatically organized by workflow columns like Backlog, In Progress, and Done.

The plugin handles the full lifecycle: creating forum channels, syncing cards as threads with rich Components v2 formatting, moving threads when cards change columns, and managing permissions. It ships with a Jira provider out of the box and supports custom providers for GitHub Projects, Linear, or any backend.

Features

Installation

npx robo add @robojs/roadmap@next

Or start a new project with the plugin:

npx create-robo@next my-project -p @robojs/roadmap@next

How it works

The plugin creates a dedicated Discord category with forum channels for each workflow column. When you sync, cards from your provider appear as forum threads in the appropriate column. Labels become forum tags, assignees are mapped to Discord mentions, and descriptions render using Discord's Components v2 format with sections and thumbnails.

When a card moves between columns (e.g., from Backlog to In Progress), the plugin creates a new thread in the target forum, locks and archives the old thread, and links to previous discussions if they had user activity.

Quick start

JIRA_URL="https://company.atlassian.net"
JIRA_EMAIL="your-email@example.com"
JIRA_API_TOKEN="your-api-token"
JIRA_PROJECT_KEY="PROJ"

npx robo dev

Cards appear as forum threads organized by column. Each thread includes the card description, labels as tags, and mapped assignee mentions.

Next steps