{"id":15025717,"url":"https://github.com/skydoves/marvelheroes","last_synced_at":"2025-05-16T18:07:46.704Z","repository":{"id":38223960,"uuid":"249726267","full_name":"skydoves/MarvelHeroes","owner":"skydoves","description":"❤️ A sample Marvel heroes application based on MVVM (ViewModel, Coroutines, Room, Repository, Koin)  architecture.","archived":false,"fork":false,"pushed_at":"2021-11-14T09:04:44.000Z","size":18225,"stargazers_count":1246,"open_issues_count":0,"forks_count":169,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-04-12T16:59:23.110Z","etag":null,"topics":["android","coroutines","databinding","dependency-injection","kotlin","material-components","material-design","mvvm","mvvm-android","mvvm-architecture","repository","retrofit2","room","skydoves"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skydoves.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null},"funding":{"github":"skydoves","custom":["https://www.paypal.me/skydoves","https://www.buymeacoffee.com/skydoves"]}},"created_at":"2020-03-24T14:13:26.000Z","updated_at":"2025-03-29T20:54:40.000Z","dependencies_parsed_at":"2022-08-09T00:16:43.667Z","dependency_job_id":null,"html_url":"https://github.com/skydoves/MarvelHeroes","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FMarvelHeroes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FMarvelHeroes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FMarvelHeroes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FMarvelHeroes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skydoves","download_url":"https://codeload.github.com/skydoves/MarvelHeroes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582907,"owners_count":22095518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","coroutines","databinding","dependency-injection","kotlin","material-components","material-design","mvvm","mvvm-android","mvvm-architecture","repository","retrofit2","room","skydoves"],"created_at":"2024-09-24T20:02:53.256Z","updated_at":"2025-05-16T18:07:46.650Z","avatar_url":"https://github.com/skydoves.png","language":"Kotlin","funding_links":["https://github.com/sponsors/skydoves","https://www.paypal.me/skydoves","https://www.buymeacoffee.com/skydoves"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eMarvelHeroes\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://android-arsenal.com/api?level=21\"\u003e\u003cimg alt=\"API\" src=\"https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/skydoves/MarvelHeroes/actions\"\u003e\u003cimg alt=\"Build Status\" src=\"https://github.com/skydoves/MarvelHeroes/workflows/Android%20CI/badge.svg\"/\u003e\u003c/a\u003e \n  \u003ca href=\"https://github.com/skydoves\"\u003e\u003cimg alt=\"Profile\" src=\"https://skydoves.github.io/badges/skydoves.svg\"/\u003e\u003c/a\u003e \n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e  \nMarvelHeroes is a demo application based on modern Android application tech-stacks and MVVM architecture.\u003cbr\u003e\nFetching data from the network and integrating persisted data in the database via repository pattern.\n\u003c/p\u003e\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"/previews/screenshot.png\"/\u003e\n\u003c/p\u003e\n\n## Download\nGo to the [Releases](https://github.com/skydoves/MarvelHeroes/releases) to download the latest APK.\n\n\u003cimg src=\"/previews/preview.gif\" align=\"right\" width=\"32%\"/\u003e\n\n## Tech stack \u0026 Open-source libraries\n- Minimum SDK level 21\n- [Kotlin](https://kotlinlang.org/) based + [Coroutines](https://github.com/Kotlin/kotlinx.coroutines) for asynchronous.\n- JetPack\n  - Lifecycle - dispose of observing data when lifecycle state changes.\n  - ViewModel - UI related data holder, lifecycle aware.\n  - Room Persistence - construct a database using the abstract layer.\n- Architecture\n  - MVVM Architecture (View - DataBinding - ViewModel - Model)\n  - Repository pattern\n  - [Koin](https://github.com/InsertKoinIO/koin) - dependency injection.\n- [Retrofit2 \u0026 Gson](https://github.com/square/retrofit) - construct the REST APIs.\n- [OkHttp3](https://github.com/square/okhttp) - implementing interceptor, logging and mocking web server.\n- [Sandwich](https://github.com/skydoves/Sandwich) - construct lightweight http API response and handling error responses.\n- [Glide](https://github.com/bumptech/glide) - loading images.\n- [TransformationLayout](https://github.com/skydoves/transformationlayout) - implementing transformation motion animations.\n- [WhatIf](https://github.com/skydoves/whatif) - checking nullable object and empty collections more fluently.\n- [AndroidVeil](https://github.com/skydoves/androidveil) - easy way to implement veil skeletons and shimmering effect.\n- [DiscreteScrollView](https://github.com/yarolegovich/DiscreteScrollView) - implementing a scrollable list of items.\n- [Timber](https://github.com/JakeWharton/timber) - logging.\n- [Material-Components](https://github.com/material-components/material-components-android) - Material design components like ripple animation, cardView.\n\n## Unit Testing Frameworks\nUnit Tests verify the interactions of viewmodels between repositories and dao \u0026 REST api requests.\n- [Robolectric](https://github.com/robolectric/robolectric) - Robolectric is the industry-standard unit testing framework for Android.\n- [Mockito-Kotlin](https://github.com/nhaarman/mockito-kotlin) - a small library that provides helper functions to work with Mockito in Kotlin.\n\n![screenshot555159853](https://user-images.githubusercontent.com/24237865/79233416-cb12d700-7ea3-11ea-9a17-a4a732c379f4.png)\n\n## Architecture\nMarvelHeroes is based on MVVM architecture and a repository pattern.\n\n![architecture](https://user-images.githubusercontent.com/24237865/77502018-f7d36000-6e9c-11ea-92b0-1097240c8689.png)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/24237865/141415477-d1af2b48-2498-4ff0-8fdf-95dff092e317.png\" align=\"right\" width=\"22%\"/\u003e\n\n## Content Credits\nAll copyrights of the contents, concepts, and phrases that are used in this open-source project belong to [Marvel Studios](https://www.marvel.com/).\n\n## Find this repository useful? :heart:\nSupport it by joining __[stargazers](https://github.com/skydoves/MarvelHeroes/stargazers)__ for this repository. :star: \u003cbr\u003e\nAnd __[follow](https://github.com/skydoves)__ me for my next creations! 🤩\n\n# License\n```xml\nDesigned and developed by 2020 skydoves (Jaewoong Eum)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskydoves%2Fmarvelheroes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskydoves%2Fmarvelheroes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskydoves%2Fmarvelheroes/lists"}