VanillaComposer

🖼

🌐 Language / Idioma:

• 🇺🇸 English
• 🇪🇸 Español

---

English Documentation

A modern desktop application for minifying and optimizing HTML, CSS, and JavaScript files with a sleek dark OLED interface and rounded window borders.

🚀 Features

• Modern Dark OLED Interface: Beautiful, modern UI with smooth animations and rounded window borders
• File Minification: Compress HTML, CSS, and JavaScript files efficiently
• Batch Processing: Process entire directories with subdirectories recursively
• Progress Tracking: Real-time progress updates during processing with detailed statistics
• Structure Preservation: Maintains original folder structure in output directory
• Space Saving Analytics: Shows compression statistics and space saved percentage
• Multi-language Support: Interface available in English and Spanish
• Cross-Platform: Works seamlessly on Windows, macOS, and Linux
• Customizable Options: Configure minification settings and output directory

� Download & Installation

1. Download the latest release from the Releases page

2. Choose your platform:

   • Windows: Download VanillaComposer-Setup-1.0.0.exe
   • macOS: Download VanillaComposer-1.0.0.dmg
   • Linux: Download VanillaComposer-1.0.0.AppImage

3. Install and run:

   • Windows: Run the installer and follow the setup wizard
   • macOS: Open the DMG file and drag the app to Applications folder
   • Linux: Make the AppImage executable and run it

🎯 How to Use

Step 1: Welcome Screen

• Launch VanillaComposer
• You'll see the welcome screen with app information
• Click "Get Started" to begin

Step 2: Select Directory

• Click "Choose Directory" button
• Navigate to the folder containing your HTML, CSS, and JavaScript files
• The app will analyze and count all supported files

Step 3: Configure Options

• Output Directory: Choose where to save minified files (default: "minified")
• File Types: Select which file types to process (HTML, CSS, JS)
• Minification Options:
  • Remove comments from files
  • Remove whitespace and formatting
  • Remove redundant attributes
  • Minify inline CSS and JavaScript
  • Drop console statements (JavaScript only)

Step 4: Start Processing

• Click "Start Minification" to begin optimization
• Monitor real-time progress with detailed statistics
• View current file being processed

Step 5: View Results

• Review compression statistics
• See total space saved percentage
• Access your optimized files in the output directory

File Support

• HTML files (.html): Removes whitespace, comments, and optimizes inline CSS/JS
• CSS files (.css): Minifies stylesheets and optimizes selectors
• JavaScript files (.js): Compresses, obfuscates, and optimizes code

📤 Output Structure

The application creates an output folder containing:

• Minified versions of all supported files
• Original folder structure preserved
• Non-supported files copied as-is
• Detailed processing report

� System Requirements

• Windows: Windows 10 or later
• macOS: macOS 10.15 (Catalina) or later
• Linux: Modern Linux distribution with GTK3 support
• RAM: 4GB minimum, 8GB recommended
• Disk Space: 100MB for installation + space for processed files

💡 Tips for Best Results

1. Backup First: Always backup your original files before processing
2. Test Output: Verify minified files work correctly in your projects
3. Large Projects: For very large projects, consider processing in smaller batches
4. Custom Settings: Adjust minification options based on your specific needs
5. File Organization: Keep your source files organized in clear folder structures

🛠️ Troubleshooting

Common Issues:

• App won't start: Check system requirements and try running as administrator
• Files not processing: Ensure files are not read-only and you have write permissions
• Slow processing: Close other applications to free up system resources
• Corrupted output: Check original files for syntax errors before processing

Getting Help:

• Check the Issues page for known problems
• Create a new issue if you encounter a bug
• Include your operating system and app version when reporting issues

👨‍💻 Author

Systemm32 - Full Stack Developer

📄 License

Proprietary License - This software is free to use for personal and commercial purposes but comes with strict restrictions on modification and redistribution. See LICENSE file for complete terms.

🔄 Updates

• Updates are automatically checked when you start the application
• Download new versions from the Releases page
• Follow the project to get notifications about new releases

---

Documentación en Español

Una aplicación de escritorio moderna para minificar y optimizar archivos HTML, CSS y JavaScript con una elegante interfaz OLED oscura y bordes redondeados.

🚀 Características

• Interfaz OLED Oscura Moderna: Hermosa interfaz moderna con animaciones suaves y bordes redondeados
• Minificación de Archivos: Comprime archivos HTML, CSS y JavaScript de manera eficiente
• Procesamiento por Lotes: Procesa directorios completos con subdirectorios de forma recursiva
• Seguimiento de Progreso: Actualizaciones de progreso en tiempo real con estadísticas detalladas
• Preservación de Estructura: Mantiene la estructura de carpetas original en el directorio de salida
• Análisis de Ahorro de Espacio: Muestra estadísticas de compresión y porcentaje de espacio ahorrado
• Soporte Multi-idioma: Interfaz disponible en inglés y español
• Multiplataforma: Funciona perfectamente en Windows, macOS y Linux
• Opciones Personalizables: Configura ajustes de minificación y directorio de salida

