Un explorador visual de proyectos y archivos desarrollado en PHP con interfaz moderna inspirada en el tema Dracula, soporte para tema claro/oscuro y actualización automática en tiempo real.
Ideal para servidores locales, entornos de desarrollo y workspaces con múltiples proyectos.
- 📁 Exploración recursiva de carpetas y archivos
- 🎨 Tema Dracula oscuro y claro
- 🔄 Auto-actualización cada 10 segundos
- 📊 Estadísticas globales:
- cantidad de proyectos
- carpetas
- archivos
- tamaño total
- 📦 Visualización jerárquica de directorios
- ⚡ Renderizado dinámico con AJAX
- 🧠 Preserva carpetas abiertas tras actualizar
- 📱 Diseño responsive
- 🪶 Sin dependencias externas
- 🐘 Hecho únicamente con PHP + JavaScript vanilla
El sistema:
- Escanea automáticamente una carpeta base
- Detecta proyectos dentro de ella
- Muestra estadísticas globales
- Permite expandir carpetas y navegar archivos
- Se actualiza automáticamente sin recargar la página
/var/www/html/
├── proyecto1/
├── proyecto2/
├── proyecto3/
└── index.php
Cada carpeta dentro de basePath es considerada un proyecto independiente.
Dentro del archivo index.php:
$basePath = '/var/www/html/';Define la carpeta raíz que será escaneada.
También puedes excluir carpetas:
$excludeDirs = ['.', '..', '.git', 'node_modules'];Y excluir archivos:
$excludeFiles = ['README.md', '.htaccess'];git clone https://github.com/usuario/workspace-explorer.gitPor ejemplo:
sudo cp index.php /var/www/html/sudo chmod 755 /var/www/html/index.phphttp://localhost/index.php
- PHP 7.4 o superior
- Apache o Nginx
- Permisos de lectura sobre las carpetas escaneadas
El frontend utiliza:
fetch('?ajax=1')para consultar el backend cada 10 segundos y actualizar:
- proyectos
- archivos
- carpetas
- tamaños
- estructura visual
sin necesidad de refrescar manualmente la página.
Incluye:
- 🌙 Dracula Dark
- ☀️ Dracula Light
El tema seleccionado se guarda automáticamente usando:
localStorageEl sistema calcula automáticamente:
- cantidad total de proyectos
- cantidad total de carpetas
- cantidad total de archivos
- tamaño total del workspace
Utilizando funciones recursivas en PHP.
Escanea directorios recursivamente.
Cuenta archivos, carpetas y tamaño total.
Genera toda la estructura de datos de proyectos.
Renderiza dinámicamente el frontend.
El explorador detecta extensiones y muestra iconos automáticamente:
| Extensión | Icono |
|---|---|
| php | 🐘 |
| js | ⚡ |
| css | 🎨 |
| html | 🌐 |
| md | 📖 |
| 📕 | |
| zip | 📦 |
| py | 🐍 |
| mp3 | 🎵 |
| mp4 | 🎬 |
La interfaz utiliza:
grid-template-columns: repeat(auto-fill, minmax(400px, 1fr));permitiendo adaptarse automáticamente a:
- desktop
- notebook
- tablet
- móvil
El proyecto incluye:
htmlspecialchars()para prevenir XSS- validación básica de rutas
- exclusión de directorios sensibles
- escape HTML en frontend
- PHP
- HTML5
- CSS3
- JavaScript Vanilla
- AJAX
- LocalStorage
Perfecto para:
- servidores de desarrollo
- dashboards internos
- workspaces de programación
- hosting local
- laboratorios de pruebas
- exploradores de proyectos
- NAS caseros
- Raspberry Pi
- servidores Linux
- búsqueda de archivos
- breadcrumbs
- sistema de autenticación
- WebSockets en tiempo real
- previews de imágenes
- editor integrado
- soporte drag & drop
- compresión ZIP
- soporte multiusuario
Puedes agregar screenshots aquí:
MIT License
Desarrollado por Gustavo Godoy.
Si el proyecto te sirve:
- dale una estrella en GitHub ⭐
- haz fork 🍴
- contribuye 🚀