> ## Documentation Index
> Fetch the complete documentation index at: https://adapt.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Figma

> Connect Figma to Adapt to read files, frames, components, and comments

Connect your Figma account to Adapt using a personal access token so Adapt can read your design files.

## Set up credentials

<Steps>
  <Step title="Open Figma settings">
    Sign in to Figma, open the **account menu** in the top-left corner of the file browser, then select **Settings**.
  </Step>

  <Step title="Go to the Security tab">
    In Settings, open the **Security** tab and scroll to **Personal access tokens**.
  </Step>

  <Step title="Generate a new token">
    Click **Generate new token**, enter a name, set an expiration date, and assign read scopes such as `file_content:read`, `file_metadata:read`, and `file_comments:read`.
  </Step>

  <Step title="Copy the token">
    Click **Generate token**, then copy the token and store it somewhere safe. Figma shows it only once.

    <Note>A personal access token can access all files and data your Figma account can see, so treat it like a password.</Note>
  </Step>
</Steps>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Figma">
    Search for **Figma** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="Add your credentials">
    Enter the values you gathered above, then click **Add connection**:

    | Secret Name          | Value                      |
    | -------------------- | -------------------------- |
    | `FIGMA_ACCESS_TOKEN` | Your personal access token |

    You can rename the connection and choose whether it is shared with your
    organization or kept personal to you.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to read the components in a file.
  </Step>
</Steps>

### Security

* Credentials are encrypted at rest with AES-256
* The token inherits your Figma permissions and access level, limited to the scopes you assign when generating it
* Set an expiration date and revoke tokens anytime from Settings > Security > Personal access tokens
* Do not share or commit your access token

## Capabilities

Adapt can read your Figma files to analyze frames, components, and comments. Use it to review designs, inventory components, and surface feedback.

### Examples

```
List the frames in this Figma file.
```

```
Summarize the comments left on my design file.
```

```
What components are used across this file?
```

```
Describe the layout of the main frame in this Figma file.
```