Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thecodemonks/topcorn2

A minimalistic movie listing app to browse IMDB's top 250 movies, built to demonstrate MVVM with Jetpack Compose.
https://github.com/thecodemonks/topcorn2

android-mvvm jetpack-compose jetpack-navigation retrofit2-kotlin

Last synced: 2 months ago
JSON representation

A minimalistic movie listing app to browse IMDB's top 250 movies, built to demonstrate MVVM with Jetpack Compose.

Awesome Lists containing this project

README 

        
![GitHub Cards Preview](https://github.com/TheCodeMonks/topcorn2/blob/master/extras/topcorn2_coverart.jpg?raw=true)



# TopCorn 2 🍿



A minimalistic movie listing app to browse IMDB's top 250 movies,

built to *demonstrate MVVM with Jetpack Compose*.



[![GitHub issues](https://img.shields.io/github/issues/TheCodeMonks/topcorn2)](https://github.com/TheCodeMonks/topcorn2/issues)

[![GitHub forks](https://img.shields.io/github/forks/TheCodeMonks/topcorn2)](https://github.com/TheCodeMonks/topcorn2/network)

[![GitHub stars](https://img.shields.io/github/stars/TheCodeMonks/topcorn2)](https://github.com/TheCodeMonks/topcorn2/stargazers)

[![GitHub license](https://img.shields.io/github/license/TheCodeMonks/topcorn2)](https://github.com/TheCodeMonks/topcorn2/blob/master/LICENSE)

[![Twitter](https://img.shields.io/twitter/url?style=social)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2FTheCodeMonks%2Ftopcorn2)



***Try latest TopCorn2 app apk from below 👇***



[![TopCorn2](https://img.shields.io/badge/TopCorn2🍿-APK-black.svg?style=for-the-badge&logo=android)](https://github.com/TheCodeMonks/topcorn2/releases/latest/download/app-debug.apk)







## Designs - Dark Mode Available 🌙 

![dark_screenshots](extras/screenshot_light.png)

![dark_screenshots](extras/screenshot_dark.png)







## Built With 🛠



- [Kotlin](https://kotlinlang.org/) - First class and official programming language for Android development.

- [Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) - For asynchronous and more..

- [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/) - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.

- [Compose](https://developer.android.com/jetpack/compose) - Android’s modern toolkit for building native UI.

- [Navigation](https://developer.android.com/guide/navigation) - A set of libraries, a plugin, and tooling that simplifies Android navigation.

- [Android Architecture Components](https://developer.android.com/topic/libraries/architecture) - Collection of libraries that help you design robust, testable, and maintainable apps.

  - [LiveData](https://developer.android.com/topic/libraries/architecture/livedata) - Data objects that notify views when the underlying database changes.

  - [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel) - Stores UI-related data that isn't destroyed on UI changes.

  - [Room](https://developer.android.com/topic/libraries/architecture/room) - SQLite object mapping library.

- [Hilt](https://dagger.dev/hilt/) - Dependency Injection Framework

- [Retrofit](https://square.github.io/retrofit/) - A type-safe HTTP client for Android and Java.

- [Moshi](https://github.com/square/moshi) - A modern JSON library for Kotlin and Java.

- [Moshi Converter](https://github.com/square/retrofit/tree/master/retrofit-converters/moshi) - A Converter which uses Moshi for serialization to and from JSON.

- [Coil](https://github.com/chrisbanes/accompanist/blob/main/coil/README.md) - An image loading library for Android.

- [Material Components for Android](https://github.com/material-components/material-components-android) - Modular and customizable Material Design UI components for Android.







## Architecture 🗼



This project follows the famous MVVM architecture and best practices from Google's [GithubBrowserSample](https://github.com/android/architecture-components-samples/tree/master/GithubBrowserSample)



![](extras/arch.jpg)







## Project Structure 📂



```

├── App.kt

├── data

│   ├── local

│   │   ├── AppDatabase.kt

│   │   ├── Converters.kt

│   │   └── daos

│   │       └── MoviesDao.kt

│   ├── remote

│   │   ├── ApiInterface.kt

│   │   └── Movie.kt

│   └── repo

│       └── MoviesRepo.kt

├── di

│   └── modules

│       ├── DatabaseModule.kt

│       ├── NetworkModule.kt

│       └── PreferenceModule.kt

├── model

│   └── Category.kt

├── ui

│   ├── common

│   │   ├── Fakes.kt

│   │   ├── Poster.kt

│   │   └── RetryMessage.kt

│   ├── main

│   │   ├── MainActivity.kt

│   │   └── MainViewModel.kt

│   ├── screen

│   │   ├── detail

│   │   │   ├── MovieDetailFragment.kt

│   │   │   ├── MovieDetailScreen.kt

│   │   │   └── MovieDetailViewModel.kt

│   │   ├── movies

│   │   │   ├── MoviesFragment.kt

│   │   │   ├── MoviesScreen.kt

│   │   │   └── MoviesViewModel.kt

│   │   └── splash

│   │       ├── SplashFragment.kt

│   │       ├── SplashScreen.kt

│   │       └── SplashViewModel.kt

│   ├── test

│   │   ├── TestActivity.kt

│   │   └── TestViewModel.kt

│   └── theme

│       ├── Theme.kt

│       └── Typography.kt

└── utils

    ├── calladapter

    │   └── flow

    │       ├── FlowResourceCallAdapterFactory.kt

    │       ├── FlowResourceCallAdapter.kt

    │       └── Resource.kt

    ├── flow

    │   └── EventFlow.kt

    └── NetworkBoundResource.kt



21 directories, 34 files

```





## Ohh you hate Compose? NP 🤷



Well, we've XML version here, The [TopCorn 1](https://github.com/theapache64/topcorn)



## Credits 🤗



- 🤓 Icons are from [flaticon.com](https://www.flaticon.com/) 

- 🖌️ Design inspired from [AnimeXStream](https://github.com/mukul500/AnimeXStream) 

- 💽 Data from [top250 API](https://github.com/theapache64/top250)

- 📄 Thanks [Foodium](https://github.com/patilshreyas/Foodium)







## TODO 🗒️



  - [ ] Improve algorithms and code review

  - [ ] Add test cases