MARVEL HEROES:

Android Kotlin + MVVM + Clean Architecture APP demo by myanes

Sample Android app with implementation for every layer of Clean Architecture:

Presentation <-> Domain <-> Data

Presentation: Screens/Views + ViewModels
Domain: Models + UseCases
Data: DTOs + Repositories + DataSources

Libraries 📦

View binding
LiveData
View models
Coroutines
Navigation (Navigaion graph)
Image loading with Picasso
Networking with Ktor
'Dependency injection' with Koin
Error handling with class Either<L, R> -> 'inspired' by https://arrow-kt.io/docs/0.10/apidocs/arrow-core-data/arrow.core/-either/
Testing with Mockito & JUnit4

Features 📋

It consists on two screen for showing list of heroes its details. Data comes from MARVEL API: https://developer.marvel.com/docs

Splash screen with custom android + Marvel logo
List screen: It shows latest modified characters from marvel. It support searching by name
Detail screen: Shows name, image, description and counters of comics, events, stories and series
Light/Dark modes (from system settings)
Survives to rotation changes: When the devices rotates the app keeps state
Error handling: When networking fails it updates the ui accordingly

Testing ⚙️

Unit tests are available for both List and Detail ViewModels. It verifies all events are handled and dispatched from/to ui fragments. It mocks usecases responses. It supports coroutines.

Some examples:

SHOW/HIDE LOADING INDICATOR
SHOW/HIDE EMPTY UI
SHOW ERROR MSG
ENTER/LEVAVE SEARCHING MODE
LIST UPDATED AFTER DATA RESULTS
LIST CLEAR BEFORE NEW SEARCH
[...]
and more

Run 📲

It targets android > 6.0 Sample APK is provided here:

apk_debug

License 📄

Feel free to use it

con ❤️ by myanes 😜

myanes-dev/marvel-android-mvvm-clean-architecture

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages