ui/compose/WandaTopLevel.kt
Shell Principal
Shell con drawer lateral, top bar grande, tema WandaElements y navegacion entre secciones. Punto de entrada de la interfaz, maneja el estado global de navegacion y las transiciones entre destinos.
Devs
Esta seccion resume los modulos y archivos clave para mantener Wanda Files. Arquitectura MVVM estandar con Compose, permisos granulares y APIs nativas de Android storage. Cada modulo tiene responsabilidad unica y Interfaces claras.
ui/compose/WandaTopLevel.kt
Shell con drawer lateral, top bar grande, tema WandaElements y navegacion entre secciones. Punto de entrada de la interfaz, maneja el estado global de navegacion y las transiciones entre destinos.
screens/FilesScreen.kt
Pantalla principal del explorador local con breadcrumb interactivo, barra de busqueda, vistas de lista y cuadricula, y render de archivos y carpetas con iconos diferenciados por tipo de extension.
screens/MediaAndTools.kt
Galeria integrada de fotos y videos, visor PDF con PdfRenderer, seccion de favoritos, analisis de almacenamiento y papelera de reciclaje. Agrupa todas las pantallas de herramientas en un solo modulo.
features/analyze/
Modulo de analisis de almacenamiento: escaneo de archivos por categoria, deteccion de carpetas grandes, archivos pesados y espacio recuperable. Todo procesado localmente con el MediaStore y el filesystem directo.
features/pdf/
Implementacion del visor PDF nativo usando PdfRenderer. Soporte para zoom, scroll fluido, navegacion por paginas y apertura de documentos desde intents externos. Sin dependencias de Adobe o libs pesadas.
ui/theme/Theme.kt
Design tokens del sistema visual: obsidian para fondos oscuros, turquesa para acentos primarios, celeste para secundarios. Radios de borde, animaciones de movimiento y paleta completa en modo claro y oscuro.
features/favorites/
Sistema de marcado de archivos favoritos con persistencia local. Acceso rapido desde el dashboard, filtros por tipo y ordenamiento personalizado. Los favoritos se sincronizan con el estado de la sesion.
features/trash/
Gestion de archivos eliminados con retencion temporal. Los archivos borrados se mueven a una papelera interna antes de eliminarse permanentemente. Permite recuperacion selectiva o vaciado completo.
Puntos clave que definen la estructura tecnica de la app y que todo colaborador debe conocer.
Wanda Files es open source. El codigo esta disponible para que cualquiera pueda revisar, reportar problemas o proponer mejoras. Cada cambio pasa por revision antes de mergerse a la rama principal.