tokens-bruecke 3.27.0 → 3.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,25 @@
1
+ ## [3.28.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.27.0...v3.28.0) (2026-11-19)
2
+
3
+ ### Features
4
+
5
+ - **plugin:** the main view has **Export** and **Import** tabs. Under **Pull from server**, the Import tab lists the servers of the profile, and the ↻ button of a server reads the tokens a push writes and imports them into the variables, after a confirmation that names the files and collections. GitHub and GitLab read every file of a split export in one import, so aliases between files resolve in any order; JSONBin and custom URLs read their JSON. Collections unchecked in the collection picker aren't read. **Import from JSON file** moved to the same tab. Pulls run in Figma Design only, not in Dev Mode ([#158](https://github.com/tokens-bruecke/figma-plugin/issues/158)) ([#161](https://github.com/tokens-bruecke/figma-plugin/pull/161))
6
+ - **plugin:** a server can be set to **Use for pulling only** or **Use for pushing only**. A server added on the Import tab only pulls, so a read-only access token or a URL that only serves JSON works without failing pushes ([#161](https://github.com/tokens-bruecke/figma-plugin/pull/161))
7
+
8
+ ### Bug fixes
9
+
10
+ - **import:** tokens exported with **Include Figma metadata** bring back the code syntax of each platform, and empty `scopes` hide the variable from every picker again, so a file round-trips to another file unchanged ([#162](https://github.com/tokens-bruecke/figma-plugin/pull/162))
11
+ - **plugin:** a window height set with the resizer stays when you switch tabs, and a view shorter than it fits its content instead of leaving empty space below ([#161](https://github.com/tokens-bruecke/figma-plugin/pull/161))
12
+
13
+ ### Behaviour changes
14
+
15
+ - **plugin:** the anonymous usage counts also note pulls and failed pulls by server type, and opening the Import tab. The privacy page lists every event ([#161](https://github.com/tokens-bruecke/figma-plugin/pull/161)) ([#163](https://github.com/tokens-bruecke/figma-plugin/pull/163))
16
+
17
+ ### Documentation
18
+
19
+ - **docs:** the Push to server page describes pulling, with screenshots of the Import tab. The import, Figma metadata and window height sections are updated ([#161](https://github.com/tokens-bruecke/figma-plugin/pull/161)) ([#163](https://github.com/tokens-bruecke/figma-plugin/pull/163))
20
+
21
+ Thanks to [@eduaugustus](https://github.com/eduaugustus) for asking for pulls in [#158](https://github.com/tokens-bruecke/figma-plugin/issues/158) and testing the preview build against GitLab.
22
+
1
23
  ## [3.27.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.26.0...v3.27.0) (2026-11-16)
2
24
 
3
25
  ### Features
package/README.md CHANGED
@@ -9,17 +9,17 @@
9
9
 
10
10
  TokensBruecke exports Figma variables and styles as design tokens JSON compatible with the [DTCG 2025.10 specification](https://www.designtokens.org/tr/2025.10/format/), and imports tokens back into Figma variables. Use it as a Figma plugin, as a CLI in CI and agent workflows, or as a library in your build.
11
11
 
12
- **📖 Documentation: [tokens-bruecke.github.io/figma-plugin](https://tokens-bruecke.github.io/figma-plugin/)**
12
+ **📖 Documentation: [tokensbruecke.com](https://tokensbruecke.com/)**
13
13
 
14
14
  ## Figma plugin
15
15
 
16
16
  1. Install the plugin from the [Figma Community](https://www.figma.com/community/plugin/1254538877056388290).
17
- 2. Run it in any Figma file and adjust the [settings](https://tokens-bruecke.github.io/figma-plugin/plugin/settings/).
18
- 3. Download the JSON file or [push it to a server](https://tokens-bruecke.github.io/figma-plugin/plugin/push-to-server/): JSONBin, GitHub, a GitHub pull request, GitLab, a GitLab merge request or your own endpoint.
17
+ 2. Run it in any Figma file and adjust the [settings](https://tokensbruecke.com/plugin/settings/).
18
+ 3. Download the JSON file or [push it to a server](https://tokensbruecke.com/plugin/push-to-server/): JSONBin, GitHub, a GitHub pull request, GitLab, a GitLab merge request or your own endpoint.
19
19
 
20
- The plugin also runs in [Dev Mode](https://tokens-bruecke.github.io/figma-plugin/plugin/dev-mode/), so developers can export tokens themselves; [share a profile in the file](https://tokens-bruecke.github.io/figma-plugin/plugin/profiles/#shared-profiles) to give them your settings.
20
+ The plugin also runs in [Dev Mode](https://tokensbruecke.com/plugin/dev-mode/), so developers can export tokens themselves; [share a profile in the file](https://tokensbruecke.com/plugin/profiles/#shared-profiles) to give them your settings.
21
21
 
22
- A file without variables opens on an empty screen, where you can [import tokens](https://tokens-bruecke.github.io/figma-plugin/getting-started/export-and-import/) or continue to export styles only.
22
+ A file without variables opens on an empty screen, where you can [import tokens](https://tokensbruecke.com/getting-started/export-and-import/) or continue to export styles only.
23
23
 
24
24
  ## Use as cli tool
25
25
 
@@ -36,7 +36,7 @@ npx tokens-bruecke@latest --input snapshot.json --output out/tokens.json
36
36
  npx tokens-bruecke@latest init
37
37
  ```
38
38
 
39
- See the [CLI docs](https://tokens-bruecke.github.io/figma-plugin/cli/overview/) for every [option](https://tokens-bruecke.github.io/figma-plugin/cli/options/), the configuration file and the snapshot format. Agents can start from [llms.txt](llms.txt) and the [agent skill](skills/tokens-bruecke/SKILL.md).
39
+ See the [CLI docs](https://tokensbruecke.com/cli/overview/) for every [option](https://tokensbruecke.com/cli/options/), the configuration file and the snapshot format. Agents can start from [llms.txt](llms.txt) and the [agent skill](skills/tokens-bruecke/SKILL.md).
40
40
 
41
41
  ## Use as a library
42
42
 
@@ -52,28 +52,28 @@ const tokens = await fetchTokens({
52
52
  const fromSnapshot = await convertTokens(snapshot, { splitByCollection: true });
53
53
  ```
54
54
 
55
- See [Use as a library](https://tokens-bruecke.github.io/figma-plugin/library/) for results, warnings and error codes.
55
+ See [Use as a library](https://tokensbruecke.com/library/) for results, warnings and error codes.
56
56
 
57
57
  ## Documentation
58
58
 
59
59
  | Topic | |
60
60
  | --- | --- |
61
- | [Export and import](https://tokens-bruecke.github.io/figma-plugin/getting-started/export-and-import/) | What gets exported, and what to know before importing |
62
- | [Settings](https://tokens-bruecke.github.io/figma-plugin/plugin/settings/) and [advanced settings](https://tokens-bruecke.github.io/figma-plugin/plugin/advanced-settings/) | Color modes, styles, DTCG format, splitting files, scopes and more |
63
- | [Push to server](https://tokens-bruecke.github.io/figma-plugin/plugin/push-to-server/) | JSONBin, GitHub, GitHub PR, GitLab, GitLab MR and custom servers |
64
- | [Profiles](https://tokens-bruecke.github.io/figma-plugin/plugin/profiles/) | Multiple profiles, and profiles shared in the Figma file |
65
- | [Output and window](https://tokens-bruecke.github.io/figma-plugin/plugin/output/) | Code preview and window height |
66
- | [Dev Mode](https://tokens-bruecke.github.io/figma-plugin/plugin/dev-mode/) | Exporting tokens from Dev Mode and Figma for VS Code |
67
- | [Token structure](https://tokens-bruecke.github.io/figma-plugin/reference/token-structure/) | How collections, groups and modes map to JSON |
68
- | [Aliases](https://tokens-bruecke.github.io/figma-plugin/reference/aliases/) | Aliases, color aliases with opacity, library variables |
69
- | [Styles support](https://tokens-bruecke.github.io/figma-plugin/reference/styles/) | Typography, colors, grids, shadows and blur |
70
- | [Types and scopes](https://tokens-bruecke.github.io/figma-plugin/reference/types/) | Variable types, motion variables and scopes |
61
+ | [Export and import](https://tokensbruecke.com/getting-started/export-and-import/) | What gets exported, and what to know before importing |
62
+ | [Settings](https://tokensbruecke.com/plugin/settings/) and [advanced settings](https://tokensbruecke.com/plugin/advanced-settings/) | Color modes, styles, DTCG format, splitting files, scopes and more |
63
+ | [Push to server](https://tokensbruecke.com/plugin/push-to-server/) | JSONBin, GitHub, GitHub PR, GitLab, GitLab MR and custom servers |
64
+ | [Profiles](https://tokensbruecke.com/plugin/profiles/) | Multiple profiles, and profiles shared in the Figma file |
65
+ | [Output and window](https://tokensbruecke.com/plugin/output/) | Code preview and window height |
66
+ | [Dev Mode](https://tokensbruecke.com/plugin/dev-mode/) | Exporting tokens from Dev Mode and Figma for VS Code |
67
+ | [Token structure](https://tokensbruecke.com/reference/token-structure/) | How collections, groups and modes map to JSON |
68
+ | [Aliases](https://tokensbruecke.com/reference/aliases/) | Aliases, color aliases with opacity, library variables |
69
+ | [Styles support](https://tokensbruecke.com/reference/styles/) | Typography, colors, grids, shadows and blur |
70
+ | [Types and scopes](https://tokensbruecke.com/reference/types/) | Variable types, motion variables and scopes |
71
71
 
72
72
  The documentation lives in [`docs/`](docs). See [CONTRIBUTING.md](CONTRIBUTING.md) to run it locally and to regenerate the screenshots.
73
73
 
74
74
  ## Privacy and analytics
75
75
 
76
- The plugin counts a few anonymous usage events with [GoatCounter](https://www.goatcounter.com). It never sends your tokens, names, server URLs, access tokens or anything else read from your Figma file. See [Privacy](https://tokens-bruecke.github.io/figma-plugin/privacy/) for the full list.
76
+ The plugin counts a few anonymous usage events with [GoatCounter](https://www.goatcounter.com). It never sends your tokens, names, server URLs, access tokens or anything else read from your Figma file. See [Privacy](https://tokensbruecke.com/privacy/) for the full list.
77
77
 
78
78
  ## Feedback
79
79