# 📋 Changelog

## [3.1.0] - 2026-02-11 🚀

### ✨ Added

- **Relocated Language Toggle** - Moved language switch to the status bar area for better accessibility and a cleaner header
- **Premium "Apply" Button** - Redesigned with high-contrast colors (Vibrant Green/Black), increased size, and reactive animations

### 🔧 Changed

- **UI Space Optimization** - Vertically compressed stat cards (Themes, Config, Root) to maximize vertical space for theme selection
- **Donation Integration** - Added direct donation links in both WebUI and flash installer

---

## [3.0.0] - 2026-02-11 🚀

### ✨ Added

- **Visual Theme Previews** - Completely redesigned theme selection UI featuring image previews for a more intuitive experience
- **Horizontal Theme Picker** - Smooth horizontal scrolling for theme cards with a "peek" animation to guide the user
- **Native Donation Integration** - Added `donate` field in `module.prop` for native KernelSU/Magisk Manager support
- **Enhanced Telegram Banner** - New eye-catching, animated banner with better compatibility for Android WebViews
- **Click-to-Select UI** - Replaced old dropdowns with a premium card-based interface

### 🔧 Changed

- **Version Bump** - Major update to v3.0.0 (versionCode 300)
- **Robust Config Sync** - Improved theme persistence with automatic syncing between `config.json` and `system.prop`
- **Installer Optimization** - Improved `system.prop` detection during installation for better initial config generation
- **UI Tweaks** - Cleaned up installation messages by removing redundant "No keyboards found" notification

### 🐛 Fixed

- **Initial Load Issue** - Fixed WebUI not displaying default themes on the first reboot after flashing

---

## [2.4.0] - 2026-02-10 🚀

### 🐛 Fixed

- **Duplicate app listing during flash** - Apps being replaced were shown twice (once by the script, once by Magisk/KSU framework "Target:" output). Fixed by removing leading whitespace from `KEYBOARD_PATHS` that caused empty target entries
- **Self-referencing REPLACE path** - Removed `/system/app/gboardlite_apmods` from the REPLACE/REMOVE list since it's the module's own install path

### 🔧 Changed

- **Cleaner flash output** - Added "Replacing system keyboards..." message before the framework lists targets
- **KEYBOARD_PATHS formatting** - Paths are now cleanly formatted without excessive indentation that could cause parsing issues

---

## [2.3.0] - 2026-02-10 🚀

### ✨ Added

- **Download retry mechanism** - APK download now retries up to 3 times with delay on failure
- **APK size validation** - Verifies downloaded APK is larger than 1MB to detect corrupt downloads
- **WebUI server auto-start** - Web server now starts automatically at boot for theme management
- **timeout command fallback** - Gracefully handles devices without the `timeout` command

### 🔧 Changed

- **Refactored localization system** - Compact `_msg()` helper reduces lang.sh from 271 to ~105 lines
- **Unified detect_language()** - Single implementation in lang.sh, shared across all scripts
- **Unified keyboard paths** - REMOVE/REPLACE paths defined once instead of duplicated
- **Simplified uninstall logging** - Log messages always in English for debugging clarity (70% size reduction)
- **Simplified service script** - Removed redundant localization for log-only messages (48% size reduction)
- **Synced version numbers** - module.prop and update.json now consistent
- **Updated documentation** - Fixed architecture info and download links in README

### 🐛 Fixed

- **Dead code: apply_theme()** - Moved before main() execution in post-fs-data.sh
- **Dead code: start_webui_server()** - Now properly called from service.sh main()
- **Version mismatch** - module.prop (was 2.2) now matches update.json (2.3)

---

## [2.2.0] - 2025-12-08 🚀

### ✨ Added

- **English language support (WebUI)** - The web interface now supports both English and Spanish with a toggle switch
- **APK updated to version 16.3.6** - Latest Gboard Lite with performance improvements

---

## [2.1.0] - 2025-09-22 🚀

### ✨ Added

- **Integración de WebUI para gestión de temas**: ahora los temas se pueden escanear, listar y aplicar desde la interfaz web.
- **Escaneo automático de temas al verificar el módulo**: `checkModule` llama directamente a `scanThemes(true)` para mostrar de inmediato los temas disponibles.
- **Selector dinámico de temas**: el escáner usa un bucle shell para recolectar todos los `.zip`, eliminar duplicados y ordenarlos antes de mostrarlos.
- **Contador de temas y actualización automática**: la tarjeta de configuración muestra el total de temas disponibles.
- **Renderizado limpio**: se eliminó el bloque “Gestión de Temas”; después del loader se pasa directamente a la configuración.

---

## [1.2.0] - 2025-09-19

### ✨ Added

- **Gboard Lite updated to version 16.0.2**
- **Added customs themes**

## [1.1.0] - 2025-09-19

### ✨ Added

- **Multi-language installation support** - Scripts now detect system language and display messages in: English, Spanish.
- **Language fallback system** - Defaults to English if system language is not supported.
- **Localized error messages** - Common installation errors now appear in the user’s preferred language.
- **Translation-ready architecture** - Easy to add new languages via simple JSON or properties files.

### 🔧 Changed

- Minor optimizations to language detection logic for faster startup.
- Updated logging to include language context for easier debugging.

### 🐛 Fixed

- Minor UI inconsistencies in non-English installations.
- Fixed encoding issues in Cyrillic and accented Latin characters.

---

## [1.0.0] - 2024-09-18

### ✨ Added

