ENGINEERING

Batch codemod for a Figma rename and ship one GitLab MR

Receives a Figma rename webhook, runs a repo-wide codemod to rename every code reference and update the Code Connect mapping.

CategoryEngineering
Enginesim
Difficultyadvanced
Triggerwebhook
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerFigma rename webhook (old + new name)HTTP webhook
  • ActionRead Code Connect map to resolve source pathFigmaFigma
  • ActionRun codemod across the repo to rename referencesShell
  • LogicAbort and alert if zero files changed
  • ActionWrite updated Code Connect mapping to FigmaFigmaFigma
  • OutputOpen GitLab MR with the full codemod diffGitLabGitLab

What it does

Turns one Figma component rename into a complete, repo-wide code change. It runs a codemod that renames every import, JSX usage, and the Code Connect source file across the GitLab project, refreshes the Figma Code Connect mapping, and packages everything into one merge request instead of scattered manual edits.

When to use it

Use it when a heavily-used component is renamed and the old name appears in dozens of files. The codemod guarantees consistency and the single MR gives reviewers one diff to approve rather than a trickle of follow-up commits.

How it works

  1. 1A Figma rename webhook delivers the old and new component names.
  2. 2Read the Code Connect map to resolve the old name to its repo source path.
  3. 3Run a shell codemod across the checked-out GitLab repo to rename all references.
  4. 4Branch: abort and alert if the codemod touches zero files (mapping likely wrong).
  5. 5Write the updated Code Connect mapping back to Figma.
  6. 6Open a GitLab merge request with the full codemod diff for review.

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 ShellRun sandboxed commands inside the workspace.
  4. 4
    Connect HTTP webhookTrigger any URL on agent actions.
  5. 5
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  6. 6
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  7. 7
    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.