Skip to main content

Troubleshooting

Solutions for common GitFig issues.

Authentication Issues​

"Authorization pending" won't go away​

  • Complete authorization on GitHub
  • Check correct GitHub account
  • Get a new device code

"Session expired"​

Device codes expire after 15 minutes. Start again.

Wrong account connected​

  1. Sign out from GitFig
  2. Revoke at github.com/settings/applications
  3. Sign in with correct account

Sync Issues​

No variables created​

  • Check JSON has $value fields
  • Verify file mappings configured
  • Check browser console for errors

Variables not updating​

  • Click Pull after changes
  • Check correct branch
  • Verify JSON file changed

Push fails​

  • Check write access to repo
  • Branch may be protected
  • Token may have expired

Connection Issues​

"Repository not found"​

  • Use owner/repo format
  • Verify repo access
  • Check spelling

"Branch not found"​

  • Click Refresh for branch list
  • Create branch on GitHub first

CORS Errors​

"Access-Control-Allow-Origin" error​

  • Server may need redeployment
  • Check oauth.gitfig.com is accessible
  • Try again in a few minutes

Performance Issues​

Sync is slow​

  • Large JSON files take longer
  • Many variables = more processing
  • Network affects API calls

Plugin unresponsive​

  • Close and reopen plugin
  • Check Figma memory usage
  • Restart Figma if needed

Getting Help​

If issues persist:

  1. Check browser console for errors
  2. Note the exact error message
  3. Contact support with details