diff --git a/docs/src/content/docs/contributing/setup.mdx b/docs/src/content/docs/contributing/setup.mdx
index 2efc0901..d16f95a3 100644
--- a/docs/src/content/docs/contributing/setup.mdx
+++ b/docs/src/content/docs/contributing/setup.mdx
@@ -94,6 +94,12 @@ import { Tabs, TabItem, Steps } from "@astrojs/starlight/components"
 
 5.  Open the project in Android Studio.
 
+    :::caution
+    Android Studio will automatically attempt a Gradle sync when the project is first opened.
+    This sync will fail until steps 8-10 are completed. You can safely dismiss the sync failure and
+    proceed through the remaining steps before syncing manually via
+    **File > Sync Project with Gradle Files**.
+    :::
 6.  Install the required dependencies.
 
     -   Android SDK, latest version