� Descarga e Instalación

1. Descarga la última versión desde la página de Releases

2. Elige tu plataforma:

   • Windows: Descarga VanillaComposer-Setup-1.0.0.exe
   • macOS: Descarga VanillaComposer-1.0.0.dmg
   • Linux: Descarga VanillaComposer-1.0.0.AppImage

3. Instala y ejecuta:

   • Windows: Ejecuta el instalador y sigue el asistente de instalación
   • macOS: Abre el archivo DMG y arrastra la aplicación a la carpeta Aplicaciones
   • Linux: Haz el AppImage ejecutable y ejecútalo

🎯 Cómo Usar

Paso 1: Pantalla de Bienvenida

• Inicia VanillaComposer
• Verás la pantalla de bienvenida con información de la aplicación
• Haz clic en "Comenzar" para empezar

Paso 2: Seleccionar Directorio

• Haz clic en el botón "Elegir Directorio"
• Navega hasta la carpeta que contiene tus archivos HTML, CSS y JavaScript
• La aplicación analizará y contará todos los archivos compatibles

Paso 3: Configurar Opciones

• Directorio de Salida: Elige dónde guardar los archivos minificados (predeterminado: "minified")
• Tipos de Archivo: Selecciona qué tipos de archivo procesar (HTML, CSS, JS)
• Opciones de Minificación:
  • Eliminar comentarios de los archivos
  • Eliminar espacios en blanco y formato
  • Eliminar atributos redundantes
  • Minificar CSS y JavaScript inline
  • Eliminar declaraciones console (solo JavaScript)

Paso 4: Iniciar Procesamiento

• Haz clic en "Iniciar Minificación" para comenzar la optimización
• Monitorea el progreso en tiempo real con estadísticas detalladas
• Ve el archivo actual siendo procesado

Paso 5: Ver Resultados

• Revisa las estadísticas de compresión
• Ve el porcentaje total de espacio ahorrado
• Accede a tus archivos optimizados en el directorio de salida

📁 Compatibilidad de Archivos

• Archivos HTML (.html): Elimina espacios en blanco, comentarios y optimiza CSS/JS inline
• Archivos CSS (.css): Minifica hojas de estilo y optimiza selectores
• Archivos JavaScript (.js): Comprime, ofusca y optimiza código

📤 Estructura de Salida

La aplicación crea una carpeta de salida que contiene:

• Versiones minificadas de todos los archivos compatibles
• Estructura de carpetas original preservada
• Archivos no compatibles copiados tal como están
• Reporte detallado del procesamiento

� Requisitos del Sistema

• Windows: Windows 10 o posterior
• macOS: macOS 10.15 (Catalina) o posterior
• Linux: Distribución Linux moderna con soporte GTK3
• RAM: 4GB mínimo, 8GB recomendado
• Espacio en Disco: 100MB para instalación + espacio para archivos procesados

💡 Consejos para Mejores Resultados

1. Hacer Backup Primero: Siempre respalda tus archivos originales antes de procesar
2. Probar Salida: Verifica que los archivos minificados funcionen correctamente en tus proyectos
3. Proyectos Grandes: Para proyectos muy grandes, considera procesar en lotes más pequeños
4. Configuraciones Personalizadas: Ajusta las opciones de minificación según tus necesidades específicas
5. Organización de Archivos: Mantén tus archivos fuente organizados en estructuras de carpetas claras

🛠️ Solución de Problemas

Problemas Comunes:

• La aplicación no inicia: Verifica los requisitos del sistema y prueba ejecutar como administrador
• Los archivos no se procesan: Asegúrate de que los archivos no sean de solo lectura y tengas permisos de escritura
• Procesamiento lento: Cierra otras aplicaciones para liberar recursos del sistema
• Salida corrupta: Verifica que los archivos originales no tengan errores de sintaxis antes de procesar

Obtener Ayuda:

• Revisa la página de Issues para problemas conocidos
• Crea un nuevo issue si encuentras un bug
• Incluye tu sistema operativo y versión de la aplicación al reportar problemas

👨‍� Autor

Systemm32 - Desarrollador Full Stack

📄 Licencia

Licencia Propietaria - Este software es gratuito para uso personal y comercial pero tiene restricciones estrictas sobre modificación y redistribución. Consulta el archivo LICENSE para los términos completos.

🔄 Actualizaciones

• Las actualizaciones se verifican automáticamente cuando inicias la aplicación
• Descarga nuevas versiones desde la página de Releases
• Sigue el proyecto para recibir notificaciones sobre nuevas versiones