Awesome
<h1 align="center">MarvelHeroes</h1> <p align="center"> <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"/></a> <a href="https://android-arsenal.com/api?level=21"><img alt="API" src="https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat"/></a> <a href="https://github.com/skydoves/MarvelHeroes/actions"><img alt="Build Status" src="https://github.com/skydoves/MarvelHeroes/workflows/Android%20CI/badge.svg"/></a> <a href="https://github.com/skydoves"><img alt="Profile" src="https://skydoves.github.io/badges/skydoves.svg"/></a> </p> <p align="center"> MarvelHeroes is a demo application based on modern Android application tech-stacks and MVVM architecture.<br> Fetching data from the network and integrating persisted data in the database via repository pattern. </p> </br> <p align="center"> <img src="/previews/screenshot.png"/> </p>Download
Go to the Releases to download the latest APK.
<img src="/previews/preview.gif" align="right" width="32%"/>Tech stack & Open-source libraries
- Minimum SDK level 21
- Kotlin based + Coroutines for asynchronous.
- JetPack
- Lifecycle - dispose of observing data when lifecycle state changes.
- ViewModel - UI related data holder, lifecycle aware.
- Room Persistence - construct a database using the abstract layer.
- Architecture
- MVVM Architecture (View - DataBinding - ViewModel - Model)
- Repository pattern
- Koin - dependency injection.
- Retrofit2 & Gson - construct the REST APIs.
- OkHttp3 - implementing interceptor, logging and mocking web server.
- Sandwich - construct lightweight http API response and handling error responses.
- Glide - loading images.
- TransformationLayout - implementing transformation motion animations.
- WhatIf - checking nullable object and empty collections more fluently.
- AndroidVeil - easy way to implement veil skeletons and shimmering effect.
- DiscreteScrollView - implementing a scrollable list of items.
- Timber - logging.
- Material-Components - Material design components like ripple animation, cardView.
Unit Testing Frameworks
Unit Tests verify the interactions of viewmodels between repositories and dao & REST api requests.
- Robolectric - Robolectric is the industry-standard unit testing framework for Android.
- Mockito-Kotlin - a small library that provides helper functions to work with Mockito in Kotlin.
Architecture
MarvelHeroes is based on MVVM architecture and a repository pattern.
Content Credits
All copyrights of the contents, concepts, and phrases that are used in this open-source project belong to Marvel Studios.
Find this repository useful? :heart:
Support it by joining stargazers for this repository. :star: <br> And follow me for my next creations! 🤩
License
Designed and developed by 2020 skydoves (Jaewoong Eum)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.