Figma Webhook and Github Action to Automate Your Icon Library

This is the continuation of my previous post about the automation icon library in Vue, in this post I will share the upgrade version of it by using Figma webhook and Github action.

You can see the full code and the documentation here:

Steps

to build the workflow, I divide the process into several steps:

Part 1: Setup Figma Project
- create Figma Team
- list icon in Figma file
Part 2: Setup Figma Webhook
- listen to change from the file
- hit Github API to trigger the build process
Part 3: Setup Github Action Workflow
- export icon from Figma
- build the package and Create PR
- publish Icon to NPM

Part 1: Setup Figma Project

Figma webhook will allow us to observe when specific events happen in file Figma team project, in each payload will contain file information. Currently, Figma does not have UI for the webhook, thus we must listen to the webhook through API.

To create a new team, click on "Create new team" on your Figma dashboard, then you need to fill in the team information and team member, for pricing plan select Professional plan to be able to use webhook.

Finally, create a new file in the team project and list icons that are going to be generated to the icon library.

Part 2: Setup Figma Webhook

Because Figma does not have an interface for webhook we must create our own API to listen to change and notify it to Github.

Listen to change from the file

To set up the webhook I learn from this amazing post, in that post, we will learn how to create a webhook locally and use ngrok to expose a public URL for our local webserver. For our workflow, we will use FILE_VERSION_UPDATE to listen to changes when the version of our Figma file is updated, more info about events that available in the webhook here.

axios({
    baseURL: process.env.FIGMA_BASE_URL,
    method: 'post',
    headers: {
      'X-Figma-Token': process.env.DEV_ACCESS_TOKEN,
    },
    data: {
      event_type: 'FILE_VERSION_UPDATE',
      team_id: process.env.FIGMA_TEAM_ID,
      passcode,
      endpoint,
    },
  })

From the request above, the response will be:

{
  created_at: '2021-11-20T04:35:40Z',
  description: 'add share_outline icon',
  event_type: 'FILE_VERSION_UPDATE',
  file_key: 'file_key',
  file_name: 'my_team library',
  label: '0.0.1',
  passcode: 'passcode',
  protocol_version: '2',
  retries: 0,
  timestamp: '2021-11-20T04:35:41Z',
  triggered_by: { id: 'id', handle: 'Akbar Nafisa' },
  version_id: 'version_id',
  webhook_id: 'webhook_id'
}

Hit Github API to trigger the build process

Fo each PING, we will check if the file_name is a match, then hit Github API to trigger the build, we also send event_type to notify what process that we want to do for our Github action

app.post('/', async (request, response) => {
  if (request.body.passcode === passcode) {
    const { file_name, timestamp } = request.body
    console.log(`${file_name} was updated at ${timestamp}`)
    console.log(request.body)
    response.sendStatus(200)
    if (file_name === 'my_team library') {
      ghDispatch()
    }
  } else {
    response.sendStatus(403)
  }
})

const ghDispatch = () => {
  axios({
    url: process.env.GITHUB_BASE_URL,
    method: 'post',
    headers: {
      Authorization: 'token ' + process.env.GITHUB_TOKEN,
      'Content-Type': 'application/json',
    },
    data: {
      event_type: 'update_icon',
    },
  })
    .then(res => {
      if (res.status === 204) {
        console.log(`✅ Dispatch action was emitted`)
      } else {
        console.log(`❌ Dispatch action was failed to be emitted`)
      }
    })
    .catch(error => {
      if (error.response) {
        console.log(`❌ Dispatch failed, ${error.response.data.message}`)
      }
    })
}

These are the env variables that we use in this Figma webhook project, for full code you can check it here.

