Skip to main content

Connect to your GitHub repository

Connecting your GitHub repository to Figma allows the Code Connect UI to access your codebase, simplifying and speeding up component mapping while providing extra context about those mappings.

info

GitHub Enterprise Server (GHES) is not supported.

Initiate the connection​

  1. Open the Code Connect UI in your Figma library file.
  2. Click the Settings icon.
  3. Select Connect to GitHub. Log into the GitHub account that has access to the repository you want to connect.
  4. When prompted, grant access to either:
    • All repositories in your account.
    • Specific repositories that contain the components for your design system.

Authorize access​

The next step depends on your role in the Github organization you're trying to authorize:

  • If you have admin permissions

    1. Select Install and Authorize to grant Figma access.
    2. Confirm which repositories Figma can access.

  • If you don’t have admin permissions

    1. Select Request access.
    2. This sends a request to the organization administrator, who must approve access before you can continue.
info

For an overview of the permissions requested when authorizing with Github please visit GitHub App permissions overview →

Connect to a repository​

  1. Once authorization is complete, select one repository to connect to the Figma library file. Only one repository can be connected per library file.
  2. Choose the directories within that repository that contain your UI components.
  3. These directories will now be available in Code Connect.