---
name: Code Connect
slug: figma-code-connect
type: github
source_url: https://github.com/figma/code-connect
changelog_url: https://github.com/figma/code-connect/blob/HEAD/CHANGELOG.md
organization: Figma
organization_slug: figma
total_releases: 39
latest_version: v1.4.3
latest_date: 2026-04-01
last_updated: 2026-04-18
tracking_since: 2024-04-16
canonical: https://releases.sh/figma/figma-code-connect
organization_url: https://releases.sh/figma
---

<Summary type="rolling" window-days="90" release-count="4">
Code Connect shifted toward making template-based workflows smoother and more flexible. The team added `figma.slot()` support for React to map Figma slot properties, shipped a migration script to help teams move from parser-based files to the newer parserless template format, and expanded branch detection to handle non-standard default branch names beyond `master` and `main`. Along the way, fixes landed for prefix collision bugs in URL substitutions and automatic retry logic for rate-limited publishes.
</Summary>

<Release version="v1.4.3" date="April 1, 2026" published="2026-04-01T18:28:55.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.4.3">
## Code Connect 1.4.3

## 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

</Release>

<Release version="v1.4.2" date="March 17, 2026" published="2026-03-17T10:22:30.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.4.2">
## Code Connect 1.4.2

## 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.

</Release>

<Release version="v1.4.1" date="February 20, 2026" published="2026-02-20T15:23:39.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.4.1">
## Code Connect 1.4.1

## Fixed

- Fixed issue with publishing template files without a `source` value
</Release>

<Release version="v1.4.0" date="February 18, 2026" published="2026-02-18T12:15:08.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.4.0">
## Code Connect 1.4.0

## 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`)

</Release>

<Release version="v1.3.13" date="February 2, 2026" published="2026-02-02T14:20:51.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.13">
## Code Connect 1.3.13

## 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.
</Release>

<Release version="v1.3.12" date="December 10, 2025" published="2025-12-10T13:53:58.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.12">
## Code Connect 1.3.12

## Fixed

### General

- Fixed a problem with path alias imports incorrectly importing index files
- Fixed parsing failure for Compose in Windows.
</Release>

<Release version="v1.3.11" date="November 26, 2025" published="2025-11-26T10:51:40.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.11">
## Code Connect 1.3.11

### Swift

- Fixed a corner case where the swift parser generated invalid code-connect code.
</Release>

<Release version="v1.3.10" date="November 19, 2025" published="2025-11-19T15:18:00.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.10">
## Code Connect 1.3.10

### General

- Updated glob dependency to 11.0.4 to fix security vulnerability
</Release>

<Release version="v1.3.9" date="November 14, 2025" published="2025-11-14T15:33:54.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.9">
## Code Connect 1.3.9

## Fixed

### General

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

### Compose / Swift

- Fixed parsing failure in `create` command
</Release>

<Release version="v1.3.8" date="October 29, 2025" published="2025-10-29T17:26:37.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.8">
## Code Connect 1.3.8

## 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`. 
</Release>

<Release version="v1.3.7" date="October 22, 2025" published="2025-10-22T14:03:38.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.7">
## Code Connect 1.3.7

## 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](https://mvnrepository.com/artifact/com.figma.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](https://github.com/figma/code-connect/pull/327)

</Release>

<Release version="v1.3.6" date="September 26, 2025" published="2025-09-26T11:25:37.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.6">
## Code Connect 1.3.6

## 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](https://github.com/figma/code-connect/pull/274)
- Fixed protocol inheritance for Swift 6.2. Thanks to @rmenezes for the [PR](https://github.com/figma/code-connect/pull/317)

</Release>

<Release version="v1.3.5" date="September 5, 2025" published="2025-09-05T07:48:54.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.5">
## Code Connect 1.3.5

## 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. 
</Release>

<Release version="v1.3.4" date="June 27, 2025" published="2025-06-27T10:41:12.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.4">
## Code Connect 1.3.4

## Fixed

### React

- Support getProps inside nestedProps
</Release>

<Release version="v1.3.3" date="May 27, 2025" published="2025-05-27T09:23:59.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.3">
## Code Connect 1.3.3

## Features

### Compose
- Enhanced `--verbose` command to output detailed stacktrace.

## Fixed

### General
- Bumped Undici version to address security issue
</Release>

<Release version="v1.3.2" date="April 4, 2025" published="2025-04-04T16:59:52.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.2">
## Code Connect 1.3.2

## 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)
</Release>

<Release version="v1.3.1" date="February 14, 2025" published="2025-02-14T14:56:17.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.1">
## Code Connect v1.3.1

## Fixed
- Allow .gradle files to be detected as Android/Compose projects. Thanks to @sebastienrouif for the [PR](https://github.com/figma/code-connect/pull/237)
- 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](https://www.figma.com/code-connect-docs/no-parser/).

### SwiftUI
- Updated `swift-syntax` to point to the new URL. Thanks to @pontusJPaf for the [PR](https://github.com/figma/code-connect/pull/239).
</Release>

<Release version="v1.3.0" date="January 28, 2025" published="2025-01-28T18:05:09.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.3.0">
## Code Connect 1.3.0

## 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)

</Release>

<Release version="v1.2.4" date="December 5, 2024" published="2024-12-05T17:43:40.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.2.4">
## Code Connect 1.2.4

## 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`


</Release>

<Release version="v1.2.3" date="December 5, 2024" published="2024-12-05T16:04:50.000Z" url="https://github.com/figma/code-connect/releases/tag/v1.2.3">
## Code Connect 1.2.3

## 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`

</Release>

<Pagination page="1" total-pages="2" total-items="39" next="https://releases.sh/figma/figma-code-connect.md?page=2" />