tokens-bruecke 3.26.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 +39 -1
- package/README.md +18 -18
- package/bin/cli.js +1 -1
- package/global.d.ts +25 -0
- package/llms.txt +4 -4
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,41 @@
|
|
|
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
|
+
|
|
23
|
+
## [3.27.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.26.0...v3.27.0) (2026-11-16)
|
|
24
|
+
|
|
25
|
+
### Features
|
|
26
|
+
|
|
27
|
+
- **plugin:** with "Split collections" or "Split modes" on, a **Collections** row under the servers opens a list of the file's collections. GitHub, GitHub PR, GitLab and GitLab MR only commit the files of the checked ones, and the files of unchecked collections stay in the repository as they are. All collections are checked by default, the selection is saved in the profile, and the button says e.g. **Push 2 of 3 collections** when some are left out. Downloads, JSONBin, custom URLs and the CLI always include every collection ([#150](https://github.com/tokens-bruecke/figma-plugin/issues/150)) ([dc0eefb](https://github.com/tokens-bruecke/figma-plugin/commit/dc0eefbc662c518430a181c3477436c9841953cc))
|
|
28
|
+
|
|
29
|
+
### Behaviour changes
|
|
30
|
+
|
|
31
|
+
- **plugin:** the anonymous usage counts also note when the plugin opens in Dev Mode, when **Test connection** runs, when a Git push leaves collections out, and when a profile is shared, shared again, unshared, added from the file or updated from it. The privacy page lists every event ([9c96bdd](https://github.com/tokens-bruecke/figma-plugin/commit/9c96bddf00a6f949c35ffb353a923c319fe20197))
|
|
32
|
+
|
|
33
|
+
### Documentation
|
|
34
|
+
|
|
35
|
+
- **docs:** the Push to server page describes the collection picker, with screenshots of the Collections row and page ([#150](https://github.com/tokens-bruecke/figma-plugin/issues/150)) ([dc0eefb](https://github.com/tokens-bruecke/figma-plugin/commit/dc0eefbc662c518430a181c3477436c9841953cc)) ([054cdae](https://github.com/tokens-bruecke/figma-plugin/commit/054cdae19ebe0c788363cb2957e4cc5042d32151))
|
|
36
|
+
|
|
37
|
+
Thanks to [@eduaugustus](https://github.com/eduaugustus) for suggesting the collection picker in [#150](https://github.com/tokens-bruecke/figma-plugin/issues/150).
|
|
38
|
+
|
|
1
39
|
## [3.26.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.25.0...v3.26.0) (2026-11-15)
|
|
2
40
|
|
|
3
41
|
### Features
|
|
@@ -6,7 +44,7 @@
|
|
|
6
44
|
|
|
7
45
|
### Behaviour changes
|
|
8
46
|
|
|
9
|
-
- **plugin:** in the server menu, GitLab now has the caption
|
|
47
|
+
- **plugin:** in the server menu, GitLab now has the caption _Commit_ and GitLab MR _Merge request_, like the two GitHub servers. Menu captions are faded, so they read as hints next to the name ([#149](https://github.com/tokens-bruecke/figma-plugin/issues/149)) ([#151](https://github.com/tokens-bruecke/figma-plugin/issues/151)) ([1f86dc3](https://github.com/tokens-bruecke/figma-plugin/commit/1f86dc387f6fe4ff3efdcf33af63181d605f8483))
|
|
10
48
|
|
|
11
49
|
### Bug Fixes
|
|
12
50
|
|
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: [
|
|
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://
|
|
18
|
-
3. Download the JSON file or [push it to a server](https://
|
|
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://
|
|
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://
|
|
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://
|
|
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://
|
|
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://
|
|
62
|
-
| [Settings](https://
|
|
63
|
-
| [Push to server](https://
|
|
64
|
-
| [Profiles](https://
|
|
65
|
-
| [Output and window](https://
|
|
66
|
-
| [Dev Mode](https://
|
|
67
|
-
| [Token structure](https://
|
|
68
|
-
| [Aliases](https://
|
|
69
|
-
| [Styles support](https://
|
|
70
|
-
| [Types and scopes](https://
|
|
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://
|
|
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
|
|