Marvel Character App Welcome to the Marvel Character App! This Android application is built using Kotlin and follows the MVVM (Model-View-ViewModel) architecture. It utilizes Retrofit for network requests, Room Database for local storage, ViewModel and LiveData for efficient data management, Glide for seamless image loading, RecyclerView for displaying lists of Marvel characters, and more.
Features Marvel Character Data: Fetches comprehensive character details, including descriptions, stories, comics, comic details, and images, from the official Marvel API website.
Offline Access: Stores fetched data locally in a Room Database, ensuring that you can still access character information even when offline.
Smooth Image Loading: Utilizes Glide image loading library to provide a smooth and efficient image loading experience.
Elegant UI: Displays character data in a clean and user-friendly interface powered by RecyclerView.
Getting Started To get started with the Marvel Character App, follow these steps:
Clone or download the repository to your local machine:
shell Copy code git clone https://github.com/Mo-hi-t/Marvel_App.git API Key Setup: Replace YOUR_MARVEL_API_KEY with your actual Marvel API key in the ApiClient.kt file. If you don't have a Marvel API key, you can obtain one by signing up on the Marvel Developer Portal or try https://developer.marvel.com/docs.
Build and Run: Open the project in Android Studio and build it. Run the app on an emulator or a physical device.
Images:
images for where to fetch the api
images for flow of App
Architecture The Marvel Character App is built using Kotlin and follows the MVVM (Model-View-ViewModel) architecture pattern. The key components of the architecture are:
Model: Handles the data and business logic. Manages communication with the network and local database.
View: Represents the UI elements. Observes ViewModel's LiveData and reacts to data changes.
ViewModel: Manages UI-related data and communicates with the Model. Provides data to the View using LiveData.
The app's data flow involves fetching character data from the Marvel API using Retrofit, storing the data in the Room Database, and then displaying it in the UI using RecyclerView and LiveData.
Libraries Used Retrofit: A type-safe HTTP client for making network requests.
Room Database: A robust and flexible local storage solution for caching data.
ViewModel: Manages UI-related data and handles configuration changes.
LiveData: Provides an observable data holder that updates the UI when data changes.
Glide: A fast and efficient image loading library for Android.
RecyclerView: A powerful UI component for displaying lists and grids.
Contributing I welcome contributions to the Marvel Character App! To contribute, please follow these steps:
Fork the repository.
Create a new branch for your feature or bug fix.
Make your changes and test them thoroughly.
Submit a pull request describing your changes and improvements.
Contact For any inquiries or feedback, please contact me at [email protected]
Explore the Marvel Character App and dive into the fascinating world of Marvel characters. Stay entertained, informed, and captivated by the stories and information behind every character!
Disclaimer: This app is developed solely for educational and non-commercial purposes. The Marvel API is used for data display and belongs to Marvel Entertainment, LLC.