FIGMA_BASE_URL = https://api.figma.com/v2/webhooks
FIGMA_TEAM_ID = https://www.figma.com/files/team/{FIGMA_TEAM_ID}/{FIGMA_TEAM_NAME}
DEV_ACCESS_TOKEN = Figma token, more info [here](https://www.figma.com/developers/api#access-tokens)
GITHUB_BASE_URL = https://api.github.com/repos/{username}/${repository}/dispatches
GITHUB_TOKEN = Github token, set your token [here](https://github.com/settings/tokens)

Part 3: Setup Github Action Workflow

We already established on how to build the icon in the previous post, in this step, we will try to export the icon from Figma, build it and publish it to NPM

Export Icon from Figma

I learn how to export the Figma icon from this amazing article, the script already handles what we need on how to get all of the icons.

Then we add the workflow to Github action, for the CI/CD process.

name: icon-automation
on:
  repository_dispatch:
    types: [update_icon]

jobs:
  icon_automation:
    name: figma icon automation
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '14'
      - run: yarn install
      - name: Export icon
        env:
          FIGMA_BASE_URL: ${{ secrets.FIGMA_BASE_URL }}
          FIGMA_PROJECT_ID: ${{ secrets.FIGMA_PROJECT_ID }}
          FIGMA_PROJECT_NODE_ID: ${{ secrets.FIGMA_PROJECT_NODE_ID }}
          DEV_ACCESS_TOKEN: ${{ secrets.DEV_ACCESS_TOKEN }}
        run: |
          yarn export-svgs
          yarn optimize-svgs

Build the package and Create PR

The new icon will be generated as a Vue component in the Build icon step, then commit and push the new icon in the Commit SVGs step, we also get the version history description to use it as a committed label in the step get-commit-label, but this step is unnecessary, you can use any commit message. Finally, we create a pull request to the main branch to be reviewed in Create Pull Request step.

name: icon-automation
on:
  repository_dispatch:
    types: [update_icon]

jobs:
  icon_automation:
    name: figma icon automation
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '14'
      - run: yarn install
      - name: Export icon
        env:
          FIGMA_BASE_URL: ${{ secrets.FIGMA_BASE_URL }}
          FIGMA_PROJECT_ID: ${{ secrets.FIGMA_PROJECT_ID }}
          FIGMA_PROJECT_NODE_ID: ${{ secrets.FIGMA_PROJECT_NODE_ID }}
          DEV_ACCESS_TOKEN: ${{ secrets.DEV_ACCESS_TOKEN }}
        run: |
          yarn export-svgs
          yarn optimize-svgs
      - name: Build icon
        run: yarn generate-svgs
      - uses: actions/github-script@v5
        id: get-commit-label
        env:
            FIGMA_BASE_URL: ${{ secrets.FIGMA_BASE_URL }}
            FIGMA_PROJECT_ID: ${{ secrets.FIGMA_PROJECT_ID }}
            FIGMA_PROJECT_NODE_ID: ${{ secrets.FIGMA_PROJECT_NODE_ID }}
            DEV_ACCESS_TOKEN: ${{ secrets.DEV_ACCESS_TOKEN }}
        with:
          script: |
            const getCommitLabel = require('./packages/svgs/exporter/getCommitLabel.js')
            return await getCommitLabel()
          result-encoding: string
      - name: Get result
        run: echo "${{steps.get-commit-label.outputs.result}}"
      - name: Commit SVGs
        run: |
          git config user.name github-actions
          git config user.email github-actions@github.com
          git add .
          git commit -m "feat(icon): ${{steps.get-commit-label.outputs.result}}"
      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v3.11.0
        with:
          token: ${{ secrets.GH_TOKEN }}
          branch-suffix: short-commit-hash
          commit-message: Auto Pull Request
          title: "Add Icon: ${{steps.get-commit-label.outputs.result}}"
          body: Auto-created Pull Request

The pull request example can be seen here.

Publish Icon to NPM

Publishing icon to NPM can be automated using Github action, for this workflow, it is only triggered if there is a pull request from create-pull-request/* branch and it's merged to the main branch.

name: publish-package
on:
  pull_request:
    branches:
      - main
    types: [closed]

jobs:
  publish-package:
    if: contains(github.head_ref, 'create-pull-request/') && github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    env:
      NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
    steps:
    # https://stackoverflow.com/a/67581515
    # 1. provide Personal Access Token for checkout@v2
    - name: Checkout
      uses: actions/checkout@v2
      with:
          submodules: recursive
          token: ${{ secrets.GH_TOKEN }}

    # 2. setup .npmrc it uses NODE_AUTH_TOKEN
    - name: Setup .npmrc file for publish
      uses: actions/setup-node@v2
      with:
        node-version: '12.x'
        registry-url: 'https://registry.npmjs.org'

    # 3. configure git user used to push tag
    - name: Configure Git User
      run: |
        git config --global user.email "ci@your-site.com"
        git config --global user.name "ci@$GITHUB_ACTOR"

    - name: Install dependencies
      run: yarn install

    - name: Publish
      run: |
        yarn lerna:new-version
        yarn lerna:publish

Wrapping it up

The combination of Figma webhook and Github action can be so powerful, compare to the previous workflow, we can update and publish icons without opening our editor, for the new flow we can add the icon, update the version, merge the pull request, and the icon library is already updated. I hope this post can give you some insight on how to automate the process for icon library by using Figma webhook and Github action and also I want you to explore what other workflow that can be automated!

Blog