diff --git a/gradle.properties b/gradle.properties
index c1651f2..9cc6473 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -9,9 +9,16 @@
 #   the Android Studio default formatter.
 # android.nonTransitiveRClass: smaller APKs by making R classes
 #   non-transitive (Gradle 8+ default behaviour).
+# android.enableResourceOptimizations: off. AGP's default release-build
+#   resource path shortening flattens res/mipmap-hdpi/ic_launcher.png
+#   into an obfuscated flat name like res/o-.png, which breaks tools
+#   that expect standard res/<density-qualified-folder>/name.png paths
+#   (e.g. fdroidserver's icon extraction for the self-hosted F-Droid
+#   repo). Code shrinking/obfuscation via isMinifyEnabled is unaffected.
 
 org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
 org.gradle.java.home=/Applications/Android Studio.app/Contents/jbr/Contents/Home
 android.useAndroidX=true
 kotlin.code.style=official
 android.nonTransitiveRClass=true
+android.enableResourceOptimizations=false