From 155687285219cc3d4a0cd8082ef046a17d9c81cb Mon Sep 17 00:00:00 2001
From: Cem Aksoylar <caksoylar@users.noreply.github.com>
Date: Sat, 19 Jul 2025 12:23:26 -0700
Subject: [PATCH] docs: Document requirements-extra.txt for Studio builds

---
 .../local-toolchain/setup/native.mdx          | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/docs/development/local-toolchain/setup/native.mdx b/docs/docs/development/local-toolchain/setup/native.mdx
index ee552c5b3..822359f09 100644
--- a/docs/docs/development/local-toolchain/setup/native.mdx
+++ b/docs/docs/development/local-toolchain/setup/native.mdx
@@ -203,6 +203,12 @@ west zephyr-export
 pip install -r zephyr/scripts/requirements-base.txt
 ```
 
+If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies:
+
+```sh
+pip install -r zephyr/scripts/requirements-extra.txt
+```
+
 </TabItem>
 <TabItem value="glob">
 <Tabs groupId="operating-systems" queryString defaultValue="ubuntu">
@@ -293,6 +299,12 @@ west zephyr-export
 
 ```sh
 pip3 install --user -r zephyr/scripts/requirements-base.txt
+```
+
+If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies:
+
+```sh
+pip3 install -r zephyr/scripts/requirements-extra.txt
 ```
 
   </TabItem>
@@ -303,6 +315,12 @@ pip3 install --user -r zephyr/scripts/requirements-base.txt
 
 ```sh
 pip install -r zephyr/scripts/requirements-base.txt
+```
+
+If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies:
+
+```sh
+pip install -r zephyr/scripts/requirements-extra.txt
 ```
 
   </TabItem>
@@ -312,6 +330,12 @@ pip install -r zephyr/scripts/requirements-base.txt
 
 ```sh
 pip3 install -r zephyr/scripts/requirements-base.txt
+```
+
+If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies:
+
+```sh
+pip3 install -r zephyr/scripts/requirements-extra.txt
 ```
 
   </TabItem>