Skip to main content

Changelog

v1.3.0 (August 29, 2026)​

Major Changes​

Variable Modes (free during the preview)

  • Sync every mode of your variable collections (light/dark, multi-brand) in both directions
  • Mode-keyed token files: root keys are mode names, structurally identical per mode
  • Alias references ({Collection.path.to.token}) written on push and re-bound on pull
  • Per-mapping "Variable Modes" setting: First mode only or All modes
  • See Variable Modes for details and requirements
  • Try it with the variable-modes example: Primitives, light/dark Semantic, Color Styles, and Text Styles files

Styles sync in both directions

  • Color Styles, Text Styles, and Effect Styles mappings now import on Pull as well as export on Push. Styles are created or updated by name, so re-pulling never duplicates. A text style whose font is not available in the file is skipped with a warning
  • Blur effects now export their radius

New repositories start with modes and styles

  • Create New seeds tokens/primitives.json, a light/dark tokens/semantic.json, tokens/color-styles.json, and tokens/text-styles.json, maps each to its target, and pulls them, so a fresh repo shows two collections with modes and six styles

GitFig Pro preview

  • Variable modes sync is free for everyone during the v1.3 preview. It becomes part of GitFig Pro in a future release, and pricing will be announced before that happens
  • Everything else in GitFig stays free: sync, branches, PRs, staging, all token formats
  • Inside the plugin you can opt in to a one-time heads-up when GitFig Pro launches

