From 2409afda33c14cf3062099ba949cb773c369e6c3 Mon Sep 17 00:00:00 2001
From: "Hareen S, R S C (CT RDA DS AA DF RT FH)" <hareen.ra@siemens.com>
Date: Wed, 7 Jan 2026 22:08:24 +0530
Subject: [PATCH] docs: improve Android build & run instructions

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index a3f54e906..c0a84158b 100644
--- a/README.md
+++ b/README.md
@@ -35,3 +35,23 @@ Experience the simplicity and efficiency of note-taking with Fossify Notes. Down
 <img alt="App image" src="fastlane/metadata/android/en-US/images/phoneScreenshots/2_en-US.png" width="30%">
 <img alt="App image" src="fastlane/metadata/android/en-US/images/phoneScreenshots/3_en-US.png" width="30%">
 </div>
+
+## Build & Run (Android)
+
+### Requirements
+- Android Studio Hedgehog or newer
+- Android SDK 30+
+- Gradle (bundled with Android Studio)
+
+### Steps
+1. Clone the repository
+2. Open the project in Android Studio
+3. Allow Gradle sync to complete
+4. Select the `appDebug` build variant
+5. Run the app on:
+   - Emulator (API 30+ recommended), or
+   - Physical device with USB debugging enabled
+
+### Notes
+- First Gradle sync may take a few minutes
+- If sync fails, try **Invalidate Caches & Restart**