Code Connect

Fixed

Template files

• Fixed getBoolean() returning undefined instead of false when a boolean property is set to false in a template file.
• Fixed some TS discrepancies in the figma.* API in template files
• Some fixes for the migration script

Swift & Compose

• Fixed args inconsistency in Swift and Compose helpers that could cause errors during template rendering.

Features

CLI

• Added --file (-f) option to parse, publish, and unpublish commands to process a single Code Connect file instead of the entire project (e.g. figma connect parse --file=src/Button.figma.tsx).

Template files

• The migrate command now outputs TypeScript (.figma.ts) files by default. Pass --javascript to output JavaScript (.figma.js) files instead.
• The migrate command now outputs import figma from "figma" (ESM syntax) when using the --typescript flag
• The migrate command now removes __props metadata blocks by default. Pass --include-props to preserve them.
• Storybook connections can now be migrated by the template migration script

Fixed

General

• Fixed incorrect documentUrlSubstitutions when one key is a prefix of another (e.g. SearchInput and SearchInputMenu). The CLI now processes longer keys first so the correct substitution is applied.
• Publishing with --batch-size now retries automatically on rate-limit (429) and server error (5xx) responses, respecting the Retry-After header when present, rather than failing immediately
• Fixed an issue around .figma.js/.figma.ts files being incorrectly treated as template files

CLI

• The --include-template-files flag now shows a deprecation warning instead of causing an error. The flag is no longer necessary as template files are automatically included by default.

Features

General

• Code Connect now supports default branch names other than master/main. For cases where it can't be detected automatically, you can set defaultBranch in your figma.config.json.

Template files

• Variant restrictions are now handled by the migrate script. These are inlined into one template file with if/else blocks.
• TypeScript is now supported for raw template files (.figma.template.ts / .figma.ts).
  • ESM import syntax is now supported for the Figma API: import figma from 'figma'
  • Type-only imports (import type) are supported
  • Other module imports are not yet supported
  • To enable types for the figma API, add "@figma/code-connect/figma-types" to the types array in your tsconfig.json.
  • JavaScript files are the default output of the migrate command. Can pass --typescript to output TypeScript (.figma.ts) files instead.

Fixed

• Fixed issue with publishing template files without a source value

Features

React

• Add support for figma.slot() to map Figma slot layer properties in Code Connect files.

Parserless

• Added a beta migration script to migrate parser-based Code Connect files to parserless templates under figma connect migrate.
• The default extension for parserless/template files is now .figma.js instead of .figma.template.js. The old .figma.template.js extension is still fully supported for backwards compatibility.
• Removed --include-template-files flag. Template files (.figma.js and .figma.template.js) are now always included when detected.
• Add support for instance.getSlot(name) in templates to reference "slot" properties.
• Parserless templates now support optional component and source comment fields (e.g., // component=Button)

Features

• Add --api-url option to use a different code-connect api endpoint. This option can also be configured in figma.config.json with the apiUrl field
• Add language config option to override syntax highlighting language in figma.config.json

Parserless

• Syntax highlighting + formatting for parserless templates when publishing with a known label (e.g. React)

Fixed

• Fix crash that occurs when the provided Figma file has no components
• Set version number for annotations gradle plugin
• Security update: upgraded undici to fix CVE-2026-22036. Roll back and report if you encounter networking issues.
• Security update: upgraded lodash to fix CVE-2025-13465.

Fixed

General

• Fixed a problem with path alias imports incorrectly importing index files
• Fixed parsing failure for Compose in Windows.

Swift

• Fixed a corner case where the swift parser generated invalid code-connect code.

General

• Updated glob dependency to 11.0.4 to fix security vulnerability

Fixed

General

• Improve response of publish command to display succeeded and failed nodes

Compose / Swift

• Fixed parsing failure in create command

Fixed

Compose

• Fixed an issue where if there were multiple modules/files connecting to the same FigmaNode the parser only recognize the first module/file found.
• Update libs.versions.toml Kotlin version to 2.2.21.

Fixed

General

• unpublish command showing success message in certain cases where the action didn't complete properlty.
• Fixed path alias imports not being resolved.

Compose

• Released a new Code Connect plugin version (1.2.3) that works with JDK 17.
• Fixed an issue that was happening in the parser where special characters weren't escaped properly, causing snippets to fail to evaluate.

SwiftUI

• Fixed swift-syntax dependency to include support for 602.0.0. Thanks to @luispadron for the PR

Fixed

General

• Updated npx connect unpublish --node to require a --label param so it can unpublish any label type.

Compose

• Fixed parsing issue with multi-module projects.

SwiftUI

• Updated swift-syntax to support 602.0.0. Thanks to @luispadron for the PR
• Fixed protocol inheritance for Swift 6.2. Thanks to @rmenezes for the PR

Fixed

General

• Fixed "Failed to fetch embeddings" error if empty payload in interactive setup
• Retain the temporary file and directory when --verbose is enabled for improved debugging.

SwiftUI

• Fixed SourcePackages directory not found.
• Added optional sourcePackagesPath parameter for when the default derived data folder is not used.
• Updated swift-syntax to support 601.0.1.

Fixed

React

• Support getProps inside nestedProps

Features

Compose

• Enhanced --verbose command to output detailed stacktrace.

Fixed

General

• Bumped Undici version to address security issue

Fixed

General

• Added support for GitHub Enterprise source links (fixes https://github.com/figma/code-connect/issues/259)

React

• Fixed incompatibility issue with React 19 (fixes https://github.com/figma/code-connect/issues/265)
• Fixed issue with numeric characters in property names

HTML

• Allow examples to return strings to support icon IDs (fixes https://github.com/figma/code-connect/issues/252)

Fixed

• Allow .gradle files to be detected as Android/Compose projects. Thanks to @sebastienrouif for the PR
• Remove prompts patching (fixes https://github.com/figma/code-connect/issues/241)

Features

• Added interactiveSetupFigmaFileUrl to the interactive setup, allowing you to specify the Figma file to use for connecting components in your figma.config.json file.
• Rename --include-raw-templates flag to --include-template-files. Further details of this feature can be found in the documentation.

SwiftUI

• Updated swift-syntax to point to the new URL. Thanks to @pontusJPaf for the PR.

Features

• Add support for JSX Figma connection files.
• Added an option to automatically create or append the access token to the project's .env file
• Add better handling of many figma components in the wizard (grouping per page)
• Allow variant restrictions to use boolean-like properties

General

• Added support for Bitbucket, Gitlab and Azure DevOps for generated source file URLs

Fixed

• Don't show a red-cross when the file-matching prompt is finished in the wizard
• Add default values for @FigmaEnum declarations in SwiftUI

SwiftUI

• Fixed a formatting error when running the CLI

React

• Fix nested objects and arrays in props not rendering properly in code snippets
• Fixed a type issue when passing functions as values to figma.boolean
• Add support for multiple exports per file in the wizard

Storybook

• Add support for different props per example (fixes https://github.com/figma/code-connect/issues/143)
• Add support for links and imports (fixes https://github.com/figma/code-connect/issues/142)

Fixed

• (from 1.2.3) In the interactive setup, the automatic file linking now matches components exported from index files
• Fix issue with CLI not working on some cases in 1.2.3

React

• (from 1.2.3) Fix issue where React component references in props would serialize to strings when accessed with getProps()
• (from 1.2.3) Fix issue with nesting figma.boolean and getProps

Features

Fixed

• In the interactive setup, the automatic file linking now matches components exported from index files

React

• Fix issue where React component references in props would serialize to strings when accessed with getProps()
• Fix issue with nesting figma.boolean and getProps