






.png)










.png)
{
+ "version": "2",
+ "org": "7xxxxxx1-3xx5-4xxx-xxx6-xxxx4axxxxf2",
+ "project": "xxxxfa7d-xxxx-4xxx-xxx2-xxxx0126xxxx",
+ "branch": "main",
+ "release": "",
+ "output": "tokens"
+}
+
+{% endstep %}
+
+{% step %}
+### Pull Tokens into your project
+
+In the `.tokensstudio.json` file, edit the **output** property value to be the local project directory where you'd like the tokens to be stored. For example, if your project uses a `src` directory, you would want to change that to `"output": "src/tokens"`\
+
+
+Use the `pull` command to download the tokens from Tokens Studio to your project.
+
+```bash
+npx tokensstudio pull --host graphql.prod.tokens.studio
+```
+
+{% code title="Results" %}
+```bash
+✔ Done!
+ ■ Fetched tokensets
+
+✔ Success Found 18 sets with 938 tokens in total.
+ ◼ global.json
+ ◼ semantic.json
+ ◼ comp/button.json
+ ◼ comp/list-item.json
+ ◼ comp/menu-item.json
+ ◼ comp/toggle.json
+ ◼ pattern/menu-bar.json
+ ◼ pattern/feature.json
+ ◼ pattern/card-user.json
+ ◼ pattern/card-pricing.json
+ ◼ sections/nav.json
+ ◼ sections/hero.json
+ ◼ sections/features.json
+ ◼ sections/team.json
+ ◼ sections/pricing.json
+ ◼ sections/footer.json
+ ◼ theme/light.json
+ ◼ theme/dark.json
+```
+{% endcode %}
+{% endstep %}
+{% endstepper %}
diff --git a/connect-studio-to-figma/README.md b/connect-studio-to-figma/README.md
new file mode 100644
index 0000000..feaf821
--- /dev/null
+++ b/connect-studio-to-figma/README.md
@@ -0,0 +1,15 @@
+# Connect Studio to Figma
+
+Our [companion-by-tokens-studio.md](../plugins/companion-by-tokens-studio.md "mention") Figma plugin integrates easily with the Studio and allows you to sync the tokens from your organizations and projects.
+
+Read our guide on how to connect Companion
+
+{% content-ref url="using-companion-by-tokens-studio.md" %}
+[using-companion-by-tokens-studio.md](using-companion-by-tokens-studio.md)
+{% endcontent-ref %}
+
+Familiar with our flagship Tokens Studio Figma plugin? Studio can be integrated directly with the plugin.
+
+{% content-ref url="using-tokens-studio-for-figma.md" %}
+[using-tokens-studio-for-figma.md](using-tokens-studio-for-figma.md)
+{% endcontent-ref %}
diff --git a/connect-studio-to-figma/using-companion-by-tokens-studio.md b/connect-studio-to-figma/using-companion-by-tokens-studio.md
new file mode 100644
index 0000000..e648a6a
--- /dev/null
+++ b/connect-studio-to-figma/using-companion-by-tokens-studio.md
@@ -0,0 +1,66 @@
+# Using Companion by Tokens Studio
+
+Companion by Tokens Studio is a Figma plugin which is meant purely for consumption of design tokens from Studio as variables in Figma.
+
+**Prerequisites**:
+
+* [api-keys.md](../settings/api-keys.md "mention")
+
+
+
+{% stepper %}
+{% step %}
+### Open a Figma design file
+
+This can be a new empty file to ensure that your production design files are not affected while setting up a connection between Studio and Figma.
+{% endstep %}
+
+{% step %}
+### Install/Launch the plugin
+
+1. Go to plugins > Companion by Tokens Studio.
+2. Run the plugin.
+{% endstep %}
+
+{% step %}
+### Setting up Studio sync
+
+1. Return to Studio.
+2. Click on Find your API key. You can also jump to the API keys page by using the keyboard shortcut cmd+k.
+3. The API key is linked to the user which means that it gives access to all the Organisations and Projects that a user is part of.
+
+For more info read [Platform > API keys](../settings/api-keys.md).
+
+


.png)





Base Font Scale
.png)
Table Output





Stringify


Numeric Scale



Inside the subgraph explorer

Output


























.png)


Tokens Studio Waitlist Page
.png)
Create new organization form.

Selecting a template for starter tokens.
.png)
.png)
 (1) (1).png)
.png)



.png)







Subgraph explorer




.png)







































































.png)


























.png)




















.png)
.png)




























Defining a design token using the Create Design Token node.



An output node with an input set to "tokenSet" and the type set to "any".

Our entire graph where we create design tokens, group them in an array, turn the array into a set and then output them.

Our outputted tokens in the table view of a Graph-Based set.












| Name | Description | Example |
|---|---|---|
| Number | Integers or decimals | 5, 3.14, 0.025 |
| String | Text strings, special characters or text with spaces. | "bold", "#FF5733" |
| Color | Color objects such as RGB, HSL etc. formats. | rgb(76, 190, 66), hsl(67, 96, 65) |
| Array | Lists of values (contains multiple items of the same type) | [10, 20, 30], ["#263724", "#ED8DF0"] |
| Object | Collections of related values with names in the format of "key" : "value". | { "foreground": "#177BF7"} |
| Boolean | True or False. Useful for decisions to your logic with the logic node. | true, false |
| Curve | A | |
| Token | A design token that meets the DTCG format. | |
| Token Set | A special type for design token collections | |
| Any | An agnostic type value that you probably don't want to use. |















.png)















.png)




























 (1).png)
.png)

.png)

.png)

.png)

.png)




Opening Token Flow to understand token relationships.

























.png)


.png)

 (1).png)
.png)







