Welcome to Random Mammals, a delightful Android app that brings joy to users by showcasing random cute mammal images. This app is designed to provide users with a daily dose of cuteness while also allowing them to save their favorite images. The app combines multiple APIs to fetch mammal images, follows the MVVM architecture for a clean and scalable codebase, and utilizes a Room Database for efficient data storage.
-
Random Mammal Images: Enjoy a variety of adorable mammal images fetched from multiple APIs.
-
Save Favorites: Users can save their favorite images to view them later.
-
MVVM Architecture: The app follows the Model-View-ViewModel (MVVM) architecture for better separation of concerns and maintainability.
-
Room Database: Efficiently store and retrieve favorite mammal images using the Room Database.
To get started with the Random Mammals app, follow these steps:
-
Clone the repository:
git clone https://github.com/your-username/random-mammals.git
-
Open the project in Android Studio.
-
Build and run the app on your Android device or emulator.
-
Explore the app and enjoy the cuteness!
The app uses the following key dependencies:
- Retrofit: For handling API requests.
- Coil: For image loading and caching.
- Room: For local database storage.
Make sure to check the build.gradle file for the complete list of dependencies.
We welcome contributions from the community to make Random Mammals even better. To contribute, follow these steps:
-
Fork the repository.
-
Create a new branch for your feature or bug fix:
git checkout -b feature/new-feature
-
Make your changes and commit them:
git commit -m "Add new feature" -
Push your changes to your fork:
git push origin feature/new-feature
-
Create a pull request.
We appreciate your contributions!
Random Mammals is open-source and licensed under the MIT License.
Thank you for choosing Random Mammals! If you have any questions or feedback, feel free to reach out to us. Enjoy the cuteness!