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