AuraDrive

Reclaim your storage, protect your privacy, and organize with a complete safety net.

---

⚡ The Problem: Bloated Drives & Lost Peace of Mind

Our hard drives and synced cloud folders are constantly overflowing with duplicate images, heavy backups, stale screenshots, and abandoned empty folders.

• The tedious search: Spending hours manually hunting down duplicates.
• The privacy risk: Uploading your personal directory trees to third-party cloud cleaners.
• The fear of deletion: Accidentally deleting a critical file with no easy way to get it back.

---

🎯 The Solution: AuraDrive

AuraDrive is a minimalist, local-first web utility that cleans up your folder chaos in seconds. Built on modern web technologies, it runs 100% inside your browser offline. Your files never leave your computer.

👉 Launch AuraDrive Web App Live

---

✨ Features Built for Speed & Safety

• 🛡️ Absolute Privacy: No servers, no accounts, no APIs. Directory scanning and local file movements are performed locally using the native browser File System Access API.
• ↩️ Safety Net (Interactive Undo): Relocate and clean without fear. If you make a mistake, one click on the Undo button instantly restores every file and empty folder back to its original name and path.
• 🔑 Cryptographic Duplicates Finder: Groups identical files by calculating their SHA-256 binary hash using the Web Crypto API. Identifies true duplicates even if their filenames are completely different (e.g., backup.zip and copy_of_backup.zip).
• 📅 Stale Files Sorter: Set your preferred age threshold (e.g., 90, 180, or 365 days) and category filters to see a list of old files. Select and click Archive to move them into an _Archive/ folder, preserving their original relative paths.
• 📦 Large Files Size Ranking: Instantly displays all scanned files sorted descending by size, allowing you to quickly spot heavy video clips, logs, or databases that are eating up your disk space.
• 📁 Empty Folders Cleaner: Scans your directory tree recursively to find and safely remove empty directories, keeping your drive clean and organized.
• ⚙️ Unified Settings Drawer: Access parameters like stale days and duplicate cleanup strategies (Trash, Delete permanently, Rename) in a sleek, side-out settings panel drawer.

---

🛠️ How To Test (Offline Workspace)

We've included a pre-configured test-folder in this repository containing mock files so you can test all features safely out of the box:

• Duplicate Screeners: Multiple identical images and screenshot copies.
• Stale Archives: Large backups and videos modified months ago.
• Empty Directories: Pre-configured empty folders ready to be cleaned.

1. Open AuraDrive Live.
2. Select or drag the test-folder into the app.
3. Review the preview lists, test the filters/sort rankings, and execute a Clean or Archive.
4. Click Undo to watch everything restore instantly.

---

🚀 Running Locally (Developer Quickstart)

AuraDrive is built with React, TypeScript, and Vite, matching the clean aesthetic of Shadcn/UI.

1. Clone the repository:

   git clone https://github.com/PabloAballe/aura-drive.git

2. Start the local server:
   • On Windows: Double-click run.bat (automatically configures local node paths and launches the dev server).
   • Alternatively (any OS): Run npm install and then npm run dev.
3. Open in browser: Navigate to: http://localhost:5173

Note: For the native directory scanning experience, we recommend using Google Chrome, Microsoft Edge, or Opera.