CONTENT CREATION

Write a plain-English token changelog to Notion and refresh the style-guide changelog page

When the Figma file changes, computes which tokens were added, removed, or recolored, writes a readable changelog entry to a Notion database.

CategoryContent Creation
Enginesim
Difficultyintermediate
Triggerwebhook
Steps7
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerFigma file updated (webhook)FigmaFigma
  • ActionFetch current tokens; load prior snapshot from NotionNotionNotion
  • LogicCompute added / removed / modified tokens
  • ActionWrite plain-English change descriptionsOpenAI
  • ActionAppend dated changelog entry + store new snapshotNotionNotion
  • ActionRedeploy style guide with updated changelogVercelVercel
  • OutputPost changelog summary to SlackSlack

What it does

Turns raw Figma variable edits into a human-readable history. Each change produces a dated changelog entry describing exactly what moved (e.g., "primary-500 darkened from #3B82F6 to #2563EB"), logged in Notion and surfaced on the public style guide.

When to use it

Use it when consumers of your design system keep asking "what changed and when?" It gives product, marketing, and engineering a trustworthy audit trail of token changes without reading Figma version history.

How it works

  1. 1A Figma webhook fires on file save.
  2. 2The flow fetches the current token snapshot and loads the previous snapshot from the Notion database.
  3. 3A logic step computes added, removed, and modified tokens between the two snapshots.
  4. 4An OpenAI step writes each change as a clear one-line, plain-English description grouped by category.
  5. 5A Notion step appends a dated changelog entry and stores the new snapshot for next time.
  6. 6A Vercel deploy refreshes the style guide so its changelog section shows the latest entries.
  7. 7The summary is posted to Slack.

Set it up

What you configure once, before turning it on.

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