📚 Mis Mangas

🌍 Select Language:
🇬🇧 English | 🇪🇸 Español

---

🇬🇧 English

Mis Mangas is an iOS and macOS application developed as the final project for the Swift Developer Program 2024. It allows users to manage their personal manga collection, explore an extensive catalog, and enjoy a seamless experience optimized for Apple’s latest technologies.

🚀 Key Features

📖 Manga Exploration

• Browse a catalog of over 64,000 titles with detailed information.
• Advanced search by title, genre, theme, demographic, and author.
• Dynamic filtering to quickly find your favorite mangas.

📂 Collection Management

• Store and organize your personal collection.
• Track your reading progress and owned volumes.
• Mark complete collections.

🖥️ Adaptive Design

• Fully compatible with iPhone, iPad, and macOS.
• Optimized experience using NavigationSplitView for larger screens.

🔄 Smart Synchronization

• Local storage with SwiftData.
• Secure authentication, with tokens stored in the device keychain.

📲 Integrated Widget

• View your reading progress directly from the home screen.

🛠️ Technologies Used

• Swift 6: Optimized for the latest language features.
• SwiftUI: Modern and adaptive UI framework.
• Strict Concurrency: Leveraging Swift 6’s async/await for performance.
• SwiftData: Efficient and secure data storage.
• Swift Testing: Test coverage, ensuring stability and reliability.

🏆 Implementation Levels

Version	Features
🥉 Basic	✅ Browse catalog and basic search. ✅ Local collection management. ✅ iPhone and iPad compatibility.
🥈 Intermediate	✅ Advanced filtering by genre, theme, demographic, and author. ✅ Adaptive design with list, detail, and grid views.
🥇 Advanced	✅ Cloud-synced collection management. ✅ Secure authentication and token storage.
🏅 Deluxe	✅ macOS support. ✅ Static widget displaying reading progress.

📋 Requirements

• Operating System: iOS 18+, iPadOS 18+, macOS 14+
• Xcode: Version 16 or later
• Language: Swift 6

✅ Code Coverage

This project is covered with Swift Testing, ensuring high stability and quality. Best practices in concurrency and data management have been applied for optimal performance.

🎨 Screenshots

📸 Coming soon

🤝 Contributions

Contributions are welcome! If you have ideas or improvements, feel free to open an issue or submit a pull request.

---

🚀 Developed as part of the Swift Developer Program 2024.

---

🇪🇸 Español

Mis Mangas es una aplicación para iOS y macOS desarrollada como proyecto final del Swift Developer Program 2024. Permite a los usuarios gestionar su colección de mangas, explorar un catálogo extenso y disfrutar de una experiencia fluida optimizada para las últimas tecnologías de Apple.

🚀 Características Principales

📖 Exploración del Catálogo

• Navega por un catálogo con más de 64,000 títulos con información detallada.
• Búsqueda avanzada por título, género, temática, demografía y autor.
• Filtrado dinámico para encontrar mangas fácilmente.

📂 Gestión de Colecciones

• Almacena y organiza tu colección personal.
• Registra el progreso de lectura y los volúmenes adquiridos.
• Indica si posees la colección completa.

🖥️ Diseño Adaptativo

• Compatible con iPhone, iPad y macOS.
• Experiencia optimizada con NavigationSplitView en pantallas grandes.

🔄 Sincronización Inteligente

• Almacenamiento local con SwiftData.
• Autenticación segura, con tokens almacenados en el llavero del dispositivo.

📲 Widget Integrado

• Visualiza tu progreso de lectura directamente en la pantalla de inicio.

🛠️ Tecnologías Utilizadas

• Swift 6: Código optimizado para las últimas versiones del lenguaje.
• SwiftUI: Interfaz moderna y adaptable.
• Concurrencia Estricta: Implementación con async/await, aprovechando las mejoras de Swift 6.
• SwiftData: Almacenamiento eficiente y seguro.
• Swift Testing: Cobertura de test, asegurando estabilidad y fiabilidad.

🏆 Niveles de Implementación

Versión	Características
🥉 Básica	✅ Consulta del catálogo y búsqueda básica. ✅ Gestión local de la colección. ✅ Compatibilidad con iPhone y iPad.
🥈 Media	✅ Filtrado avanzado por género, temática, demografía y autor. ✅ Diseño adaptativo con vistas de listado, detalle y grid.
🥇 Avanzada	✅ Gestión de colecciones sincronizadas en la nube. ✅ Autenticación segura y almacenamiento de tokens.
🏅 Deluxe	✅ Soporte para macOS. ✅ Widget con progreso de lectura.

📋 Requisitos

• Sistema Operativo: iOS 18+, iPadOS 18+, macOS 14+
• Xcode: Versión 16 o superior
• Lenguaje: Swift 6

✅ Cobertura de Código

El proyecto cuenta con cobertura mediante Swift Testing, asegurando estabilidad y calidad en todas sus funcionalidades. Se han aplicado las mejores prácticas en concurrencia y gestión de datos para garantizar un rendimiento óptimo.

🎨 Capturas de Pantalla

📸 Próximamente

🤝 Contribuciones

¡Se aceptan contribuciones! Si tienes ideas o mejoras, abre un issue o envía un pull request.

---

🚀 Desarrollado como parte del Swift Developer Program 2024.