{"id":13611604,"url":"https://github.com/skydoves/pokedex-compose","last_synced_at":"2025-05-15T05:06:35.951Z","repository":{"id":233138847,"uuid":"786132659","full_name":"skydoves/pokedex-compose","owner":"skydoves","description":"🗡️ Pokedex Compose demonstrates modern Android development with Jetpack Compose, Hilt, Coroutines, Flow, Jetpack (Room, ViewModel), and Material Design based on MVVM architecture.","archived":false,"fork":false,"pushed_at":"2025-04-08T02:07:17.000Z","size":24846,"stargazers_count":879,"open_issues_count":3,"forks_count":143,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-14T08:09:37.077Z","etag":null,"topics":["android","coroutines","hilt","jetpack-android","jetpack-compose","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":"2024-04-13T14:32:42.000Z","updated_at":"2025-04-13T07:19:39.000Z","dependencies_parsed_at":"2024-04-14T04:32:34.010Z","dependency_job_id":"9604e832-309e-4787-858c-aac103fcdb58","html_url":"https://github.com/skydoves/pokedex-compose","commit_stats":{"total_commits":36,"total_committers":10,"mean_commits":3.6,"dds":0.5,"last_synced_commit":"ee2148f0c52a3611fcbdc86849c1d39fdb0c099e"},"previous_names":["skydoves/pokedex-compose"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2Fpokedex-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2Fpokedex-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2Fpokedex-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skydoves%2Fpokedex-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skydoves","download_url":"https://codeload.github.com/skydoves/pokedex-compose/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254276447,"owners_count":22043867,"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","jetpack-compose","kotlin","motion","mvvm","mvvm-architecture","pokedex","pokemon","skydoves"],"created_at":"2024-08-01T19:01:58.691Z","updated_at":"2025-05-15T05:06:30.932Z","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":["Kotlin"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ePokedex Compose\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-compose/actions\"\u003e\u003cimg alt=\"Build Status\" src=\"https://github.com/skydoves/pokedex-compose/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/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 Compose demonstrates modern Android development with Jetpack Compose, 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 XML version of Pokedex, check out the [Pokedex](https://github.com/skydoves/pokedex) 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-compose/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, utilizing [Coroutines](https://github.com/Kotlin/kotlinx.coroutines) + [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/) for asynchronous operations.\n- Jetpack Libraries:\n  - Jetpack Compose: Android’s modern toolkit for declarative UI development.\n  - Lifecycle: Observes Android lifecycles and manages UI states upon lifecycle changes.\n  - ViewModel: Manages UI-related data and is lifecycle-aware, ensuring data survival through configuration changes.\n  - Navigation: Facilitates screen navigation, complemented by [Hilt Navigation Compose](https://developer.android.com/jetpack/compose/libraries#hilt) for dependency injection.\n  - Room: Constructs a database with an SQLite abstraction layer for seamless database access.\n  - [Hilt](https://dagger.dev/hilt/): Facilitates dependency injection.\n- Architecture:\n  - MVVM Architecture (View - ViewModel - Model): Facilitates separation of concerns and promotes maintainability.\n  - Repository Pattern: Acts as a mediator between different data sources and the application's business logic.\n- [Retrofit2 \u0026 OkHttp3](https://github.com/square/retrofit): Constructs REST APIs and facilitates paging network data retrieval.\n- [Sandwich](https://github.com/skydoves/Sandwich): Adaptable and lightweight sealed API library designed for handling API responses and exceptions in Kotlin for Retrofit, Ktor, and Kotlin Multiplatform.\n- [Kotlin Serialization](https://github.com/Kotlin/kotlinx.serialization): Kotlin multiplatform / multi-format reflectionless serialization.\n- [ksp](https://github.com/google/ksp): Kotlin Symbol Processing API for code generation and analysis.\n- [Turbine](https://github.com/cashapp/turbine): A small testing library for kotlinx.coroutines Flow.\n- [Landscapist Glide](https://github.com/skydoves/landscapist#glide), [animation](https://github.com/skydoves/landscapist#animation), [placeholder](https://github.com/skydoves/landscapist#placeholder): A pluggable, highly optimized Jetpack Compose and Kotlin Multiplatform image loading library that fetches and displays network images with Glide, Coil, and Fresco.\n- [Baseline Profiles](https://medium.com/proandroiddev/improve-your-android-app-performance-with-baseline-profiles-297f388082e6): Enhances app performance by including specifications of classes and methods in the APK that can be utilized by Android Runtime.\n\n## Technical Contents\n\nIf you're interested in learning the tech stacks used to build Pokedex Compose, you can find detailed information in the articles linked below:\n\n- [Shared Element Transition In Jetpack Compose: Provide Enriched User Experiences](https://medium.com/@skydoves/shared-element-transition-in-jetpack-compose-provide-enriched-user-experiences-163d4e435869)\n\n\n## Architecture\n**Pokedex Compose** adheres to the MVVM architecture and implements the Repository pattern, aligning with [Google's official architecture guidance](https://developer.android.com/topic/architecture).\n\n![architecture](figure/figure0.png)\n\nThe architecture of **Pokedex Compose** is structured into two distinct layers: the UI layer and the data layer. Each layer fulfills specific roles and responsibilities, outlined as follows:\n\n**Pokedex Compose** follows the principles outlined in the [Guide to app architecture](https://developer.android.com/topic/architecture), making it an exemplary demonstration of architectural concepts in practical application.\n\n### Architecture Overview\n\n![architecture](figure/figure1.png)\n\n- Each layer adheres to the principles of [unidirectional event/data flow](https://developer.android.com/topic/architecture/ui-layer#udf): the UI layer sends user events to the data layer, and the data layer provides data streams to other layers.\n- The data layer operates autonomously from other layers, maintaining purity without dependencies on external layers.\n\nThis loosely coupled architecture enhances component reusability and app scalability, facilitating seamless development and maintenance.\n\n### UI Layer\n\n![architecture](figure/figure2.png)\n\nThe UI layer encompasses UI elements responsible for configuring screens for user interaction, alongside the [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel), which manages app states and restores data during configuration changes.\n- UI elements observe the data flow, ensuring synchronization with the underlying data layer.\n\n### Data Layer\n\n![architecture](figure/figure3.png)\n\nThe data layer is composed of repositories that handle business logic tasks such as retrieving data from a local database or fetching remote data from a network. This layer is designed to prioritize offline access, functioning primarily as an offline-first repository of business logic. It adheres to the principle of \"single source of truth,\" ensuring that all data operations are centralized and consistent.\u003cbr\u003e\n\n**Pokedex Compose** is an offline-first app, meaning it can perform all or most of its essential functions without an internet connection. This design allows users to access core features reliably, regardless of network availability, reducing their need for constant updates and decreasing data usage. For more details on how to build an offline-first application, you can visit [Build an offline-first app](https://developer.android.com/topic/architecture/data-layer/offline-first).\n\n## Modularization\n\n**Pokedex Compose** 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## 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-compose/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 2024 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-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskydoves%2Fpokedex-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskydoves%2Fpokedex-compose/lists"}