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 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
  ![fig.8](readme-assets/fig8.webp)
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`. 5. You can also specify a commit message.
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
  ![fig.11](readme-assets/fig11.webp)
642
699