Figma Airdrop

The Figma Airdrop simplifies migration from Figma to DevRev, supporting both one-time imports and ongoing syncs.

Setting up the Figma connection

The Figma Airdrop supports two authentication methods:

OAuth

Connect your Figma account using OAuth for a seamless experience.

Personal access token (PAT)

You can also use a personal access token with the following scope:

• File Content - Read Only: Required to access your Figma files and their content.

Supported objects

The following is a list of Figma objects and their corresponding DevRev equivalents. Those marked as Sync to DevRev are eligible for import from Figma to DevRev.

Importing from Figma

Follow the steps below to import from Figma:

1. Go to Marketplace and search for Figma in the Airdrop category and install.
2. In the snap-in config modal, click Install then go to the Airdrop section in your settings left nav.
3. Click +Import and select the Figma logo.
4. Create a new connection to your Figma account by either:
   • Authorizing through OAuth, or
   • Providing your Personal Access Token (PAT)
5. Once the connection is established, select the Figma projects you want to import and specify the DevRev part that should be used for any imported designs. This initiates a bulk import of the selected designs.
6. DevRev automatically maps the fields from Figma to the corresponding fields in DevRev.

The duration of the import depends on the number and size of Figma files being imported. It can take seconds for accounts with only a few files to several minutes for accounts with many complex design files. DevRev honors the Figma API rate limits and back-off requirements to ensure smooth imports.

Post import options

After a successful import, you have the following options available for the imported account:

• Sync to DevRev
  This option allows you to synchronize any modifications made in Figma with the corresponding designs previously imported into DevRev. It also creates new designs in DevRev for any new files created in Figma after the last sync or import.

• View Report
  This option allows you to access detailed information about the initial import and any subsequent syncs performed, including file counts and sync status.

• Delete Import
  If you wish to remove the import and all items that were imported from Figma into DevRev, you can use this option.

• Edit Connection
  Use this option to change the connection used for any subsequent actions. It can be helpful if a connection becomes inactive, you need to switch from PAT to OAuth, or the user who established the connection is no longer available.

Sync to DevRev

After a successful import from a Figma account, you can choose to sync the imported data with DevRev. This feature airdrops any new files and users, and any changes made to previously imported items from Figma.

To perform a one-time sync to DevRev, follow these steps:

1. Go to Settings > Integrations > Airdrops.
2. Locate the previously imported Figma connection.
3. Select the ⇆ > ⇾ From Figma to DevRev option.

A one-time sync may overwrite fields in previously imported designs, even if they were modified in DevRev.

Historical Airdrops

To view currently running and previous Airdrops from various sources, do the following:

1. Go to Settings > Integrations > Airdrops.
2. Select the import you want to view.
3. Click on the context menu (⋮) and select View Report.

Periodic sync

After successfully importing to DevRev, you have the option to enable a periodic sync. This allows for automatic synchronization with DevRev on a regular basis. By default, the sync occurs once an hour.

To configure periodic sync, follow these steps:

1. Go to Settings > Integrations > Airdrops.
2. Locate the previously imported project.
3. Select the ⇆ > Set Periodic Sync option.

The Enable automations for synced items setting is optional and can be activated during periodic sync configuration. When enabled, newly created or updated items trigger events, which can initiate webhooks, notifications, Snap-ins, and other processes, as if the events originated directly in DevRev.

If this setting is disabled, updates will not trigger any event-driven processes. This behavior applies only to periodic syncs; no events are triggered during a first-time import or manual sync to or from DevRev.

Delete import

This deletes any content created by the import, including users and works.

An import and all the content it creates can be deleted from DevRev. This can be useful when running POCs or to change the recipe used during the import. Once an import has been deleted, all the content it created gets deleted, even if they were modified in DevRev. It's possible to import the project again after its deletion.

To delete an import and all the content it created, go to Settings > Integrations > Airdrops, find the previously imported project, and select ⋮ > Delete Import.