Changelog

This page is updated automatically when new features are released. Each entry comes from the development team’s annotations in the source code.

September 2026

Components

Improved documentation is now saved when you press Save, instead of after every edit. You can add, rewrite, reorder and remove blocks freely and commit them all at once; closing the panel with unsaved changes asks before discarding them.
Fixed On a large design system a sync used to leave many components without a build order, and the API answered “not computed” for them, so an agent could not tell what to build first. The order is no longer prepared during the sync at all: it is worked out when you ask for it, so it is always available and always current. Nothing you call changes for reading it, and syncs of large libraries finish sooner.

Docs

New you can now write your own documentation pages, not only documentation attached to Figma components and tokens. A page’s link comes from its title and then stays put, so renaming one later does not break anything you already shared.
New you can now group pages into folders, and rename or remove a folder without touching the pages inside it: removing one simply leaves its pages ungrouped. Moving a page between folders never changes its link.
New you can now delete a documentation page. Unlike the documentation attached to a Figma component, which comes back the next time you sync, a page and everything written on it are removed permanently.

August 2026

Components

Improved Schema Upgrade v0.28.0: Components now capture absolute positioning and logical offsets, dashed stroke patterns, image fills, border colour, layout sizing and per-instance overrides. Because none of this was ever extracted before, every component must be re-synced once from the Figma plugin; until then it is marked “Spec upgrade required”. Re-syncing records a “Spec Version Update” in version history — no diff and no version bump, because re-reading the same design under a newer schema is not a design change.
Fixed Text Styles no longer lower your CHI score: text that uses a Figma Text Style was being counted as hardcoded by Token Adherence, because the applied style was flattened into raw font values before the score was calculated. Applying a Text Style is the correct way to type text in a design system, so it now counts as tokenized — the same as a bound variable. Expect Token Adherence, and therefore the CHI score, to rise for components that use Text Styles, once they are re-synced from the Figma plugin. Nothing about those components changed; what changed is that the score now measures them correctly.

Figma Plugin

Fixed A sync that loses batches no longer reports success. The commit stays open and the Dashboard offers “Resume sync” until every declared entity has actually arrived.
Fixed When a sync fails mid-way, the interrupted-sync banner now appears immediately instead of only after reopening the plugin.
New Entities that could not sync because the plan limit was reached, or because they need a newer plugin build, are now reported separately from ones a retry can still deliver.
New Each entity card on the Dashboard shows when that entity type has reached its plan quota, without blocking the rest of the plugin.
Fixed “Re-sync now” on the update notice now actually re-imports the affected components. It previously reported success without changing anything, so the same notice reappeared every time.
New The Variables card warns when variables changed in Figma and your plan cannot bring them in automatically, so a manual sync from the plugin is the only way.
New If the plugin build is too old for the server, it now shows a dedicated screen asking you to reopen it, instead of failing mid-sync.
Fixed Syncing a file for the first time no longer reports thousands of entities that “did not sync”. Individual variants were counted as things to sync, but variants are always synced as part of their set — so the target could never be reached and the sync stayed stuck as interrupted no matter how often it was retried.
Fixed “Sync All” on the scan results screen now syncs standalone components too. It previously synced component sets only, so a design system built without variants synced nothing at all.
New when your team edits token values or scopes in Grails, the dashboard now shows those queued changes and lets an admin or editor apply them to the open Figma file
New a review screen lists every queued token change with its path, mode and before → after value, so nothing is applied blind; untick anything you do not want and it is discarded
Improved token sync is paused for a file while changes from Grails are still waiting, so an incoming sync can no longer overwrite work that has not been applied yet
New when your team reaches its plan limit for components, variables or styles, the notice now appears inside that entity’s own card, showing usage against the limit; every other alert keeps working, and syncing or un-syncing to free quota stays available
Fixed The component list no longer offers individual variants as separately selectable entities. Every other screen already listed component sets and standalone components only; this one did not, so the selection count promised far more than a sync could deliver.
New When Grails improves how it reads your components, the plugin now opens on a dedicated screen that tells you how many need re-syncing and syncs them in one action. Previously this sent you to the review screen, where the “Modified” and “New” filter tabs showed an empty list for exactly these components — because they are neither.

Team Settings

New issue API keys so external tools, agents and CI can read your project
New revoke a key at any time, and see when each one was last used
New copy a ready-made MCP configuration for Claude, VS Code, Cursor, Gemini or ChatGPT
New see each key’s rate limit, and whether it is enforced

Variables & Tokens

New Admins and editors can now edit token values and scopes directly from Grails. Turn on “Enable Editing” to reveal a pencil on each value; changes are queued for Figma rather than applied straight away, and the whole team contributes to the same batch.
New A “Review changes” panel lists every queued change with its author, the current value and the proposed one, and lets you remove any single change without discarding the rest.
Improved Values that point at another token now always show the value they finally resolve to, even through several hops or across collections that use different mode names.

Versions

