From d5c25a7ae60d0bfaf50d6c1f84b88bfd5226fdef Mon Sep 17 00:00:00 2001
From: Henrique Velloso <hvmelo@gmail.com>
Date: Tue, 13 Jan 2026 20:21:01 -0300
Subject: [PATCH] Enhance README with reproducible build instructions,
 emphasizing the use of FVM for Flutter version management and specifying JDK
 17 requirements.

---
 README.md | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 418f51f..df8a21e 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,6 @@ The open app store powered by your social network
 ## Build from source
 
 ```bash
-# Using FVM (recommended for reproducible builds)
-# Note: do NOT use "stable" in FVM. This repo pins Flutter via .fvmrc.
 fvm install
 fvm flutter pub get
 fvm flutter build apk --split-per-abi --debug
@@ -21,6 +19,30 @@ flutter pub get
 flutter build apk --split-per-abi --debug
 ```
 
+## Reproducible builds
+
+This repo pins:
+
+- **Flutter** via `.fvmrc` (do not use `stable` in FVM)
+- **Dart/Flutter dependencies** via `pubspec.lock`
+- **Android toolchain** via Gradle/AGP, and expects **JDK 17**
+
+Build "proof" (prints versions + builds):
+
+```bash
+# Use JDK 17 (set JAVA_HOME in your environment/CI if needed)
+# Examples:
+# export JAVA_HOME=$(/usr/libexec/java_home -v 17)            # macOS
+# export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64         # Ubuntu/Debian
+java -version
+
+fvm install
+fvm flutter --version
+fvm flutter pub get --enforce-lockfile
+
+fvm flutter build apk --split-per-abi --release
+```
+
 APK will be available at `build/app/outputs/flutter-apk`.
 
 <a href="https://zapstore.dev/apps/naddr1qvzqqqr7pvpzq7xwd748yfjrsu5yuerm56fcn9tntmyv04w95etn0e23xrczvvraqqgxgetk9eaxzurnw3hhyefwv9c8qakg5jt">