Skip to main content

Make Bridge Setup

This guide walks you through setting up a bridge between Figma Make's repository and your target repository.

Time: 10 minutes Difficulty: Intermediate

Prerequisites​

  • A Figma file using Figma Make
  • Make has pushed at least once (creating the auto-repo)
  • A target repository you want to sync to
  • Write access to both repositories

Step 1: Open Make Bridge Mode​

  1. Launch GitFig in your Figma Make file
  2. Click the "Make Bridge" tab at the top

Make Bridge Tab

Step 2: Enter Make Repository​

GitFig auto-detects the Make repository from your file. If not detected:

  1. Enter the Make repo in format owner/repo-name
  2. This is the auto-created repository from Figma Make

Step 3: Enter Target Repository​

Enter your target repository where you want code synced:

FieldExample
Ownermycompany
Repodesign-system-code
Branchmain

Target Repo Config

Step 4: Choose Sync Strategy​

Select how syncs should work:

Creates a PR for each sync. You review and merge manually.

Make push → GitFig creates PR → You review → Merge

Direct Push​

Pushes directly to target branch. Fast but no review step.

Make push → GitFig pushes directly to target

Auto-Merge​

Creates PR and automatically merges if no conflicts.

Make push → GitFig creates PR → Auto-merge if clean

Step 5: Create Bridge​

Click "Create Bridge" to save the connection.

GitFig creates a database entry linking the two repositories.

For automatic syncing when Make pushes, set up a webhook:

  1. Go to your Make repository on GitHub
  2. Navigate to Settings → Webhooks → Add webhook
  3. Configure:
FieldValue
Payload URLhttps://oauth.gitfig.com/api/webhooks/github
Content typeapplication/json
SecretGenerate one with openssl rand -hex 32
EventsSelect "Just the push event"
  1. Add the same secret to GitFig server environment variables

See Auto-Sync Configuration for detailed instructions.

Step 7: Test the Connection​

  1. Click "Sync Now" in GitFig
  2. Check your target repository for the new commit/PR

Bridge Configuration​

After setup, you can adjust settings:

SettingDescription
Target branchWhich branch to sync to
Sync strategyPR, direct push, or auto-merge
Include patternsOnly sync matching files
Exclude patternsSkip matching files

Access settings by clicking the gear icon next to your bridge.

File Patterns​

Filter which files get synced:

Include Patterns​

Only sync files matching these patterns:

src/**/*.tsx
*.json
package.json

Exclude Patterns​

Never sync files matching these patterns:

node_modules/**
*.log
.env

Patterns use glob syntax (* = any, ** = any path depth).

Multiple Bridges​

You can create multiple bridges from different Make files to different target repos. Each Figma file can have one bridge.

Troubleshooting​

"Make repository not found"​

  • Ensure Figma Make has pushed at least once
  • Check you have read access to the Make repo

"Target repository not found"​

  • Verify the owner/repo format
  • Check you have write access

"Bridge already exists"​

  • This Figma file already has a bridge
  • Delete the existing bridge first if you want to change it

Next Steps​