Fixed a component re-extracted under a newer spec schema is no longer labelled “Modified” at a version identical to its previous one; it now reads “Spec Version Update”
Improved opening a “Spec Version Update” now says the two versions were extracted under different spec schemas and are not comparable, instead of reporting the diff as missing
Improved a component re-extracted under a newer spec schema now shows up as its own “Spec Version Update” entry, so two entries sharing a version number read as what they are instead of looking like a duplicate

July 2026

Components

Fixed switching back to the default variant in the component drawer no longer loses the active prop context; thumbnails update correctly across all prop combinations.
New Figma Asset Sync: Sincronización automática de componentes de Figma con opciones de exportación, permitiendo clasificarlos como assets y administrarlos de forma masiva por grupos.
Fixed Components that appeared as outdated immediately after a fresh batch sync (due to missing metadata) are now correctly detected and re-synced automatically.
New the components table shows a CHI health score per component and a “Published” column with its Figma library state, tracked separately from the Grails sync status.
Improved the components list opens noticeably faster on large projects, and the “Modes” column was removed.
Improved Token Adherence (TA) metric added; components not yet re-synced show a re-sync prompt instead of a blank panel
New Figma Asset Sync: Implemented automatic propagation of component export settings (PNG, SVG, etc.) to the database asset_props and enabled default asset tagging (is_asset) when sync options are active in the plugin.
Improved Sync Pipeline Cleanup: Plugin PUSH is now the sole path for component spec versioning. REST is excluded from the component pipeline, eliminating incomplete specs and false-positive diffs from non-Enterprise Figma plans.
New Storage Quota Gate: The plugin now informs users when a team has exhausted their storage quota. New components are skipped during sync when the team is over-quota, and a feedback message is shown after sync indicating which components could not be synced and why.

Figma Plugin

Improved Component variants are no longer synced as separate entities; the plugin now syncs each component set as a single unit with all variants embedded.
Improved Auto-mark assets: when enabled, components with Figma export settings are automatically classified as assets. Export settings are always synced for components that already have them, even if auto-mark is off.
Fixed Components with no previous sync history are no longer incorrectly reported as synced when evaluated; they are now correctly queued for a full re-sync.
Fixed “Changes detected” alert now only appears when previously-synced entities drifted (hash mismatch), not when there are never-synced entities pending their first sync
Improved clicking “Review Changes” from the Dashboard pre-applies the Modified filter in Review & Sync, showing only drifted entities
Improved plugin now runs a full DS scan automatically on every open, so the dashboard always shows live sync status without manual intervention
Fixed adding a new variant (or a new variant property) to a component set now correctly triggers an “outdated” status on the next scan
Improved dashboard footer simplified to a single “Update Sync Status” primary action that triggers the full scan
Improved sync progress now shows two parallel bars: metadata sync (blue) and thumbnail uploads (amber) run simultaneously, so syncing completes faster
Improved a “do not close” warning appears while thumbnails are still uploading in the background after the sync data is saved
New storage quota widget in the dashboard footer shows current usage (MB/GB), a color-coded progress bar, and a warning message when the team has exhausted their storage allowance
New components that need updating to the current Grails format now block the dashboard with a “Re-sync now” prompt that preselects exactly those entities
Fixed the dashboard shows one alert at a time in a defined priority order, so an interrupted sync is never hidden behind a lower-priority notice
Improved Selection bar is now always visible at the bottom of the screen, with the primary action button disabled by default when no items are selected.
Improved Added “Select All” and “None” bulk actions next to the selection count. “Select All” targets only the visible items in the current active tab.
Improved Selection counting is now filter-aware: switching tabs preserves the global selection but dynamically updates the counter and actions to target only the selected items visible in the active tab.
Improved Items are grouped by path prefix (e.g. “Icons”, “Buttons”) with a collapsible header and group-level select/deselect checkbox.
New Library Status filter: in files published as a Figma library, a “Library” control filters by whether each entity is published, changed since its last publish, or not published. It combines with the sync-status tabs instead of replacing them, and is hidden in files that were never published.
Improved Entities deleted from Figma no longer live behind a “Removed” tab; they now appear as a persistent notice above the list so they cannot be missed.
Fixed “Re-sync” and “Unsync” now appear for any fully-synced selection. They previously disappeared for components edited visually in Figma, even though the row still read “Synced”. Selecting a mix of states now offers a single “Sync Selected” action.
Improved filter tabs are pre-applied when navigating from the Dashboard “Changes detected” alert, landing directly on Modified entities
Fixed filter tabs now appear correctly even when all entities in the current seed are Modified (no Unsynced entities visible)
Improved when entering from a specific selection (“Sync Selected”), the screen shows only the seeded items (checked by default) and hides the segment filter tabs.
Improved commented out the WIP warning banner in the footer.
Fixed resolved a race condition where reviewSyncSeed was cleared on mount, causing the selection list to reset and show all components.
New Added ReviewUnsyncScreen to fix black-screen bug when clicking “Unsync” in the Components list

Variables & Tokens

Fixed Variable alias relationships (e.g., Color → Color Primitives) are now correctly tracked after every sync; the full token dependency graph is always up to date.

