tokens-bruecke 3.22.0 → 3.23.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/README.md CHANGED
@@ -52,7 +52,9 @@ TokensBruecke exports Figma variables and styles as design tokens JSON compatibl
52
52
  - [Custom server](#custom-server)
53
53
  - [Show output](#show-output)
54
54
  - [Plugin window height](#plugin-window-height)
55
+ - [Dev Mode](#dev-mode)
55
56
  - [Multiple profiles](#multiple-profiles)
57
+ - [Shared profiles](#shared-profiles)
56
58
  - [Config autosaving](#config-autosaving)
57
59
  - [Styles support](#styles-support)
58
60
  - [Typography](#typography)
@@ -97,7 +99,7 @@ The plugin supports both **exporting** and **importing** design tokens:
97
99
 
98
100
  #### Import (JSON → Variables)
99
101
 
100
- - Click **"Import tokens (Beta)"** to import design tokens from a JSON file back into Figma. The button is in the settings and on the "No variables found" screen
102
+ - Click **"Import tokens (Beta)"** to import design tokens from a JSON file back into Figma. The button is in the settings and on the "No variables found" screen. The import runs in Figma Design only, not in [Dev Mode](#dev-mode)
101
103
  - The plugin will create variable collections, modes, and variables based on the JSON structure
102
104
  - Supports both DTCG format (`$value`, `$type`) and standard format (`value`, `type`)
103
105
  - Handles alias references between variables
@@ -892,6 +894,25 @@ The plugin window auto-fits the height of its content, but you can adjust it man
892
894
  - **Double-click** the handle to reset back to auto-fit. The window snaps to match the content height again.
893
895
  - Your manual height is preserved while the output preview is open, so you can resize both with and without the preview showing.
894
896
 
897
+ In [Dev Mode](#dev-mode) the plugin fills the Inspect panel instead, so there is no resizer.
898
+
899
+ ---
900
+
901
+ ## Dev Mode
902
+
903
+ The plugin also runs in Dev Mode and in [Figma for VS Code](https://help.figma.com/hc/en-us/articles/15023121296151), so developers with a Dev seat can export tokens themselves. Open a file in Dev Mode, go to **Plugins** in the right sidebar and run TokensBruecke.
904
+
905
+ | Feature | Figma Design | Dev Mode |
906
+ | ------------------------------------------ | ------------ | ---------------------------------------------------------------- |
907
+ | Export: settings, download, push, profiles | ✅ | ✅ |
908
+ | Show output | ✅ sidebar | ✅ fills the panel, with a back button |
909
+ | Import tokens into variables | ✅ | ❌ Dev Mode is read-only for every plugin, even with edit access |
910
+ | Window resizing | ✅ | the panel is resized by you, not the plugin |
911
+
912
+ To import tokens, someone with a Full seat and edit access to the file runs the plugin in Figma Design. Which seats can run plugins where is listed in Figma's [plugin help article](https://help.figma.com/hc/en-us/articles/360042532714): a Dev seat runs plugins in Dev Mode only, and Dev Mode needs a paid plan.
913
+
914
+ Set-up is personal: profiles and server credentials are stored per user. To give developers the same settings, [share a profile in the file](#shared-profiles).
915
+
895
916
  ---
896
917
 
897
918
  ## Multiple profiles
@@ -912,6 +933,15 @@ The plugin supports multiple named profiles. Each profile stores its own complet
912
933
 
913
934
  ![fig.14](readme-assets/fig14.webp)
914
935
 
936
+ ### Shared profiles
937
+
938
+ Profiles are stored on your machine. To hand your settings to others, for example developers in [Dev Mode](#dev-mode), open the profile with `⋮` and click **Share in this file**.
939
+
940
+ - The profile is saved in the Figma file, without any credentials: tokens, access keys, the Custom URL and its headers are removed, because webhook URLs often carry their secret in the URL. Everything else is shared, including repository, branch, file name and the Custom URL method. Each developer enters the Custom URL themselves; until then that server stays off.
941
+ - Everyone who runs the plugin on the file sees it in the profile dropdown under **Shared in this file**. Picking it creates a local copy. Add your own token in the server settings before you push.
942
+ - When the shared profile changes, the local copy shows **Update**. Updating takes the settings from the file and keeps your credentials and profile name. If the update points GitLab to another host, your GitLab token is removed and the server is turned off, so a changed file can't send your token somewhere else. Check the host and add the credential again.
943
+ - **Update shared profile** and **Stop sharing** change the profile for everyone who uses the file.
944
+
915
945
  ---
916
946
 
917
947
  ## Config autosaving