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

# Figma

> Connect Figma to give Bugzy access to your design files for visual context during testing.

Figma integration gives Bugzy access to your design files, providing visual context that improves test generation and visual regression detection. When Bugzy understands what your UI should look like, it writes better tests and catches more visual issues.

## What Figma enables

* **Design-aware test generation** — Bugzy references your Figma designs when generating tests, ensuring tests validate the intended UI
* **Visual context for triage** — When triaging failures, Bugzy compares actual screenshots against Figma designs to distinguish intentional changes from regressions
* **Component mapping** — Bugzy maps Figma components to their code implementations for more targeted testing

## Setup

<Steps>
  <Step title="Navigate to connections">
    Go to **Dashboard > Projects > \[Your Project] > Connections**.
  </Step>

  <Step title="Connect Figma">
    Click **Connect Figma**. This opens the OAuth flow managed by Nango.
  </Step>

  <Step title="Authorize access">
    Grant access to the Figma files and projects Bugzy should reference.
  </Step>

  <Step title="Link design files">
    After connecting, link the Figma files that correspond to your project's UI.
  </Step>
</Steps>

## How Bugzy uses designs

### During test generation

When generating tests for a flow, Bugzy reads the relevant Figma frames to understand:

* Expected layout and component positioning
* Interactive elements and their states
* Navigation patterns and user flows

This produces tests that validate the actual design intent, not just whatever happens to be on screen.

### During triage

When a visual assertion fails, Bugzy compares the actual screenshot against the Figma design to determine:

* **Intentional change** — The UI was updated but the Figma design matches the new version
* **Design drift** — The implementation doesn't match the current Figma design
* **Regression** — The UI changed unexpectedly and doesn't match any known design

## Permissions

Bugzy requests read-only access to your Figma files. It does not modify designs or leave comments.

| Scope       | Purpose                             |
| ----------- | ----------------------------------- |
| `file_read` | Read Figma file contents and frames |

<Info>
  Bugzy only accesses Figma files explicitly linked during setup. It does not browse or access other files in your Figma organization.
</Info>