From a7510d4d91cbb6333ba6dca30c851a06cbe1e904 Mon Sep 17 00:00:00 2001
From: webbrain-one <295484252+webbrain-one@users.noreply.github.com>
Date: Sat, 8 Aug 2026 01:19:23 +0300
Subject: [PATCH] docs: add README

---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..644c69e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+
+
+# Anti-Data Recovery
+
+## Overview
+Anti-Data Recovery is an Android application designed to help prevent data recovery of sensitive files. By generating customizable dummy files and directories, the app fills and overwrites storage space to make data recovery significantly more difficult. All generated content is safely stored in the `storage/AntiDataRecovery` directory and can be quickly cleaned up when no longer needed.
+
+## Features
+- Generate dummy image (`.png`) or folder/archive (`.zip`) files
+- Adjustable target size/amount via an interactive `SeekBar`
+- One-tap cleanup to delete all generated files
+- System notification alerts upon task completion
+- Clean, material-design inspired UI with custom typography (Calligraphy)
+
+## Installation
+This is a standard Android Studio project using Gradle. To build and run it locally:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/amrhossamdev/AntiDataRecovery.git
+   ```
+2. Open the project in Android Studio.
+3. Allow Gradle to sync and download dependencies.
+4. Connect a physical Android device or launch an emulator (API 21+ recommended).
+5. Click **Run** (`Shift + F10`) to build and install the app.
+
+## Usage
+1. Launch the application and grant the requested storage permissions.
+2. Drag the slider to set your desired target amount (displayed in MB).
+3. Tap **Images** to generate dummy PNG files, or tap **Folders** to generate dummy ZIP files.
+4. The app will run in the background. You'll receive a system notification once the task is complete.
+5. Tap **Delete** at any time to remove all generated files from the `AntiDataRecovery` directory.
+
+## Permissions
+The app requires the following Android permissions to operate:
+- `READ_EXTERNAL_STORAGE` & `WRITE_EXTERNAL_STORAGE`: To create, manage, and delete files on your device's shared storage.
+- `INTERNET` & `ACCESS_NETWORK_STATE`: For connectivity checks and potential update/rating functionality.
+
+## Credits
+Developed by **Amr Hossam | NanosX Developments**.  
+Built with Java, Android SDK, AppCompat/Support Libraries, Calligraphy, and Apache Commons IO.