{"id":13614158,"url":"https://github.com/reactivedroid/TvFlix","last_synced_at":"2025-04-13T18:32:21.806Z","repository":{"id":42572178,"uuid":"98877626","full_name":"reactivedroid/TvFlix","owner":"reactivedroid","description":"TvFlix android app using Dagger Hilt, Coroutines, Flow, KTX, Jetpack(Room, ViewModel, Paging3, Lifecycle) based on MVVM with clean code architecture purely written in Kotlin","archived":false,"fork":false,"pushed_at":"2023-03-30T14:10:46.000Z","size":494,"stargazers_count":411,"open_issues_count":0,"forks_count":57,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-11-07T22:42:11.201Z","etag":null,"topics":["android-architecture-components","checkstyle","clean-architecture","clean-code","codeanalysis","coroutines","databinding","espresso-tests","hilt-android","jetpack-lifecycle-components","jetpack-pagination","jetpack-room","kotlin","kotlin-coroutines","kotlin-dsl","mockito","mvvm-architechure","pmd","retrofit2","unit-testing"],"latest_commit_sha":null,"homepage":"https://reactivedroid.github.io/TvFlix/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reactivedroid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-07-31T10:35:26.000Z","updated_at":"2024-09-13T23:25:54.000Z","dependencies_parsed_at":"2024-01-15T03:57:57.010Z","dependency_job_id":"4eaf8e33-7be9-49b6-a701-5d2ab224e475","html_url":"https://github.com/reactivedroid/TvFlix","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactivedroid%2FTvFlix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactivedroid%2FTvFlix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactivedroid%2FTvFlix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactivedroid%2FTvFlix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reactivedroid","download_url":"https://codeload.github.com/reactivedroid/TvFlix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248760508,"owners_count":21157374,"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-architecture-components","checkstyle","clean-architecture","clean-code","codeanalysis","coroutines","databinding","espresso-tests","hilt-android","jetpack-lifecycle-components","jetpack-pagination","jetpack-room","kotlin","kotlin-coroutines","kotlin-dsl","mockito","mvvm-architechure","pmd","retrofit2","unit-testing"],"created_at":"2024-08-01T20:00:57.753Z","updated_at":"2025-04-13T18:32:21.033Z","avatar_url":"https://github.com/reactivedroid.png","language":"Kotlin","readme":"![Android CI](https://github.com/ashwini009/TvFlix/workflows/Android%20CI/badge.svg?branch=master\u0026event=push) ![GitHub top language](https://img.shields.io/github/languages/top/ashwini009/TvFlix?style=plastic) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![API](https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=21) ![GitHub stars](https://img.shields.io/github/stars/ashwini009/TvFlix?style=social) ![GitHub forks](https://img.shields.io/github/forks/ashwini009/TvFlix?style=social)\n\n\n# TvFlix :tv: \n\nThe aim of this app is to replicate the high level functionality of www.tvmaze.com and showcase an android app out of it. \nIt connects with [TVDB API](https://api.thetvdb.com) to give you popular shows and let you mark anyone as favorite.\nTvFlix consists of 3 pieces of UI right now:\n1. Home with Popular Shows\n2. Favorites\n3. All Shows\n\nThis app is under development. :construction_worker: :hammer_and_wrench:\n\n*Note: TvFlix is an unofficial app built only for learning and sharing the latest concepts with #AndroidDevs*\n\n## Android Development and Architecture\n\n* The entire codebase is in [Kotlin](https://kotlinlang.org/)\n* Uses Kotlin [Coroutines](https://kotlinlang.org/docs/reference/coroutines/coroutines-guide.html).\n* Uses MVVM Architecture by [Architecture Components](https://developer.android.com/topic/libraries/architecture/). Room, ViewModel, Paging\n* Uses [Hilt Android](https://developer.android.com/training/dependency-injection/hilt-android) with [Dagger](https://dagger.dev/) for dependency injection\n* Unit Testing by [Mockito](https://github.com/mockito/mockito)\n* Tests Coroutines and architecture components like ViewModel\n* UI Test by [Espresso](https://developer.android.com/training/testing/espresso) based on [Robot Pattern](https://academy.realm.io/posts/kau-jake-wharton-testing-robots/)\n* Uses [Kotlin Coroutines Test](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-test/) to unit test Kotlin Coroutines\n* Uses [StateFlow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-state-flow/) as a replacement over LiveData as a state-holder observable\n* Uses [Firebase Remote Config](https://firebase.google.com/products/remote-config) for experimentation and feature rollout\n* Uses [Firebase App Distribution](https://firebase.google.com/products/app-distribution) for internal distribution and quality testing\n\n## Further Reading\n\nThere are several articles written on this repository which state the design and architecture. \n\n### Kotlin Everywhere. Coroutines, Tests, Robots and much more…\n\nThe TvFlix complete repository has been re-written in Kotlin with Coroutines covering\nUnit Tests across ViewModels and UI tests for the app.\nKnow more:\n[Kotlin Everywhere. Coroutines, Tests, Robots and much more…](https://proandroiddev.com/kotlin-everywhere-coroutines-tests-robots-and-much-more-b02030206cc9)\n\n### MVVM using Android Architecture Components\n\nThe codebase tries to follow Uncle Bob Clean Code Architecture with [SOLID principles](https://en.wikipedia.org/wiki/SOLID).\nKnow more:\n[Migration from MVP to MVVM using Android Architecture Components](https://medium.com/@kumarashwini/migration-from-mvp-to-mvvm-using-android-architecture-components-4bc058a1f73c)\n\n### Pagination using Paging Library \n\nThe Shows screen displays the list of shows fetched from TvMaze API using [Paging3](https://developer.android.com/topic/libraries/architecture/paging/v3-overview) of Android Architecture Components. It also handles the retry if any network error occurred. Recently the repository has been [migrated to use Paging3](https://github.com/reactivedroid/TvFlix/pull/14).  \nPaging3 is in heavy development, and if you want to catch up with stable library(Paging 2), then check out this blog\n[Pagination using Paging Library with RxJava and Dagger](https://medium.com/@kumarashwini/pagination-using-paging-library-with-rxjava-and-dagger-d9d05dbd8eac)\n\n### Room Persistence Library\n\nThe Favourites screen displays the list of shows marked favourites from the Home screen. The user can add/remove from \nthe favorites as and when required. The implementation of the favorites is done using `Room`  Persistence Library with RxJava and Dagger. \nKnow more:\n[Room with RxJava and Dagger](https://medium.com/@kumarashwini/room-with-rxjava-and-dagger-2722f4420651)\n\n### Static Code Analysis\n\nTvFlix has Static Code Analysis tools like FindBugs, PMD and Checkstyle integrated. These tools help in finding potential bugs that would have been missed and help in making the codebase clean.\nKnow more:\n[Static Code Analysis for Android Using FindBugs, PMD and CheckStyle](https://blog.mindorks.com/static-code-analysis-for-android-using-findbugs-pmd-and-checkstyle-3a2861834c6a)\n\n## Contributions\n\nIf you have found an issue in this sample, please file it.\nBetter yet, if you want to contribute to the repository, go ahead, any kind of patches are encouraged,\nand may be submitted by forking this project and submitting a pull request. \nIf you have something big in mind, or any architectural change, please raise an issue first to discuss it.\n\n## License\n\n```\nCopyright (c) 2020 Ashwini Kumar\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","funding_links":[],"categories":[":shamrock:  **Categories**",":art: Pattern"],"sub_categories":[":movie_camera: Entertainment","MVVM"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freactivedroid%2FTvFlix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freactivedroid%2FTvFlix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freactivedroid%2FTvFlix/lists"}