From 7f1aaf7f14fb4e94a6a028b2a24c9d8f4cb38e2e Mon Sep 17 00:00:00 2001
From: Avner Matan <137777701+avner-m@users.noreply.github.com>
Date: Tue, 23 Jun 2026 14:30:34 +1200
Subject: [PATCH] Keep Android sample `repo` folder present after clone

The three Android tutorial sample apps reference a local Maven `repo`
folder from settings.gradle.kts (`maven { url = uri("repo") }`), but the
folder was empty and therefore not tracked by git. On a fresh clone or
download the folder is missing, so the quickstart step "Drag the unzipped
global folder into the project's repo folder" has no target.

Add a README.md to each sample's repo folder documenting what goes there
and why repo/global/ is gitignored. This keeps the folder present while
leaving the SDK contents excluded from version control.
---
 android-holder-tutorial-sample-app/repo/README.md | 15 +++++++++++++++
 .../repo/README.md                                | 15 +++++++++++++++
 .../repo/README.md                                | 15 +++++++++++++++
 3 files changed, 45 insertions(+)
 create mode 100644 android-holder-tutorial-sample-app/repo/README.md
 create mode 100644 android-in-person-verifier-tutorial-sample-app/repo/README.md
 create mode 100644 android-remote-verification-tutorial-sample-app/repo/README.md

diff --git a/android-holder-tutorial-sample-app/repo/README.md b/android-holder-tutorial-sample-app/repo/README.md
new file mode 100644
index 0000000..d9dc128
--- /dev/null
+++ b/android-holder-tutorial-sample-app/repo/README.md
@@ -0,0 +1,15 @@
+# Local SDK repository
+
+This folder is the local Maven repository for the MATTR mDocs Holder SDK. It is
+referenced from `settings.gradle.kts` as `maven { url = uri("repo") }`.
+
+To set up the SDK:
+
+1. Unzip the `mobile-credential-holder-<version>.zip` package supplied by MATTR.
+2. Drag the unzipped `global` folder into this `repo` folder, so the layout is
+   `repo/global/...`.
+3. Sync the project with Gradle files to pick up the new module.
+
+> The SDK contents (`repo/global/`) are intentionally excluded from version
+> control via `.gitignore`. This README keeps the otherwise-empty `repo` folder
+> present after cloning or downloading the project.
diff --git a/android-in-person-verifier-tutorial-sample-app/repo/README.md b/android-in-person-verifier-tutorial-sample-app/repo/README.md
new file mode 100644
index 0000000..2b4a7c3
--- /dev/null
+++ b/android-in-person-verifier-tutorial-sample-app/repo/README.md
@@ -0,0 +1,15 @@
+# Local SDK repository
+
+This folder is the local Maven repository for the MATTR mDocs Verifier SDK. It is
+referenced from `settings.gradle.kts` as `maven { url = uri("repo") }`.
+
+To set up the SDK:
+
+1. Unzip the `mobile-credential-verifier-<version>.zip` package supplied by MATTR.
+2. Drag the unzipped `global` folder into this `repo` folder, so the layout is
+   `repo/global/...`.
+3. Sync the project with Gradle files to pick up the new module.
+
+> The SDK contents (`repo/global/`) are intentionally excluded from version
+> control via `.gitignore`. This README keeps the otherwise-empty `repo` folder
+> present after cloning or downloading the project.
diff --git a/android-remote-verification-tutorial-sample-app/repo/README.md b/android-remote-verification-tutorial-sample-app/repo/README.md
new file mode 100644
index 0000000..2b4a7c3
--- /dev/null
+++ b/android-remote-verification-tutorial-sample-app/repo/README.md
@@ -0,0 +1,15 @@
+# Local SDK repository
+
+This folder is the local Maven repository for the MATTR mDocs Verifier SDK. It is
+referenced from `settings.gradle.kts` as `maven { url = uri("repo") }`.
+
+To set up the SDK:
+
+1. Unzip the `mobile-credential-verifier-<version>.zip` package supplied by MATTR.
+2. Drag the unzipped `global` folder into this `repo` folder, so the layout is
+   `repo/global/...`.
+3. Sync the project with Gradle files to pick up the new module.
+
+> The SDK contents (`repo/global/`) are intentionally excluded from version
+> control via `.gitignore`. This README keeps the otherwise-empty `repo` folder
+> present after cloning or downloading the project.