tokens-bruecke 3.5.0 → 3.7.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 +12 -0
- package/README.md +59 -2
- package/bin/cli.js +1 -1
- package/llms.txt +2 -0
- package/package.json +1 -1
- package/skills/tokens-bruecke/SKILL.md +20 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
## [3.6.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.5.0...v3.6.0) (2026-08-21)
|
|
2
|
+
|
|
3
|
+
### Features
|
|
4
|
+
|
|
5
|
+
- **cli:** add an interactive `init` command ([7752a58](https://github.com/tokens-bruecke/figma-plugin/commit/7752a580f14461dde5027ccb30573638ae4d5609))
|
|
6
|
+
- **cli:** keyboard navigation for the init prompts ([4a839bc](https://github.com/tokens-bruecke/figma-plugin/commit/4a839bc07fae8acd77a08d38edf320a75c4c480f))
|
|
7
|
+
|
|
8
|
+
### Bug Fixes
|
|
9
|
+
|
|
10
|
+
- **ci:** generate the release CHANGELOG section that -r 1 silently skipped ([e116963](https://github.com/tokens-bruecke/figma-plugin/commit/e116963d0ceb82a738635bf15b627c0a5a5df956))
|
|
11
|
+
- **ci:** publish to npm via trusted publishing (OIDC) ([3775e31](https://github.com/tokens-bruecke/figma-plugin/commit/3775e31744e33f7442d143ebf36dfe4e13403301))
|
|
12
|
+
|
|
1
13
|
# Changelog
|
|
2
14
|
|
|
3
15
|
## [3.5.0](https://github.com/tokens-bruecke/figma-plugin/compare/v3.4.4...v3.5.0) (2026-08-21)
|
package/README.md
CHANGED
|
@@ -34,6 +34,7 @@ The plugin converts Figma variables into design-tokens JSON that are compatible
|
|
|
34
34
|
- [Use as cli tool](#use-as-cli-tool)
|
|
35
35
|
- [Installation](#installation)
|
|
36
36
|
- [Usage](#usage)
|
|
37
|
+
- [Quick setup](#quick-setup)
|
|
37
38
|
- [Options](#options)
|
|
38
39
|
- [Snapshot input](#snapshot-input)
|
|
39
40
|
- [CLI Configuration File](#cli-configuration-file)
|
|
@@ -282,6 +283,7 @@ Is `off` by default. When enabled, each Figma variable collection is exported as
|
|
|
282
283
|
|
|
283
284
|
- **Download JSON** — produces a `design.tokens.zip` archive containing one `{CollectionName}.tokens.json` per collection.
|
|
284
285
|
- **CLI** — writes individual `{CollectionName}.tokens.json` files into the directory specified by `--output`.
|
|
286
|
+
- **Push to a server** — the GitHub, GitHub PR and GitLab servers commit one `{CollectionName}.tokens.json` per collection in a single commit. The `File name` field of the server becomes the folder they are written into, e.g. `tokens` → `tokens/{CollectionName}.tokens.json`.
|
|
285
287
|
|
|
286
288
|
This is useful when you want to keep component-level token files separate (e.g. `button.tokens.json`, `card.tokens.json`).
|
|
287
289
|
|
|
@@ -291,6 +293,7 @@ Is `off` by default. When enabled, each mode of a variable collection is exporte
|
|
|
291
293
|
|
|
292
294
|
- **Download JSON** — produces a `design.tokens.zip` archive containing one `{CollectionName}/{ModeName}.tokens.json` per mode.
|
|
293
295
|
- **CLI** — writes individual `{CollectionName}/{ModeName}.tokens.json` files into the directory specified by `--output`.
|
|
296
|
+
- **Push to a server** — the GitHub, GitHub PR and GitLab servers commit one `{CollectionName}/{ModeName}.tokens.json` per mode in a single commit, inside the folder set in the server's `File name` field.
|
|
294
297
|
|
|
295
298
|
Collections with a single mode are exported as a single `{CollectionName}.tokens.json` file.
|
|
296
299
|
|
|
@@ -399,6 +402,55 @@ tokens-bruecke --input snapshot.json --output out/tokens.json
|
|
|
399
402
|
|
|
400
403
|
This will fetch figma variables and export them in `out/tokens.json`
|
|
401
404
|
|
|
405
|
+
### Quick setup
|
|
406
|
+
|
|
407
|
+
`tokens-bruecke init` asks a few questions and writes a config file you can commit:
|
|
408
|
+
|
|
409
|
+
```bash
|
|
410
|
+
tokens-bruecke init
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
```
|
|
414
|
+
? Color mode (↑↓ to move, enter to select)
|
|
415
|
+
❯ HEX "#3366ff"
|
|
416
|
+
RGBA CSS "rgba(51, 102, 255, 1)"
|
|
417
|
+
RGBA Object { r, g, b, a }
|
|
418
|
+
sRGB DTCG DTCG color object
|
|
419
|
+
HSLA CSS "hsla(225, 100%, 60%, 1)"
|
|
420
|
+
HSLA Object { h, s, l, a }
|
|
421
|
+
HSL DTCG DTCG color object
|
|
422
|
+
OKLCH DTCG DTCG color object
|
|
423
|
+
|
|
424
|
+
? Styles to include (space to toggle, a for all, enter to confirm)
|
|
425
|
+
❯ ◉ Color styles
|
|
426
|
+
◯ Typography styles
|
|
427
|
+
◉ Effect styles
|
|
428
|
+
◯ Grid styles
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
Each answered question collapses to a single line, so you end up with a short summary rather than a wall of text:
|
|
432
|
+
|
|
433
|
+
```
|
|
434
|
+
? Color mode › OKLCH DTCG
|
|
435
|
+
? Styles to include › Color styles, Effect styles
|
|
436
|
+
? Use DTCG 2025.10 format? › No
|
|
437
|
+
? Output layout › One file per collection
|
|
438
|
+
|
|
439
|
+
✨ Created tokens-bruecke.config.json
|
|
440
|
+
```
|
|
441
|
+
|
|
442
|
+
**Keys:** `↑`/`↓` (or `j`/`k`, or `Tab`) to move, `1`–`9` to jump straight to a row, `Space` to toggle in multi-select, `a` to toggle all, `Enter` to confirm, `Ctrl+C` / `Esc` to cancel without writing anything. Selection wraps at both ends. Set `NO_COLOR=1` to drop the colour codes.
|
|
443
|
+
|
|
444
|
+
The four questions cover the settings people change most often, but the generated file contains **every** option with its default, plus a `$schema` link — so your editor autocompletes and documents the rest as you edit it.
|
|
445
|
+
|
|
446
|
+
| Option | Alias | Description |
|
|
447
|
+
| --------- | ----- | --------------------------------------------------------- |
|
|
448
|
+
| `--yes` | `-y` | Skip the questions and write the default config |
|
|
449
|
+
| `--force` | | Overwrite an existing config file |
|
|
450
|
+
| `--path` | `-p` | Where to write it (default: `tokens-bruecke.config.json`) |
|
|
451
|
+
|
|
452
|
+
When stdin is not a terminal — CI, a pipe, an agent — `init` skips the questions and writes the defaults instead of hanging.
|
|
453
|
+
|
|
402
454
|
### Options
|
|
403
455
|
|
|
404
456
|
| Option | Alias | Description | Required |
|
|
@@ -480,7 +532,7 @@ Things worth knowing when building a snapshot:
|
|
|
480
532
|
|
|
481
533
|
### CLI Configuration File
|
|
482
534
|
|
|
483
|
-
You can use a JSON configuration file to specify the export options for the CLI.
|
|
535
|
+
You can use a JSON configuration file to specify the export options for the CLI. Run [`tokens-bruecke init`](#quick-setup) to generate one, or write it by hand:
|
|
484
536
|
|
|
485
537
|
```json
|
|
486
538
|
{
|
|
@@ -620,6 +672,8 @@ In ordere to test if your credentials are valid you can make a test request by c
|
|
|
620
672
|
4. In the file name field you can specify a path to the file. If the file doesn't exist, it will be created. If the file exists, it will be overwritten. File name should include the file extension, e.g. `tokens.json`.
|
|
621
673
|
5. You can also specify a commit message.
|
|
622
674
|
|
|
675
|
+
> **Splitting into several files.** If _Split collections into separate files_ or _Split modes into separate files_ is enabled in the advanced settings, the file name field is treated as a folder instead, and every file is written in a single commit — e.g. `tokens` → `tokens/Colors.tokens.json`, or `tokens/Colors/Light.tokens.json` when splitting by mode.
|
|
676
|
+
|
|
623
677
|

|
|
624
678
|
|
|
625
679
|
### [GitHub PR](https://github.com)
|
|
@@ -636,7 +690,10 @@ All the steps are the same as for the [GitHub](#github) server, except the last
|
|
|
636
690
|
1. You need to create a [project access token](https://docs.gitlab.com/ee/user/project/settings/project_access_tokens.html) with `api` scope.
|
|
637
691
|
2. In the plugin settings paste the token into the `Project access token` field.
|
|
638
692
|
3. Add an owner name, repository name and a branch name.
|
|
639
|
-
4. In the file name field you can specify a path to the file. If the file doesn't exist, it will be created. If the file exists, it will be overwritten. File name should include the file extension, e.g. `tokens.json`.
|
|
693
|
+
4. In the file name field you can specify a path to the file. If the file doesn't exist, it will be created. If the file exists, it will be overwritten. File name should include the file extension, e.g. `tokens.json`.
|
|
694
|
+
5. You can also specify a commit message.
|
|
695
|
+
|
|
696
|
+
> **Splitting into several files.** If _Split collections into separate files_ or _Split modes into separate files_ is enabled in the advanced settings, the file name field is treated as a folder instead, and every file is written in a single commit — e.g. `tokens` → `tokens/Colors.tokens.json`, or `tokens/Colors/Light.tokens.json` when splitting by mode.
|
|
640
697
|
|
|
641
698
|

|
|
642
699
|
|