ENGINEERING

Propagate Figma component renames into Code Connect and open a GitLab MR

When a Figma library component is renamed, this updates the matching Code Connect mappings and opens a GitLab merge request with the corrected source paths and component names…

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerevent
Steps6
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerFigma library component renamed (publish event)FigmaFigma
  • ActionRead existing Code Connect map for the nodeFigmaFigma
  • LogicProceed only if component name changed
  • ActionWrite corrected Code Connect mapping to FigmaFigmaFigma
  • ActionOpen GitLab MR updating the Code Connect sourceGitLabGitLab
  • OutputPost MR link to design-systems Slack channelSlack

What it does

Detects a renamed Figma library component, reads the existing Code Connect map for that node, rewrites the mapping to point at the renamed code component, and opens a GitLab merge request carrying the change so reviewers can approve the design-to-code relink in one place.

When to use it

Run this whenever a designer renames a component in a shared Figma library and the corresponding React/Vue component is renamed in the repo. It keeps `get_code_connect_map` accurate without a developer manually editing `.figma.tsx` files and chasing every reference.

How it works

  1. 1A Figma library publish event fires when a component is renamed.
  2. 2Read the current Code Connect map for the affected node to capture the old `codeConnectSrc` and `codeConnectName`.
  3. 3Branch: only proceed if the component name actually changed (skip cosmetic edits).
  4. 4Write the corrected Code Connect mapping back to Figma for the node.
  5. 5Open a GitLab merge request updating the Code Connect source file with the new name and path.
  6. 6Post the MR link to Slack so the design-systems team can review and merge.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect FigmaFiles, frames, comments, assets.
  2. 2
    Connect GitLabRepos, MRs, pipelines, registry.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    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.