From 0b6bd60befa99dbee5931828bc4065c4f47ce2a5 Mon Sep 17 00:00:00 2001 From: david Date: Sat, 28 Feb 2026 16:02:52 -0700 Subject: [PATCH] docs: warn about Gradle sync failure on first open before prerequisites are in place Signed-off-by: david --- docs/src/content/docs/contributing/setup.mdx | 6 ++++++ 1 file changed, 6 insertions(+) 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