Versions

Fixed each entry in the design system changelog now shows one badge per area (Tokens, Typography, Styles) instead of sometimes repeating the same area twice, and the Styles count no longer includes typography styles
Improved clicking a component marked “Modified” now opens the changes introduced by that specific sync, instead of the component’s current state
Improved version details can now also be opened straight from a component marked “Modified” in the design system changelog, not just from the Version History timeline

June 2026

Components

Improved Outdated component warnings in the drawer now clearly notify users of modifications in Figma without showing disabled review actions.
New REST Sync Structural Parity: Implemented normalizeRestNode() to align structural representation between REST sync and Plugin API syncs, achieving ~93% parity.
Fixed Token Bindings: Resolved token bindings for bifurcated properties (such as per-axis spacing/sizing) and per-corner cornerRadius values.
New Component Depth & Build Order: Post-sync pipeline that pre-computes component_depth, children_count, and build_order from entity_edges after each DS commit, enabling O(1) reads by the API layer.

Figma Plugin

Improved The Modified filter on the Review screen now displays strictly those entities that are already synced to Grails but have a hash mismatch (modified in Figma).
Improved Split combined styles state into paintStyles and textStyles to allow independent filters, and optimized payload serializations.
Improved Components now show their current version number (e.g. v3) as a badge in the entity list and review screens.
New connect to Grails, scan any Figma file, and sync components, variables, and styles to the Vault
New Dashboard shows per-entity-type sync status cards with Modified and Removed badge counts
New first-time users land directly on Review & Sync after scanning (no intermediate Scan Results screen)
Improved Dashboard card counts show synced entities and a “of N total” sub-label
New staging area with collapsible entity groups, search, and bulk selection before sync
Improved filter tabs (All / Modified / Unsynced) to focus the staging list

Overview

Improved complete Design System Dashboard with stats cards, alerts, cadence chart, and audit score.
Improved Dashboard out-of-sync alert now displays count of outdated token collections and links directly to the tokens page.
Improved migrated design system composition and dependencies to the new unified entity relationship graph
Fixed resolved relative timestamp hydration mismatch errors in the recent activity feed
Improved each entity type (Components, Tokens, Styles, Typography) now has a distinct canonical color across all dashboard cards and charts, making it easier to identify what you’re looking at at a glance

Styles

Improved Styles now display a sync status badge next to their names, and the status filter dropdown synchronizes correctly with the URL parameters.

Team Settings

Improved Figma PAT Resolution: Fixed PAT resolution during webhook pulls by pulling team-level Figma Personal Access Tokens correctly, supporting database-level decryption.
Fixed Team Settings drawer now closes correctly after deleting or leaving a team, and the user is redirected to the teams list

Typography

Improved Typography styles now display a sync status badge next to their names, and the status filter dropdown synchronizes correctly with the URL parameters.

Variables & Tokens

Improved Token collection sidebar filter now filters collection items directly, and status badges represent collection-level synchronicity.

May 2026

Backoffice

Improved Replaced the Diff Engine Simulator with the full E2E test runner covering Components, Variables, Styles, and Account Setup suites.

April 2026

Components

New component health scores appear on the Audit (CHI) tab with four metrics and actionable suggestions
New Component Specifications (SPECs): We implemented a platform-agnostic layer to store component architecture and properties semantically, replacing raw Figma metadata. This includes deep serialization of styles, layout, and effects, with full support for differentiating between Slots (content placeholders) and Instance Swaps. This architecture is inspired by and contains attribution to the work of Nathan Curtis / Directed Edges (@directededges/specs-schema) and the Design Tokens Community Group (DTCG).
Improved Version History (CHI): New graphical interface (Component Historical Diff Drawer) to compare component versions. We eliminated technical JSON views and now structural, prop, and variant changes—including specific Slot style overrides—are presented clearly and visually.
New Schema Upgrade Status: Introduced a new ‘schema_upgrade_required’ status for components. This handles the transition between different spec versions (e.g., from v0.17 to v0.18), ensuring all data remains consistent with the latest engine.
Improved Schema Upgrade v0.18.0: Transitioned component spec properties and anatomy nodes to Dictionary (Record) structures, enabling high-performance property lookups and more precise structural diffs.
Improved Specs Engine v0.18.0 & DTCG Compliance: Upgraded the core parser to the latest spec architecture. This introduces support for Design Tokens Community Group (DTCG) compliant token references ($token/$type), advanced layout bifurcations (per-axis spacing/sizing), and improved Figma variable resolution.

Team Settings

Improved Team Storage: Unified calculation and detailed breakdown of the storage used by each team, allowing better visibility into plan limits.

Versions

New view the full structural diff of any past version directly from the Version History timeline

March 2026

Components

New browse all synced components with table and grid views

Team Settings

New configure your Figma Personal Access Token for advanced sync features
New manage team members, settings, and Figma integrations

Personal Settings

New manage your profile information and theme preferences

Versions

New track component version history, view past snapshots, and resolve sync conflicts