Skip to content

Figma plugin

Sync your Figma library to Grails.

The Grails plugin runs inside Figma. Scan a file, review what it found, and sync: Grails builds the record of your components, variables and styles from it.

To connect you need a Grails account and your own plugin token. Grails is in closed alpha, so request access first.

What it reads

Four kinds of things, from one scan.

The plugin reads your Figma file and finds what a design system is made of. A scan changes no design.

  • Components

    Components and component sets. The variants of a set roll up into it.

  • Variables

    Variable collections, with their modes and the aliases between variables.

  • Paint styles

    Fill and stroke styles.

  • Text styles

    Typographic styles.

Names that start with . or _ are left out unless you turn on Include hidden assets.

Settings

  • Sync images
  • Sync variant thumbnails
  • Include hidden assets
  • Mark exportable components as assets

Review and sync

You choose what goes in.

After a scan the plugin compares your file with what Grails already has and sorts what it found. You pick what to sync, add a note that says why, and start it. If something doesn’t make it, “Sync Finished With Gaps” lists which entities did not sync.

  • Not synced

    Found in your file and not in Grails yet.

  • Modified

    Changed in Figma since the last sync.

  • Synced

    Grails’ copy matches your file.

  • Removed

    In Grails, but no longer in your file. It waits for your review: nothing leaves Grails until you confirm it.

Before you install

What you need to connect.

The plugin installs from the Figma Community and connects to your Grails team with a token.

  1. A Grails account

    Grails is in closed alpha: request access first, at no cost during the period.

  2. A role of admin or editor

    On the Grails team you sync to.

  3. Your plugin token

    Find it in Team settings → Integrations → Plugin token. Each member has a personal one.

Install it, then scan one file.

Request access, install the plugin from the Figma Community and scan a file. Nothing is synced until you start it.

While in Alpha, we are working 1:1 with teams to improve the product. Access during this period is per-request only.