Skip to main content
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

1

Navigate to connections

Go to Dashboard > Projects > [Your Project] > Connections.
2

Connect Figma

Click Connect Figma. This opens the OAuth flow managed by Nango.
3

Authorize access

Grant access to the Figma files and projects Bugzy should reference.
4

Link design files

After connecting, link the Figma files that correspond to your project’s UI.

​
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.
ScopePurpose
file_readRead Figma file contents and frames
Bugzy only accesses Figma files explicitly linked during setup. It does not browse or access other files in your Figma organization.