From b99e85d0ba0b45bb60b5d4947de1f46e3d906aeb Mon Sep 17 00:00:00 2001
From: Charlotte Wilson <251223230+cswilson252@users.noreply.github.com>
Date: Sat, 2 May 2026 15:19:32 -0400
Subject: [PATCH] Add missing buildAndCopyUI instructions (#2457)

Adds ./gradlew buildAndCopyUI instruction to the documentation on building Photonvision, to clarify that this step must be ran to properly build the UI

Closes #2452
---
 .../docs/contributing/building-photon.md      | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/source/docs/contributing/building-photon.md b/docs/source/docs/contributing/building-photon.md
index 747e9565f..4814b629d 100644
--- a/docs/source/docs/contributing/building-photon.md
+++ b/docs/source/docs/contributing/building-photon.md
@@ -47,6 +47,30 @@ In the photon-client directory:
 pnpm install
 ```
 
+### Building the UI
+
+In order to properly build UI changes before running the project, run the following `gradlew` command in the project's root directory:
+
+```{eval-rst}
+.. tab-set::
+
+   .. tab-item:: Linux
+      :sync: linux
+
+      ``./gradlew buildAndCopyUI``
+
+   .. tab-item:: macOS
+      :sync: macos
+
+      ``./gradlew buildAndCopyUI``
+
+   .. tab-item:: Windows (cmd)
+      :sync: windows
+
+      ``gradlew buildAndCopyUI``
+```
+
+
 ### Using hot reload on the UI
 
 In the photon-client directory: