DOCUMENT OPS

Sync Figma design tokens into a versioned spec PR on GitHub

When a Figma file is published, exports its design variables, diffs them against the committed token spec, and opens a GitHub pull request with the changes when they differ.

CategoryDocument Ops
Enginesim
Difficultyintermediate
Triggerevent
Steps6
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerFigma file publishedFigmaFigma
  • ActionExport variable definitions from FigmaFigmaFigma
  • ActionRead committed tokens.json from branchGitHubGitHub
  • LogicDiff tokens; stop if unchanged
  • ActionCommit new tokens + changelog to a branchGitHubGitHub
  • OutputOpen pull request for reviewGitHubGitHub

What it does

Keeps your repository's design-token source of truth in lockstep with Figma. On every Figma file publish, it pulls the current variable definitions, compares them to the `tokens.json` already committed, and — only if something actually changed — opens a pull request with the new values and a human-readable changelog. No PR is opened when nothing moved.

When to use it

Use it when designers own tokens in Figma but engineering consumes them from a versioned file. It removes the manual copy-paste step and gives every token change a reviewable, revertable artifact.

How it works

  1. 1Figma publishes a new file version, firing the trigger.
  2. 2Pull the file's variable definitions (colors, spacing, type scale) from the Figma API.
  3. 3Read the committed `tokens.json` from the target GitHub branch.
  4. 4Diff the two; if they are identical, stop here.
  5. 5If they differ, write the new tokens and a generated changelog to a fresh branch.
  6. 6Open a pull request so the team reviews and merges the spec update.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect FigmaFiles, frames, comments, assets.
  2. 2
    Connect GitHubRepos, issues, pull requests, actions.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.