Docs

Linear & Jira Two-Way Synchronization

Sync review pins and audit findings directly into Linear issues or Jira tickets with automatic bi-directional status updates.

Planned — not yet shipped. The content below is the target design for this integration. The currently available developer surface is the UI Designer MCP server with uidesigner_resolve_link.

Streamlining Engineering Handoff

Converting visual design feedback and accessibility audit issues into engineering tickets often requires manual screenshots, copy-pasting URLs, and duplicating issue statuses across tools. UIDesigner's native integrations with Linear and Atlassian Jira automate this entire handoff cycle.

Connecting Linear

  1. In UIDesigner, navigate to Settings → Integrations (/settings/integrations).
  2. Locate the Linear integration card and click Connect.
  3. Authorize the UIDesigner OAuth application with your Linear account.
  4. Select your default Linear Team and Project for synced tickets.
  5. Choose your default issue state mapping (e.g., map UIDesigner Open to Linear Todo, and Resolved to Done).

Connecting Jira Cloud

  1. In Settings → Integrations, click Connect Jira.
  2. Sign in with your Atlassian account and select your Jira Cloud site.
  3. Map your target Jira Project, Issue Type (e.g., Bug or Task), and field mappings.
  4. Click Save Configuration.

Exporting Issues from Review & Audit

From any review comment thread or audit finding card:

  • Click the Export to Issue button.
  • Choose Linear or Jira.
  • UIDesigner instantly creates the issue populated with:
  • High-resolution target element screenshot with highlighted bounding box.
  • Page URL, target viewport, and exact DOM selector path.
  • Technical context (browser user agent, window size, OS).
  • Remediation code snippets and WCAG criterion references (for audit issues).

Bi-Directional Status Sync

Status synchronization works in both directions in real time:

  • When a developer marks a ticket as Done in Linear or Closed in Jira (or closes it via a git PR commit like Fixes ENG-104), the corresponding comment pin or audit finding in UIDesigner is automatically updated to Resolved.
  • Conversely, resolving the thread within the UIDesigner canvas updates the status in your tracker.
Next
Slack Webhooks