{"id":14961272,"url":"https://github.com/skydoves/pokedex","last_synced_at":"2025-05-12T15:19:42.232Z","repository":{"id":37620630,"uuid":"268501098","full_name":"skydoves/Pokedex","owner":"skydoves","description":"🗡️ Pokedex demonstrates modern Android development with Hilt, Material Motion, Coroutines, Flow, Jetpack (Room, ViewModel) based on MVVM architecture.","archived":false,"fork":false,"pushed_at":"2025-04-21T22:30:02.000Z","size":17143,"stargazers_count":8034,"open_issues_count":21,"forks_count":1075,"subscribers_count":199,"default_branch":"main","last_synced_at":"2025-04-23T17:16:09.727Z","etag":null,"topics":["android","coroutines","hilt","jetpack-android","kotlin","motion","mvvm","mvvm-architecture","pokedex","pokemon","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":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"skydoves","custom":["https://www.paypal.me/skydoves","https://www.buymeacoffee.com/skydoves"]}},"created_at":"2020-06-01T11:19:43.000Z","updated_at":"2025-04-23T13:32:38.000Z","dependencies_parsed_at":"2024-01-23T10:30:31.511Z","dependency_job_id":"11cedd86-a8ae-40c3-81e4-8c31a5fca028","html_url":"https://github.com/skydoves/Pokedex","commit_stats":{"total_commits":490,"total_committers":20,"mean_commits":24.5,"dds":"0.35306122448979593","last_synced_commit":"341cbdcb1f16564c3d482868cd2cd85a559f97e4"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FPokedex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FPokedex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FPokedex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2FPokedex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skydoves","download_url":"https://codeload.github.com/skydoves/Pokedex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250477819,"owners_count":21437049,"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","hilt","jetpack-android","kotlin","motion","mvvm","mvvm-architecture","pokedex","pokemon","skydoves"],"created_at":"2024-09-24T13:24:18.844Z","updated_at":"2025-04-23T17:16:30.572Z","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\"\u003ePokedex\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/Pokedex/actions\"\u003e\u003cimg alt=\"Build Status\" src=\"https://github.com/skydoves/Pokedex/workflows/Android%20CI/badge.svg\"/\u003e\u003c/a\u003e \u003cbr\u003e\n  \u003ca href=\"https://devlibrary.withgoogle.com/products/android/repos/skydoves-pokedex\"\u003e\u003cimg alt=\"Google\" src=\"https://skydoves.github.io/badges/google-devlib.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://proandroiddev.com/exploring-dagger-hilt-and-whats-main-differences-with-dagger-android-c8c54cd92f18\"\u003e\u003cimg alt=\"Medium\" src=\"https://skydoves.github.io/badges/Story-Medium.svg\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://youtu.be/RG9ATodwbT4\"\u003e\u003cimg alt=\"Profile\" src=\"https://skydoves.github.io/badges/youtube-google-developers.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  \u003ca href=\"https://github.com/doveletter\"\u003e\u003cimg alt=\"Profile\" src=\"https://skydoves.github.io/badges/dove-letter.svg\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e  \n🗡️ Pokedex demonstrates modern Android development with Hilt, Coroutines, Flow, Jetpack (Room, ViewModel), and Material Design based on MVVM architecture.\n\u003c/p\u003e\n\n\u003e [!TIP]\n\u003e If you want to see the Jetpack Compose version of Pokedex, check out the [Pokedex Compose](https://github.com/skydoves/pokedex-compose) repository.\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/Pokedex/releases) to download the latest APK.\n\n\u003cimg src=\"/previews/preview.gif\" align=\"right\" width=\"320\"/\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) + [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/) for asynchronous.\n- Jetpack\n  - Lifecycle: Observe Android lifecycles and handle UI states upon the lifecycle changes.\n  - ViewModel: Manages UI-related data holder and lifecycle aware. Allows data to survive configuration changes such as screen rotations.\n  - DataBinding: Binds UI components in your layouts to data sources in your app using a declarative format rather than programmatically.\n  - Room: Constructs Database by providing an abstraction layer over SQLite to allow fluent database access.\n  - [Hilt](https://dagger.dev/hilt/): for dependency injection.\n- Architecture\n  - MVVM Architecture (View - DataBinding - ViewModel - Model)\n  - [Bindables](https://github.com/skydoves/bindables): Android DataBinding kit for notifying data changes to UI layers.\n  - Repository Pattern\n- [Retrofit2 \u0026 OkHttp3](https://github.com/square/retrofit): Construct the REST APIs and paging network data.\n- [Sandwich](https://github.com/skydoves/Sandwich): Construct a lightweight and modern response interface to handle network payload for Android.\n- [Moshi](https://github.com/square/moshi/): A modern JSON library for Kotlin and Java.\n- [WhatIf](https://github.com/skydoves/whatif): Check nullable objects and empty collections more fluently.\n- [Bundler](https://github.com/skydoves/bundler): Android Intent \u0026 Bundle extensions, which insert and retrieve values elegantly.\n- [ksp](https://github.com/google/ksp): Kotlin Symbol Processing API.\n- [Turbine](https://github.com/cashapp/turbine): A small testing library for kotlinx.coroutines Flow.\n- [Material-Components](https://github.com/material-components/material-components-android): Material design components for building ripple animation, and CardView.\n- [Glide](https://github.com/bumptech/glide): Loading images from the network.\n- [TransformationLayout](https://github.com/skydoves/transformationlayout): Implementing transformation motion animations.\n- Custom Views\n  - [Rainbow](https://github.com/skydoves/rainbow): An easy way to apply gradations and tinting for Android.\n  - [AndroidRibbon](https://github.com/skydoves/androidribbon): A simple way to implement a  beautiful ribbon with the shimmering on Android.\n  - [ProgressView](https://github.com/skydoves/progressview): A polished and flexible ProgressView, fully customizable with animations.\n- [Timber](https://github.com/JakeWharton/timber): A logger with a small, extensible API.\n\n## Architecture\n**Pokedex** is based on the MVVM architecture and the Repository pattern, which follows the [Google's official architecture guidance](https://developer.android.com/topic/architecture).\n\n![architecture](figure/figure0.png)\n\nThe overall architecture of **Pokedex** is composed of two layers; the UI layer and the data layer. Each layer has dedicated components and they have each different responsibilities, as defined below:\n\n**Pokedex** was built with [Guide to app architecture](https://developer.android.com/topic/architecture), so it would be a great sample to show how the architecture works in real-world projects.\n\n\n### Architecture Overview\n\n![architecture](figure/figure1.png)\n\n- Each layer follows [unidirectional event/data flow](https://developer.android.com/topic/architecture/ui-layer#udf); the UI layer emits user events to the data layer, and the data layer exposes data as a stream to other layers.\n- The data layer is designed to work independently from other layers and must be pure, which means it doesn't have any dependencies on the other layers.\n\nWith this loosely coupled architecture, you can increase the reusability of components and scalability of your app.\n\n### UI Layer\n\n![architecture](figure/figure2.png)\n\nThe UI layer consists of UI elements to configure screens that could interact with users and [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel) that holds app states and restores data when configuration changes.\n- UI elements observe the data flow via [DataBinding](https://developer.android.com/topic/libraries/data-binding), which is the most essential part of the MVVM architecture. \n- With [Bindables](https://github.com/skydoves/bindables), which is an Android DataBinding kit for notifying data changes, you can implement two-way binding, and data observation in XML very clean.\n\n### Data Layer\n\n![architecture](figure/figure3.png)\n\nThe data Layer consists of repositories, which include business logic, such as querying data from the local database and requesting remote data from the network. It is implemented as an offline-first source of business logic and follows the [single source of truth](https://en.wikipedia.org/wiki/Single_source_of_truth) principle.\u003cbr\u003e\n\n**Pokedex** is an offline-first app is an app that is able to perform all, or a critical subset of its core functionality without access to the internet. \nSo users don't need to be up-to-date on the network resources every time and it will decrease users' data consumption. For further information, you can check out [Build an offline-first app](https://developer.android.com/topic/architecture/data-layer/offline-first).\n\n## Modularization\n\n![architecture](figure/figure4.png)\n\n**Pokedex** adopted modularization strategies below:\n\n- **Reusability**: Modulizing reusable codes properly enable opportunities for code sharing and limits code accessibility in other modules at the same time.\n- **Parallel Building**: Each module can be run in parallel and it reduces the build time.\n- **Strict visibility control**: Modules restrict to expose dedicated components and access to other layers, so it prevents they're being used outside the module\n- **Decentralized focusing**: Each developer team can assign their dedicated module and they can focus on their own modules.\n\nFor more information, check out the [Guide to Android app modularization](https://developer.android.com/topic/modularization).\n\n## MAD Score\n![summary](https://user-images.githubusercontent.com/24237865/102366914-84f6b000-3ffc-11eb-8d49-b20694239782.png)\n![kotlin](https://user-images.githubusercontent.com/24237865/102366932-8a53fa80-3ffc-11eb-8131-fd6745a6f079.png)\n\n## Open API\n\n\u003cimg src=\"https://user-images.githubusercontent.com/24237865/83422649-d1b1d980-a464-11ea-8c91-a24fdf89cd6b.png\" align=\"right\" width=\"21%\"/\u003e\n\nPokedex using the [PokeAPI](https://pokeapi.co/) for constructing RESTful API.\u003cbr\u003e\nPokeAPI provides a RESTful API interface to highly detailed objects built from thousands of lines of data related to Pokémon.\n\n## Find this repository useful? :heart:\nSupport it by joining __[stargazers](https://github.com/skydoves/Pokedex/stargazers)__ for this repository. :star: \u003cbr\u003e\nAlso, __[follow me](https://github.com/skydoves)__ on GitHub for my next creations! 🤩\n\n# License\n```xml\nDesigned and developed by 2022 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%2Fpokedex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskydoves%2Fpokedex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskydoves%2Fpokedex/lists"}