Improvements​

  • Linked view redesigned: the panel is ordered by what you do daily. Changes is one list with checkboxes (checked changes go into the next commit; everything starts checked) and the push honors it, so unchecked changes are left out and stay listed. Commit has a simpler message box (Ctrl/Cmd+Enter to commit) and a Ready to push block with Push always visible. Pull asks before overwriting uncommitted changes, can be undone from its summary toast, and shows its count inside the button. One toast per action, anchored at the bottom. Mapping collapses once set up, refreshes on demand and after pulls, and reminds you to pull after adding a mapping. Menus close on click outside or Escape; Enter creates a branch
  • Connect Repository redesigned: one screen, no tabs. The Repository field lists every repository the owner has, filtered as you type; a pinned Create row appears for names that do not exist yet and expands the form in place (new repositories default to Private). Arrow keys, Enter, and Escape work throughout, the field is focused when the screen opens, and menus close on click outside or Escape
  • Readability overhaul: the whole UI is ~30% larger (text, buttons, spacing), the window sizes itself to fit its content when it opens, and you can drag-resize it from the right or bottom edge
  • Zoom the UI to your monitor: Ctrl/Cmd +/− or Ctrl/Cmd + scroll scales everything from 50% to 200% (Ctrl/Cmd 0 resets), the footer shows your current zoom, and GitFig remembers your setting. Handy if you switch between a high-resolution monitor and a laptop
  • The commit message box grows as you type (the first line is the commit summary, additional lines become the description)
  • Adding or editing a file's Target now opens a floating dialog that's never cut off by the sections below
  • Clearer color language: blue now always means "you can click this". Informational labels are neutral, edit is blue, delete is red, and disabled buttons are gray
  • The footer notes that variable modes sync is free during the preview
  • $extensions and repo-owned metadata now survive pushes: GitFig merges against the file in your repo and only ever writes $value, $type, and token descriptions
  • Multiple mappings now push as one atomic commit (one file per mapping)
  • Each mapping has an editable Collection Name, so files map cleanly to specific collections
  • Repository type-ahead when connecting: pick from your (or your org's) repos instead of typing names
  • The incoming commit message is shown before you pull
  • Typography tokens import on pull; shadow tokens report a clear warning
  • Change detection is mode-aware, with mode badges in the staging list

Fixes​

  • Pull sometimes needed two presses and the update badge lagged by up to a minute. GitHub API responses were being served from the browser cache; all freshness-critical reads now bypass it
  • The "1 pull" badge no longer sticks around after a successful pull (including a false badge right after pushing)
  • Accented and non-Latin characters (é, →, 日本語) no longer get corrupted when pulling; if older versions garbled a description, fix it once and it stays clean
  • Legacy combined token files' colorStyles/textStyles/effectStyles sections are no longer imported as broken variables when pulling into Variables
  • Mode-keyed files are refused (not flattened) on "First mode only" mappings, including newly added mappings
  • Sign Out is now always reachable, even if GitHub access was revoked outside the plugin
  • Fixed a crash when pushing tokens containing non-Latin characters
  • Fixed a race that could show phantom changes right after pulling
  • The Create Commit button no longer blends into the form fields
  • Single-mode collections no longer show a confusing "Mode 1" badge on detected changes

Notes​

  • The first run after updating refreshes your change-detection baseline (one-time)
  • The plugin now requests Figma's payments permission (used only for Pro checkout/entitlement)

v1.2.1 (March 3, 2026)​

Bug Fixes​

GitHub Organizations Not Appearing in Owner Dropdown

  • Fixed: Organizations now appear in the owner dropdown for both "Connect Existing" and "Create New" modes
  • Previously, the organization list only loaded when switching to "Create New", so users on the default "Connect Existing" tab never saw their orgs
  • Added read:org OAuth scope so GitHub returns the full list of organization memberships
  • If the org fetch fails (permissions, network), a clear error message now appears in the dropdown instead of failing silently

Re-Authentication for Existing Users

  • Users who signed in before v1.2.1 may not have the new read:org permission
  • A banner appears in the Connect view explaining the new requirement with a one-click sign-out link
  • Personal repositories continue working without re-authentication

Documentation Corrections

  • Fixed listed OAuth scopes: read:user + read:org (previously documented as user:email)
  • Added "Organizations not appearing" troubleshooting entry to Connecting a Repository

v1.2.0 (January 15, 2026)​

Major Changes​

Git-Like Staging Workflow

  • Real-time change detection monitors Variables and Styles every 3 seconds
  • Three-section workflow: Unstaged Changes → Staged Changes → Commits to Push
  • Stage individual changes or use "Stage All" to batch
  • Create local commits before pushing to GitHub
  • View, expand, and delete pending commits
  • Cross-device support: commits stored in cloud and sync across devices

Streamlined Plugin

  • Removed Make Bridge mode to focus on the core workflow
  • Make Bridge functionality is archived and may return in a future release
  • The plugin now launches directly with no mode switching

Redesigned Repository Connection

  • Connect Existing: Separate Owner dropdown and Repository Name fields
  • Owner dropdown shows your GitHub username and organizations with avatars
  • Create New: Same Owner selector for choosing where to create the repo
  • Consistent UI pattern across both connection methods

Unified Main View

  • Settings merged into main view (no separate Settings screen)
  • Mapping section now inline with file tree always visible
  • "Add Target" button appears on hover over JSON files
  • Repository dropdown with Disconnect option
  • Branch dropdown with Create Branch inline
  • User menu with avatar and Sign Out
  • Pull button relocated to header row with commit count badge

Improvements​

  • GitHub-style octicon icons for branches, repositories, and pull requests
  • Improved toast notification positioning (top of panel)
  • Better keyboard input handling in Figma plugin context
  • Authentication status visible on splash and connect screens
  • Baseline updates automatically after Pull and Push operations

v1.1.1 (January 13, 2026)​

Bug Fixes​

Fixed New Repository Setup Flow

  • Creating a new repository now works seamlessly end-to-end
  • Default file mapping (sample-tokens.json → Variables) is automatically configured
  • Tokens are auto-pulled immediately after repo creation (no manual pull required)
  • Removed misleading "Repository has content to pull" notification on fresh setup

This patch resolves a UX issue where users creating new repositories were stuck in a dead-end state, unable to pull without mappings or configure mappings without files.

v1.1.0 (January 8, 2026)​

New Features​

Draft File Support

  • Work with unsaved/draft Figma files
  • Draft files get a unique identifier that persists across sessions
  • When you save a draft to a Figma project, your connection automatically migrates to the stable file ID
  • Works seamlessly across Figma Desktop and Web

Improved Onboarding

  • New repositories now include a sample-tokens.json file with example design tokens
  • Sample includes colors, spacing, and border radius values in W3C format
  • Pull the sample immediately to see how variables are created in Figma

Improvements​

Actionable Error Messages

  • Error messages now provide clear next steps for resolution
  • Authentication errors: prompt to sign out and back in
  • Permission errors: suggest checking repository access
  • Network errors: advise checking connection
  • Context-specific guidance for each operation type

Better Toast Notifications

  • Repositioned to top of panel to avoid overlapping buttons
  • Longer display duration for better readability (8-12 seconds depending on type)
  • Dynamic content padding prevents UI overlap

UI Clarity

  • "Disconnect repo" button moved next to the repository name for better discoverability
  • Clearer visual association between the action and the connected repository
  • Repository input help text now explains owner format (GitHub username or org name)

Footer with Quick Links

  • Version number displayed in footer (e.g., "GitFig v1.1.1")
  • Quick access icons linking to website, documentation, and community
  • Tooltips show full URLs on hover

Bug Fixes​

  • Fixed high severity qs package vulnerability (Dependabot #6)

v1.0.0 (December 25, 2025)​

Initial public release of GitFig.

Core Features​

  • Connect Figma files directly to GitHub repositories
  • Pull JSON tokens from GitHub → create/update Figma Variables
  • Push Figma Variables/Styles → commit to GitHub
  • Support for W3C Design Tokens, Style Dictionary, and Tokens Studio formats
  • Branch management: switch, create, and view branches
  • Create Pull Requests directly from Figma
  • Change detection with commit count badges
  • Conflict warnings when pushing with unpulled changes

Make Bridge Mode (Removed in v1.2.0)​

note

Make Bridge mode was removed in v1.2.0 to focus on the core workflow. The functionality has been archived and may return in a future release based on user feedback.

  • Sync Figma Make's auto-created repos to your target repos
  • Auto-sync via GitHub webhooks
  • Reverse sync (Target → Make)
  • Three sync strategies: PR, Direct Push, Auto-merge
  • Conflict detection and diff viewer
  • Include/exclude file patterns
  • GitHub Pages deployment toggle

Infrastructure​

  • GitHub OAuth Device Flow authentication
  • Vercel serverless backend
  • Supabase PostgreSQL database

Roadmap​

Planned features for future releases:

  • Scheduled syncs
  • Preview changes before applying
  • Sync specific mappings individually
  • GitHub Enterprise support
  • Figma DevMode integration