From d6c1b97808f63b88f3f212486db7033d202fdb26 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hasti=20=E2=80=94=20AI=20Research=20=26=20ML=20Architect?=
 <73002293+hasti1356@users.noreply.github.com>
Date: Mon, 29 Jun 2026 14:31:32 +0330
Subject: [PATCH] Create tip-android-connect.md

---
 docs/tip-android-connect.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 docs/tip-android-connect.md

diff --git a/docs/tip-android-connect.md b/docs/tip-android-connect.md
new file mode 100644
index 0000000..d660b7e
--- /dev/null
+++ b/docs/tip-android-connect.md
@@ -0,0 +1,24 @@
+# Tip: Android Connect troubleshooting
+
+If **Connect** closes the app or fails on Samsung / Android 12 devices:
+
+1. Install the latest **v2rayF-android-arm64.apk** from [Releases](https://github.com/drmikecrypto/v2rayF/releases).
+2. **Uninstall** older versions first (clears bad VPN/core state).
+3. Use a **Compat** VLESS link — avoid `flow=xtls-rprx-vision` on phones.
+4. Tap **Connect** and allow the **VPN** permission when prompted.
+5. If connect fails, read the status message — the app tears down VPN so normal internet keeps working.
+
+## Still broken?
+
+With USB debugging enabled:
+
+```bash
+adb logcat -s v2rayF
+```
+
+Tap Connect and check for `XRAY_TUN_FD`, `libxray.so`, or VPN errors.
+
+## Technical notes (v1.1.8+)
+
+- Xray on Android reads the VPN TUN fd from the `XRAY_TUN_FD` environment variable.
+- The core runs from `libxray.so` in native libs with `LD_LIBRARY_PATH` set at launch.