From 55beff0918f3813774fbd5338d4c16c1a1c4b69a Mon Sep 17 00:00:00 2001
From: theipw <102994625+theipw@users.noreply.github.com>
Date: Tue, 17 Feb 2026 18:57:33 +0000
Subject: [PATCH] Create README.MD

---
 README.MD | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 README.MD

diff --git a/README.MD b/README.MD
new file mode 100644
index 0000000..fa48897
--- /dev/null
+++ b/README.MD
@@ -0,0 +1,38 @@
+# Private Amazon Wrapper (Android)
+
+A hardened, open-source WebView wrapper for Amazon.co.uk designed to provide a "Digital Faraday Cage" for your shopping experience. This app eliminates background telemetry, strips tracking headers, and isolates your Amazon session from the rest of your device.
+
+## 🛡️ Privacy Features
+
+Unlike the official Amazon app or standard mobile browsers, this wrapper implements several layers of active privacy hardening:
+
+*   **X-Requested-With Stripping**: Prevents Amazon from identifying that you are using a specific Android app, masking your traffic as a standard mobile browser.
+*   **Telemetry & Ad Blocking**: Includes a built-in `filters.txt` that actively intercepts and drops requests to known Amazon tracking endpoints (e.g., `fls-eu`, `unagi`, `device-metrics`).
+*   **Fingerprint Mitigation**: Injects custom JavaScript to break common browser fingerprinting techniques:
+    *   Disables **WebRTC** to prevent local IP leaks.
+    *   Muffles **Canvas & WebGL** reporting.
+    *   Reduces hardware concurrency reporting to a generic value.
+*   **Zero Permissions**: This app requires **zero** Android permissions. It cannot access your location, contacts, camera, microphone, or external storage.
+*   **Cookie Isolation**: Blocks all third-party cookies by default, preventing cross-site tracking while maintaining your login session for Amazon.co.uk.
+*   **HTTPS Enforcement**: Hardened via `network_security_config` to deny all cleartext (HTTP) traffic.
+
+## 🚀 Technical Implementation
+
+*   **Language**: Kotlin
+*   **Engine**: Android System WebView (Chromium-based)
+*   **UI**: Edge-to-edge support with dynamic status bar insets to prevent UI overlap.
+*   **Persistence**: Uses `CookieManager.flush()` to ensure login sessions survive app restarts without compromising privacy.
+
+## 🛠️ How to Build
+
+1.  Clone the repository.
+2.  Open in **Android Studio**.
+3.  Ensure you have a `filters.txt` file in `app/src/main/assets/`.
+4.  Build the APK: `Build > Build Bundle(s) / APK(s) > Build APK(s)`.
+
+## 📜 License
+
+This project is licensed under the **GNU GPLv3** - see the [LICENSE](LICENSE) file for details. This ensures the code remains free, open, and private for everyone.
+
+---
+*Disclaimer: This is an independent open-source project and is not affiliated with, authorized, maintained, sponsored, or endorsed by Amazon.com, Inc. or any of its affiliates.*