{"id":"src_p1bufugAyyAiFB5Pz-PtK","slug":"figma-code-connect","name":"Code Connect","type":"github","url":"https://github.com/figma/code-connect","orgId":"org_Lz_ApN5RiLaoJmStiEUvN","org":{"slug":"figma","name":"Figma"},"isPrimary":false,"metadata":"{\"changelogUrl\":\"https://github.com/figma/code-connect/blob/HEAD/CHANGELOG.md\",\"changelogDetectedAt\":\"2026-03-31T14:15:02.593Z\"}","releaseCount":39,"releasesLast30Days":1,"avgReleasesPerWeek":0.4,"latestVersion":"v1.4.3","latestDate":"2026-04-01T18:28:55.000Z","changelogUrl":"https://github.com/figma/code-connect/blob/HEAD/CHANGELOG.md","hasChangelogFile":true,"lastFetchedAt":"2026-04-18T14:02:26.002Z","trackingSince":"2024-04-16T15:45:21.000Z","releases":[{"id":"rel_9iFDhexsHqvZV5zkUATLn","version":"v1.4.3","title":"Code Connect 1.4.3","summary":"## Fixed\r\n\r\n### Template files\r\n\r\n- Fixed `getBoolean()` returning `undefined` instead of `false` when a boolean property is set to `false` in a templ...","content":"## Fixed\r\n\r\n### Template files\r\n\r\n- Fixed `getBoolean()` returning `undefined` instead of `false` when a boolean property is set to `false` in a template file.\r\n- Fixed some TS discrepancies in the `figma.*` API in template files\r\n- Some fixes for the migration script\r\n\r\n### Swift & Compose\r\n\r\n- Fixed args inconsistency in Swift and Compose helpers that could cause errors during template rendering.\r\n\r\n## Features\r\n\r\n### CLI\r\n\r\n- 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`).\r\n\r\n### Template files\r\n\r\n- The `migrate` command now outputs TypeScript (`.figma.ts`) files by default. Pass `--javascript` to output JavaScript (`.figma.js`) files instead.\r\n- The `migrate` command now outputs `import figma from \"figma\"` (ESM syntax) when using the `--typescript` flag\r\n- The `migrate` command now removes `__props` metadata blocks by default. Pass `--include-props` to preserve them.\r\n- Storybook connections can now be migrated by the template migration script\r\n","publishedAt":"2026-04-01T18:28:55.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.4.3","media":[]},{"id":"rel_9Ke6EwokM3bN58PhaQAR5","version":"v1.4.2","title":"Code Connect 1.4.2","summary":"## Fixed\n\n### General\n\n- Fixed incorrect `documentUrlSubstitutions` when one key is a prefix of another (e.g. `SearchInput` and `SearchInputMenu`). Th...","content":"## Fixed\n\n### General\n\n- 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.\n- 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\n- Fixed an issue around `.figma.js`/`.figma.ts` files being incorrectly treated as template files\n\n### CLI\n\n- 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.\n\n## Features\n\n### General\n\n- 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`.\n\n### Template files\n\n- Variant restrictions are now handled by the `migrate` script. These are inlined into one template file with if/else blocks.\n- TypeScript is now supported for raw template files (`.figma.template.ts` / `.figma.ts`).\n  - ESM import syntax is now supported for the Figma API: `import figma from 'figma'`\n  - Type-only imports (`import type`) are supported\n  - Other module imports are not yet supported\n  - To enable types for the `figma` API, add `\"@figma/code-connect/figma-types\"` to the `types` array in your `tsconfig.json`.\n  - JavaScript files are the default output of the `migrate` command. Can pass `--typescript` to output TypeScript (`.figma.ts`) files instead.\n","publishedAt":"2026-03-17T10:22:30.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.4.2","media":[]},{"id":"rel_Rffpu7xY8dxOy12DOm8lE","version":"v1.4.1","title":"Code Connect 1.4.1","summary":"## Fixed\r\n\r\n- Fixed issue with publishing template files without a `source` value","content":"## Fixed\r\n\r\n- Fixed issue with publishing template files without a `source` value","publishedAt":"2026-02-20T15:23:39.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.4.1","media":[]},{"id":"rel_ZatXVd4H7EseaUP19KjmV","version":"v1.4.0","title":"Code Connect 1.4.0","summary":"## Features\r\n\r\n### React\r\n\r\n- Add support for `figma.slot()` to map Figma slot layer properties in Code Connect files.\r\n\r\n### Parserless\r\n\r\n- Added a ...","content":"## Features\r\n\r\n### React\r\n\r\n- Add support for `figma.slot()` to map Figma slot layer properties in Code Connect files.\r\n\r\n### Parserless\r\n\r\n- Added a beta migration script to migrate parser-based Code Connect files to parserless templates under `figma connect migrate`.\r\n- 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.\r\n- Removed `--include-template-files` flag. Template files (`.figma.js` and `.figma.template.js`) are now always included when detected.\r\n- Add support for `instance.getSlot(name)` in templates to reference \"slot\" properties.\r\n- Parserless templates now support optional `component` and `source` comment fields (e.g., `// component=Button`)\r\n","publishedAt":"2026-02-18T12:15:08.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.4.0","media":[]},{"id":"rel_n9JadKZ566wQ2mvOBuJPh","version":"v1.3.13","title":"Code Connect 1.3.13","summary":"## Features\r\n\r\n- Add --api-url option to use a different code-connect api endpoint. This option can also be configured in figma.config.json with the `...","content":"## Features\r\n\r\n- 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\r\n- Add `language` config option to override syntax highlighting language in figma.config.json\r\n\r\n### Parserless\r\n\r\n- Syntax highlighting + formatting for parserless templates when publishing with a known label (e.g. React)\r\n\r\n## Fixed\r\n\r\n- Fix crash that occurs when the provided Figma file has no components\r\n- Set version number for annotations gradle plugin\r\n- Security update: upgraded undici to fix CVE-2026-22036. Roll back and report if you encounter networking issues.\r\n- Security update: upgraded lodash to fix CVE-2025-13465.","publishedAt":"2026-02-02T14:20:51.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.13","media":[]},{"id":"rel_iyjGblfKVOC6VAE669zsw","version":"v1.3.12","title":"Code Connect 1.3.12","summary":"## Fixed\r\n\r\n### General\r\n\r\n- Fixed a problem with path alias imports incorrectly importing index files\r\n- Fixed parsing failure for Compose in Windows...","content":"## Fixed\r\n\r\n### General\r\n\r\n- Fixed a problem with path alias imports incorrectly importing index files\r\n- Fixed parsing failure for Compose in Windows.","publishedAt":"2025-12-10T13:53:58.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.12","media":[]},{"id":"rel_hC03LGLMNenrxSzk_aREZ","version":"v1.3.11","title":"Code Connect 1.3.11","summary":"### Swift\r\n\r\n- Fixed a corner case where the swift parser generated invalid code-connect code.","content":"### Swift\r\n\r\n- Fixed a corner case where the swift parser generated invalid code-connect code.","publishedAt":"2025-11-26T10:51:40.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.11","media":[]},{"id":"rel_S0RDY8VpOmfukyaboZq1F","version":"v1.3.10","title":"Code Connect 1.3.10","summary":"### General\r\n\r\n- Updated glob dependency to 11.0.4 to fix security vulnerability","content":"### General\r\n\r\n- Updated glob dependency to 11.0.4 to fix security vulnerability","publishedAt":"2025-11-19T15:18:00.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.10","media":[]},{"id":"rel_6G751M9P25H08qMCysHEv","version":"v1.3.9","title":"Code Connect 1.3.9","summary":"## Fixed\r\n\r\n### General\r\n\r\n- Improve response of publish command to display succeeded and failed nodes\r\n\r\n### Compose / Swift\r\n\r\n- Fixed parsing failu...","content":"## Fixed\r\n\r\n### General\r\n\r\n- Improve response of publish command to display succeeded and failed nodes\r\n\r\n### Compose / Swift\r\n\r\n- Fixed parsing failure in `create` command","publishedAt":"2025-11-14T15:33:54.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.9","media":[]},{"id":"rel_dRk62FL_GkuUYgXh65N_C","version":"v1.3.8","title":"Code Connect 1.3.8","summary":"## Fixed\r\n\r\n### Compose\r\n\r\n- Fixed an issue where if there were multiple modules/files connecting to the same FigmaNode the parser only recognize the ...","content":"## Fixed\r\n\r\n### Compose\r\n\r\n- Fixed an issue where if there were multiple modules/files connecting to the same FigmaNode the parser only recognize the first module/file found.\r\n- Update `libs.versions.toml` Kotlin version to `2.2.21`. ","publishedAt":"2025-10-29T17:26:37.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.8","media":[]},{"id":"rel_AtnmOtrZD0Ttfst4Sxqjz","version":"v1.3.7","title":"Code Connect 1.3.7","summary":"## Fixed\r\n\r\n### General\r\n\r\n- `unpublish` command showing success message in certain cases where the action didn't complete properlty.\r\n- Fixed path al...","content":"## Fixed\r\n\r\n### General\r\n\r\n- `unpublish` command showing success message in certain cases where the action didn't complete properlty.\r\n- Fixed path alias imports not being resolved.\r\n\r\n### Compose\r\n\r\n- Released a new [Code Connect plugin](https://mvnrepository.com/artifact/com.figma.code.connect/plugin) version (1.2.3) that works with JDK 17.\r\n- Fixed an issue that was happening in the parser where special characters weren't escaped properly, causing snippets to fail to evaluate.\r\n\r\n### SwiftUI\r\n\r\n- 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)\r\n","publishedAt":"2025-10-22T14:03:38.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.7","media":[]},{"id":"rel_JkAmzf77IAnnmo_KMSjLI","version":"v1.3.6","title":"Code Connect 1.3.6","summary":"## Fixed\r\n\r\n### General\r\n\r\n- Updated `npx connect unpublish --node` to require a `--label` param so it can unpublish any label type.\r\n\r\n### Compose\r\n\r...","content":"## Fixed\r\n\r\n### General\r\n\r\n- Updated `npx connect unpublish --node` to require a `--label` param so it can unpublish any label type.\r\n\r\n### Compose\r\n\r\n- Fixed parsing issue with multi-module projects.\r\n\r\n### SwiftUI\r\n\r\n- Updated `swift-syntax` to support 602.0.0. Thanks to @luispadron for the [PR](https://github.com/figma/code-connect/pull/274)\r\n- Fixed protocol inheritance for Swift 6.2. Thanks to @rmenezes for the [PR](https://github.com/figma/code-connect/pull/317)\r\n","publishedAt":"2025-09-26T11:25:37.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.6","media":[]},{"id":"rel_2eQTsyw6qWjceKtxQx4HR","version":"v1.3.5","title":"Code Connect 1.3.5","summary":"## Fixed\r\n\r\n### General\r\n\r\n- Fixed \"Failed to fetch embeddings\" error if empty payload in interactive setup\r\n- Retain the temporary file and directory...","content":"## Fixed\r\n\r\n### General\r\n\r\n- Fixed \"Failed to fetch embeddings\" error if empty payload in interactive setup\r\n- Retain the temporary file and directory when `--verbose` is enabled for improved debugging. \r\n\r\n### SwiftUI\r\n\r\n- Fixed SourcePackages directory not found.\r\n- Added optional sourcePackagesPath parameter for when the default derived data folder is not used. \r\n- Updated `swift-syntax` to support 601.0.1. ","publishedAt":"2025-09-05T07:48:54.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.5","media":[]},{"id":"rel_qzrxTJ3quRW7LAy8raake","version":"v1.3.4","title":"Code Connect 1.3.4","summary":"## Fixed\r\n\r\n### React\r\n\r\n- Support getProps inside nestedProps","content":"## Fixed\r\n\r\n### React\r\n\r\n- Support getProps inside nestedProps","publishedAt":"2025-06-27T10:41:12.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.4","media":[]},{"id":"rel_wUc6FsNoLykDVSlfK5ng_","version":"v1.3.3","title":"Code Connect 1.3.3","summary":"## Features\r\n\r\n### Compose\r\n- Enhanced `--verbose` command to output detailed stacktrace.\r\n\r\n## Fixed\r\n\r\n### General\r\n- Bumped Undici version to addre...","content":"## Features\r\n\r\n### Compose\r\n- Enhanced `--verbose` command to output detailed stacktrace.\r\n\r\n## Fixed\r\n\r\n### General\r\n- Bumped Undici version to address security issue","publishedAt":"2025-05-27T09:23:59.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.3","media":[]},{"id":"rel_oEJlweVgrIkTgUWjbLdfx","version":"v1.3.2","title":"Code Connect 1.3.2","summary":"## Fixed\r\n\r\n### General\r\n- Added support for GitHub Enterprise source links (fixes https://github.com/figma/code-connect/issues/259)\r\n\r\n### React\r\n- F...","content":"## Fixed\r\n\r\n### General\r\n- Added support for GitHub Enterprise source links (fixes https://github.com/figma/code-connect/issues/259)\r\n\r\n### React\r\n- Fixed incompatibility issue with React 19 (fixes https://github.com/figma/code-connect/issues/265)\r\n- Fixed issue with numeric characters in property names\r\n\r\n### HTML\r\n- Allow examples to return strings to support icon IDs (fixes https://github.com/figma/code-connect/issues/252)","publishedAt":"2025-04-04T16:59:52.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.2","media":[]},{"id":"rel_sJqkmOTQkSsPJTO6aBSfx","version":"v1.3.1","title":"Code Connect v1.3.1","summary":"## Fixed\r\n- Allow .gradle files to be detected as Android/Compose projects. Thanks to @sebastienrouif for the [PR](https://github.com/figma/code-conne...","content":"## Fixed\r\n- Allow .gradle files to be detected as Android/Compose projects. Thanks to @sebastienrouif for the [PR](https://github.com/figma/code-connect/pull/237)\r\n- Remove prompts patching (fixes https://github.com/figma/code-connect/issues/241)\r\n\r\n## Features\r\n- Added `interactiveSetupFigmaFileUrl` to the interactive setup, allowing you to specify the Figma file to use for connecting components in your `figma.config.json` file.\r\n- 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/).\r\n\r\n### SwiftUI\r\n- Updated `swift-syntax` to point to the new URL. Thanks to @pontusJPaf for the [PR](https://github.com/figma/code-connect/pull/239).","publishedAt":"2025-02-14T14:56:17.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.1","media":[]},{"id":"rel_hwTFsvQo-F-Nk7RrkFE4w","version":"v1.3.0","title":"Code Connect 1.3.0","summary":"## Features\r\n- Add support for JSX Figma connection files.\r\n- Added an option to automatically create or append the access token to the project's .env...","content":"## Features\r\n- Add support for JSX Figma connection files.\r\n- Added an option to automatically create or append the access token to the project's .env file\r\n- Add better handling of many figma components in the wizard (grouping per page)\r\n- Allow variant restrictions to use boolean-like properties\r\n\r\n### General\r\n- Added support for Bitbucket, Gitlab and Azure DevOps for generated source file URLs\r\n\r\n## Fixed\r\n- Don't show a red-cross when the file-matching prompt is finished in the wizard\r\n- Add default values for `@FigmaEnum` declarations in SwiftUI\r\n\r\n### SwiftUI\r\n- Fixed a formatting error when running the CLI\r\n\r\n### React\r\n- Fix nested objects and arrays in props not rendering properly in code snippets\r\n- Fixed a type issue when passing functions as values to `figma.boolean`\r\n- Add support for multiple exports per file in the wizard\r\n\r\n### Storybook\r\n- Add support for different props per example (fixes https://github.com/figma/code-connect/issues/143)\r\n- Add support for `links` and `imports` (fixes https://github.com/figma/code-connect/issues/142)\r\n","publishedAt":"2025-01-28T18:05:09.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.3.0","media":[]},{"id":"rel_4Q306LcMnhUON21foowxu","version":"v1.2.4","title":"Code Connect 1.2.4","summary":"## Fixed\r\n- (from 1.2.3) In the interactive setup, the automatic file linking now matches components exported from index files\r\n- Fix issue with CLI n...","content":"## Fixed\r\n- (from 1.2.3) In the interactive setup, the automatic file linking now matches components exported from index files\r\n- Fix issue with CLI not working on some cases in 1.2.3\r\n\r\n### React\r\n- (from 1.2.3) Fix issue where React component references in `props` would serialize to strings when accessed with `getProps()`\r\n- (from 1.2.3) Fix issue with nesting `figma.boolean` and `getProps`\r\n\r\n","publishedAt":"2024-12-05T17:43:40.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.2.4","media":[]},{"id":"rel_-O9rMeAgsLeCz7tt44Bn8","version":"v1.2.3","title":"Code Connect 1.2.3","summary":"## Features\r\n\r\n## Fixed\r\n- In the interactive setup, the automatic file linking now matches components exported from index files\r\n\r\n### React\r\n- Fix i...","content":"## Features\r\n\r\n## Fixed\r\n- In the interactive setup, the automatic file linking now matches components exported from index files\r\n\r\n### React\r\n- Fix issue where React component references in `props` would serialize to strings when accessed with `getProps()`\r\n- Fix issue with nesting `figma.boolean` and `getProps`\r\n","publishedAt":"2024-12-05T16:04:50.000Z","url":"https://github.com/figma/code-connect/releases/tag/v1.2.3","media":[]}],"pagination":{"page":1,"pageSize":20,"totalPages":2,"totalItems":39},"summaries":{"rolling":{"windowDays":90,"summary":"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.","releaseCount":4,"generatedAt":"2026-03-31T14:15:04.744Z"},"monthly":[]}}