- **Gboard Lite APK v15.9.4** - Latest optimized version with improved performance
- **Complete script rewrite** - Enhanced installation system with better reliability
- **Comprehensive logging system** - Detailed logs for troubleshooting and debugging
- **Multi-architecture support** - Automatic detection and installation for ARM, ARM64, x86
- **System readiness validation** - Ensures Android is fully initialized before installation
- **Enhanced download mechanism** - Reliable APK download with timeout and retry logic
- **Backup and restore system** - Safe file management with automatic restoration on uninstall
- **KernelSU and Magisk compatibility** - Full support for both root methods
- **Conflict detection** - Prevents installation with multiple root implementations
- **Service monitoring** - Boot-time verification of module status
- **Automated optimization** - Post-install app compilation for better performance
- **Telegram integration** - Direct links to support channels and community

### 🔧 Changed

- **Installation flow completely redesigned** - More robust and user-friendly process
- **Error messages improved** - Clearer descriptions for better troubleshooting
- **Permission handling enhanced** - Better security with proper SELinux contexts
- **Module detection logic** - Improved compatibility checks
- **Progress feedback** - Real-time status updates during installation
- **Binary management** - Included curl and cmpr binaries for better reliability

### 🐛 Fixed

- **Download timeout issues** - Better handling of slow network connections
- **Permission errors** - Proper file ownership and permissions assignment
- **Mount point conflicts** - Safer handling of existing Gboard installations
- **API compatibility** - Better support across different Android versions (8.1+)
- **Installation failures** - Comprehensive error checking and recovery
- **Service script reliability** - Improved boot-time module verification

### 🗑️ Removed

- **Beta limitations** - Removed experimental restrictions and warnings
- **Debug code** - Cleaned up development-only functions
- **Redundant checks** - Streamlined validation process

---

## [0.7.0-beta] - 2024-08-25

### ✨ Added

- **Beta release** - Initial public testing version
- **Basic installation system** - Core module functionality
- **Gboard Lite APK v15.8.1** - First optimized keyboard version
- **Magisk integration** - Standard Magisk module support
- **System app replacement** - Replaces stock keyboard applications
- **Basic error handling** - Simple installation validation

### 🔧 Changed

- **Installation method** - Direct APK installation approach
- **Module structure** - Standard Magisk module format

### ⚠️ Known Issues

- Limited error handling in edge cases
- Manual configuration required after installation
- Basic logging system

---

## [0.6.0-beta] - 2024-08-10

### ✨ Added

- **Initial module structure** - Basic Magisk module framework
- **APK integration system** - Core installation mechanism
- **Gboard Lite APK v15.7.0** - Early optimized version

### 🔧 Changed

- **Development approach** - Switched to modular design
- **Installation scripts** - Basic automation implemented

### ⚠️ Known Issues

- Installation not fully automated
- Limited device compatibility testing
- Requires manual post-install configuration

---

## [0.5.0-alpha] - 2024-07-28

### ✨ Added

- **Proof of concept** - Initial working prototype
- **Manual installation process** - Basic APK replacement method
- **Gboard Lite APK v15.6.0** - First lite version

### ⚠️ Known Issues

- Fully manual process required
- No automation or error handling
- Limited to specific device configurations

---

## 📊 Release Statistics

| Version    | Release Date | Type   | Key Milestone              |
|------------|--------------|--------|----------------------------|
| 3.1.0      | 2026-02-11   | Stable | UI Refinements + UX Polish |
| 3.0.0      | 2026-02-11   | Stable | Visual Previews + Premium UI |
| 2.4.0      | 2026-02-10   | Stable | Fix duplicate app listing  |
| 2.3.0      | 2026-02-10   | Stable | Code refactor + retry DL   |
| 2.2.0      | 2025-12-08   | Stable | English WebUI + APK 16.3.6 |
| 2.1.0      | 2025-09-22   | Stable | WebUI theme management     |
| 1.1.0      | 2025-09-19   | Stable | Multi-language support     |
| 1.0.0      | 2024-09-18   | Stable | First stable release       |
| 0.7.0-beta | 2024-08-25   | Beta   | Public testing             |
| 0.6.0-beta | 2024-08-10   | Beta   | Core functionality         |
| 0.5.0-alpha| 2024-07-28   | Alpha  | Initial prototype          |

---

## 🎯 Roadmap

### Version 3.1.0 (Planned)

- [ ] APK checksum/hash verification for download integrity
- [ ] Support for additional languages (Portuguese, French)
- [ ] Automatic theme backup on uninstall

---

## 🔗 Links

- **Download Latest**: [v3.0.0 Release](../../releases/latest)
- **Report Issues**: [GitHub Issues](../../issues)
- **Join Community**: [Telegram @apmodsx](https://t.me/apmodsx)
- **Get Support**: [Telegram Chat](https://t.me/apmodsgroup)

---

## 📝 Migration Notes

### From Stable 1.0 to 1.1

- **Automatic migration** - No manual steps required
- **Settings preserved** - All your configurations remain intact
- **New feature** - Enjoy installation messages in your system language!
- **Backward compatible** - Safe upgrade with no breaking changes

---

## 📝 Legend

- ✨ **Added** - New features and functionality
- 🔧 **Changed** - Modifications to existing features
- 🐛 **Fixed** - Bug fixes and issue resolutions  
- 🗑️ **Removed** - Deprecated or removed features
- ⚠️ **Known Issues** - Acknowledged problems (Beta versions)
- 🎉 **Major Release** - Significant milestone versions
- 🌍 **Localization** - Language and region support

---

<div align="center">

**📸 ¡Previsualizaciones visuales llegan en v3.0.0! 📸**

*Haciendo la personalización más intuitiva que nunca*

**Maintained by [APMods Team](https://t.me/apmodsx)**

</div>