Skip to main content

Introduction

Gluecraft JPD provides bidirectional synchronization between Jira Product Discovery (JPD) and GitHub Issues, enabling seamless workflow integration between product planning and development execution.

Part of The Craft Lab - specialized tools for modern development workflows.

What is Gluecraft JPD?​

A powerful sync engine that automatically keeps JPD and GitHub in sync, allowing product teams to plan in JPD while development teams work in GitHub, with changes flowing bidirectionally.

Core Capabilities​

  • Bidirectional Sync - Automatic two-way synchronization between JPD and GitHub
  • Native Sub-Issues - Real GitHub parent-child relationships for Epic > Story > Task hierarchy
  • Custom Field Mapping - Flexible configuration for mapping JPD custom fields to GitHub labels and content
  • Comment Sync - Team discussions synchronized across both platforms with author attribution
  • Status Workflows - Configurable status mappings between JPD workflows and GitHub states
  • Transform Functions - Custom TypeScript functions for complex data transformations
  • Auto-Label Creation - Automatic GitHub label generation with configurable colors and descriptions
  • Rate Limit Handling - Intelligent caching and exponential backoff for API rate limits

Quick Navigation​

Getting Started​

Start here if you're new to the connector:

Configuration​

Configure sync behavior and field mappings:

CLI Tools​

Command-line tools for setup and operation:

Features​

Advanced features and capabilities:

Troubleshooting​

Solutions for common problems:

Use Cases​

Product Management

  • Plan in JPD with RICE scoring and themes
  • Automatically sync refined issues to GitHub for development
  • Track implementation progress in JPD

Development Teams

  • Work in familiar GitHub Issues environment
  • Status updates automatically sync back to JPD
  • Comment on issues in either platform

Cross-Functional Collaboration

  • Product and engineering stay in sync automatically
  • Eliminate manual copy-paste between systems
  • Single source of truth maintained across both platforms

Architecture​

graph LR
    JPD[Jira Product Discovery] <--> Connector[Gluecraft JPD]
    Connector <--> GitHub[GitHub Issues]
    
    Connector --> Labels[Auto-Create Labels]
    Connector --> Hierarchy[Maintain Hierarchy]
    Connector --> Comments[Sync Comments]

The connector runs as a scheduled job (via GitHub Actions, cron, or manual execution) and maintains sync state using metadata stored in GitHub issue bodies.

Next Steps​

Choose your path:

New Users: Start with Prerequisites then run the Quick Start wizard.

Advanced Users: Review Manual Setup for full control over configuration.

Existing Users: Jump to CLI Tools or Configuration for reference.

Support​

  • Documentation: Browse the guides in this documentation site
  • Issues: Report bugs or request features on GitHub Issues
  • Contributing: See the Contributing Guide for development setup

Ready to get started? Head to Prerequisites to begin your setup.