# 🕳️ **Void Crawler 2.0.1**
### *A lightweight, single-file developer CMS for offline repo navigation, instant file browsing, and drag-and-drop directory parsing.*

---

## 📌 Overview
**Void Crawler** is a minimal developer-focused CMS designed for quick browsing, reading, and navigating project structures.
It functions as a **portable, offline repo explorer** with a clean dark UI and zero dependencies.

Built for speed, privacy, and simplicity:
- No installation
- No backend
- No networking
- Entirely local

Drop it anywhere — open it in your browser — start exploring.

---

## ⚡ Features
- **🗂️ Instant directory-tree rendering**
- **📁 Drag-and-drop folders/files directly into the UI**
- **👁️ Immediate file preview**
- **🔒 100% local — nothing ever leaves the machine**
- **📦 Single-file deployment**
- **🌑 Dark, developer-friendly interface**
- **⚙️ Fully hackable and customizable**
- **🧭 Private offline repository browsing**

---

## ⚙️ Prerequisites

Before using **Void Crawler**, ensure your environment meets the following requirements:

- **Web Server**: Void Crawler must run on a web server such as:
- [Apache](https://httpd.apache.org/)
- [Nginx](https://www.nginx.com/)
- [IIS](https://www.iis.net/)

- **PHP**: Since `voidcrawler.php` is a PHP file, your server must have PHP installed:
- Recommended version: **PHP 7.4+**
- Ensure the PHP `fileinfo` extension is enabled for optimal file handling

- **Browser**: Modern web browsers with support for:
- **FileReader API**
- **Drag-and-drop folder parsing (`webkitdirectory`)**
- Examples: Chrome, Firefox, Edge, Safari

> ⚠️ Void Crawler will **not run correctly** without a web server and PHP. Opening the PHP file directly in a browser (without a server) may result in blank pages or errors.

---

## 📥 Installation
There *is no installation.*

Just place the main file anywhere:


Then open it in your browser:


Or simply double-click it.

---

## 🖱️ Drag & Drop Usage
Void Crawler uses built-in browser capabilities (`FileReader`, `webkitdirectory`) to parse directories instantly.

### Supported actions:
- Drag folders → view full tree
- Drag files → display content
- All parsing happens fully offline

Nothing is uploaded, transmitted, or stored outside your machine.

---

## 📚 Use Cases
- Offline private file browser
- Developer repository viewer
- Lightweight documentation explorer
- Portable CMS-style project interface
- Rapid code review without cloning a repo
- Sensitive projects that must remain local

---

## 🧠 How It Works
Void Crawler relies entirely on front-end APIs:

- **FileReader** for content parsing
- **webkitdirectory drag-and-drop** for folder ingestion
- **JavaScript-based rendering** for tree + preview output

All operations are local:
- ❌ No server usage
- ❌ No external requests
- ❌ No data transmission

---

## 🛠️ Developer Notes
- Clean dark UI optimized for code-heavy directories
- Completely hackable — ideal for extending with custom logic
- Perfect single-file solution for portable workflows

---

## 🖤 Credits
**VoidCrawler — v2.1.0**
Created by **K0NxT3D**