Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michaelbel/movies
Discover movies app illustrating Kotlin Multiplatform development best practices
https://github.com/michaelbel/movies
android android-app android-application cinema compose films googleplay kotlin material-components material-ui material3 mobile mobile-app movie-collection movie-database movies mvvm tmdb tmdb-api tv
Last synced: 7 days ago
JSON representation
Discover movies app illustrating Kotlin Multiplatform development best practices
- Host: GitHub
- URL: https://github.com/michaelbel/movies
- Owner: michaelbel
- License: apache-2.0
- Created: 2017-12-26T16:27:58.000Z (almost 7 years ago)
- Default Branch: develop
- Last Pushed: 2024-07-23T14:57:42.000Z (4 months ago)
- Last Synced: 2024-07-23T21:23:52.306Z (4 months ago)
- Topics: android, android-app, android-application, cinema, compose, films, googleplay, kotlin, material-components, material-ui, material3, mobile, mobile-app, movie-collection, movie-database, movies, mvvm, tmdb, tmdb-api, tv
- Language: Kotlin
- Homepage: https://play.google.com/store/apps/details?id=org.michaelbel.moviemade
- Size: 289 MB
- Stars: 242
- Watchers: 7
- Forks: 34
- Open Issues: 7
-
Metadata Files:
- Readme: readme.md
- License: license.txt
- Code of conduct: code_of_conduct.md
- Codeowners: .github/codeowners
- Security: security.md
Awesome Lists containing this project
README
[
]()
Movies
=
[](https://github.com/michaelbel/movies)
[](https://github.com/michaelbel/movies)
[](https://github.com/michaelbel/movies)
[](https://github.com/michaelbel/movies/actions/workflows/check_pr.yml)
[](https://github.com/michaelbel/movies/commits)
Movies - easy way to discover popular movies. This is a simple TMDb client.
The goal of this project is to implement an app that provides a consistent user experience on Android Phones, Android Tablets, Android Auto, Android Wear, Android TV, iOS, Desktop (MacOS, Windows, Linux) and Web. Used Material3, Compose, Kotlin and Multiplatform.
The app is currently in development. Android app is already available.
## Screenshots
**Android**
**iOS**
**macOS**
## Requirements
Take a look at `local.properties` and fill it with [your own](https://developers.themoviedb.org/3/getting-started/introduction) TMDB API key like this:
```gradle
TMDB_API_KEY=your_own_tmdb_api_key
```
The app is still usable without an API key. In this case functionality will be limited.
## Build
Choose a run configuration for an appropriate target in Android Studio and run it.
- Clone this repository using [latest version](https://d.android.com/studio) of Android Studio
- Run the app on your Device or Emulator
- For Android, run `androidApp` configuration.
- For iOS, run `iosApp` configuration.
- For Desktop, run `desktopApp` configuration.
- Android Flavors
- Android with Google Mobile Services:
```gradle
./gradlew :androidApp:installGmsDebug
```
- Android with Huawei Mobile Services:
```gradle
./gradlew :androidApp:installHmsDebug
```
- Android Free and Open Source Software:
```gradle
./gradlew :androidApp:installFossDebug
```
- Desktop Run
```gradle
./gradlew :desktopApp:run
```
## Download
[](https://play.google.com/store/apps/details?id=org.michaelbel.moviemade)
[](https://github.com/michaelbel/movies/releases)
[
](https://play.google.com/store/apps/details?id=org.michaelbel.moviemade)
[
](https://appgallery.cloud.huawei.com/ag/n/app/C109677247)
[
](https://github.com/michaelbel/movies/releases/download/2.0.0/Movies-v2.0.0.1699.-gms-release.apk)
[
](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/michaelbel/movies)
## Technologies
[](https://git-scm.com)
[](https://d.android.com/kotlin)
[](https://ktor.io)
[](https://www.jetbrains.com/kotlin-multiplatform)
[](https://d.android.com/jetpack/compose)
[](https://m3.material.io)
[](https://d.android.com/studio/releases/gradle-plugin)
[](https://d.android.com)
[](https://d.android.com/kotlin/multiplatform/room)
[](https://firebase.google.com)
[](https://github.com/coil-kt/coil)
[](https://d.android.com/topic/architecture)
[](https://github.com/dependabot)
[](https://github.com/michaelbel/movies/tree/develop/.github/workflows)
[](https://codebeat.co/projects/github-com-michaelbel-movies-develop)
[](https://developers.themoviedb.org/3/getting-started)
[](https://d.android.com/guide/playcore/in-app-review)
[](https://d.android.com/guide/playcore/in-app-updates)
- [x] [Modularization](https://d.android.com/topic/modularization)
- [x] [MVVM](https://d.android.com/topic/architecture)
- [x] [KTS Gradle Files](https://d.android.com/studio/build/migrate-to-kts)
- [x] [Kotlin Symbol Processing API](https://d.android.com/studio/build/migrate-to-ksp)
- [x] [Gradle Version Catalog](https://d.android.com/build/migrate-to-catalogs)
- [x] [Build Variants](https://d.android.com/build/build-variants)
- [x] [Product Flavors](https://d.android.com/build/build-variants#product-flavors)
- [x] [Using buildSrc Directory](https://docs.gradle.org/current/userguide/organizing_gradle_projects.html#sec:build_sources)
- [x] MinSDK 23
- [x] TargetSDK 34
- [x] CompileSDK 34
- [x] [Dark Theme](https://d.android.com/develop/ui/views/theming/darktheme)
- [x] Amoled Theme
- [x] [Material You Dynamic Colors](https://d.android.com/develop/ui/views/theming/dynamic-colors)
- [x] [Themed App Icon](https://d.android.com/develop/ui/views/launch/icon_design_adaptive)
- [x] [Palette Colors API](https://d.android.com/develop/ui/views/graphics/palette-colors)
- [x] [Accompanist](https://github.com/google/accompanist)
- [x] [Compose PreviewParameterProvider](https://d.android.com/jetpack/compose/tooling#previewparameter)
- [x] [Downloadable Fonts](https://d.android.com/develop/ui/views/text-and-emoji/downloadable-fonts)
- [x] [KotlinX Coroutines](https://github.com/Kotlin/kotlinx.coroutines)
- [x] [KotlinX Serialization](https://github.com/Kotlin/kotlinx.serialization)
- [x] [Appcompat](https://d.android.com/jetpack/androidx/releases/appcompat)
- [x] [ViewModel](https://d.android.com/topic/libraries/architecture/viewmodel)
- [x] [Lifecycle](https://d.android.com/topic/libraries/architecture/lifecycle)
- [x] [WorkManager](https://d.android.com/topic/libraries/architecture/workmanager)
- [x] [DataStore](https://d.android.com/datastore)
- [x] [Startup](https://d.android.com/jetpack/androidx/releases/startup)
- [x] [Navigation](https://d.android.com/guide/navigation)
- [x] [Paging3](https://d.android.com/topic/libraries/architecture/paging/v3-overview)
- [x] [Browser](https://d.android.com/jetpack/androidx/releases/browser)
- [x] [OkHttp](https://github.com/square/okhttp)
- [x] [Chucker](https://github.com/ChuckerTeam/chucker)
- [x] [Flaker](https://github.com/rotbolt/flaker)
- [x] [Timber](https://github.com/JakeWharton/timber)
- [x] [App Shortcuts](https://d.android.com/develop/ui/views/launch/shortcuts)
- [x] [Github Releases](https://github.com/michaelbel/movies/releases)
- [x] [Lint](https://d.android.com/studio/write/lint)
- [x] [Detekt](https://github.com/detekt/detekt)
- [x] [Spotless](https://github.com/diffplug/spotless)
- [x] [Distribute App via Telegram Bot](https://github.com/appleboy/telegram-action)
- [x] [Non-Transitive R classes](https://d.android.com/studio/build/optimize-your-build#use-non-transitive-r-classes)
- [x] [SplashScreen API](https://d.android.com/develop/ui/views/launch/splash-screen)
- [x] [Per-App Language Preferences](https://d.android.com/guide/topics/resources/app-languages)
- [x] [Settings Panel](https://d.android.com/reference/android/provider/Settings.Panel)
- [x] [Benchmark](https://d.android.com/topic/performance/benchmarking/benchmarking-overview)
- [x] [Support Localization](https://d.android.com/guide/topics/resources/localization)
- [x] [Notification Runtime Permission](https://d.android.com/develop/ui/views/notifications/notification-permission)
- [x] [Changing Launcher App Icon](https://d.android.com/guide/topics/manifest/activity-alias-element)
- [x] [Predictive Back Gesture](https://d.android.com/guide/navigation/custom-back/predictive-back-gesture)
- [x] [Codacy Static Code Analysis](https://app.codacy.com/gh/michaelbel/movies/dashboard)
- [x] [Display Content Edge-to-Edge](https://d.android.com/develop/ui/views/layout/edge-to-edge)
- [x] [Support Landscape Orientation](https://d.android.com/guide/topics/large-screens/support-different-screen-sizes)
- [x] [Support Display Cutouts](https://d.android.com/jetpack/compose/system/cutouts)
- [x] [Voice Input](https://d.android.com/training/wearables/user-input/voice)
- [x] [User Interactions](https://d.android.com/jetpack/compose/text/user-interactions)
- [x] [Glance AppWidget](https://d.android.com/jetpack/compose/glance)
- [x] [Tile Quick Settings](https://d.android.com/develop/ui/views/quicksettings-tiles)
- [x] [Grammatical Gender](https://d.android.com/about/versions/14/features/grammatical-inflection)
- [x] [Biometric Authentication Dialog](https://d.android.com/training/sign-in/biometric-auth)
- [x] [LeakCanary](https://github.com/square/leakcanary)
- [x] [ConstraintLayout Multiplatform](https://github.com/Lavmee/constraintlayout-compose-multiplatform)
- [x] [Koin](https://github.com/InsertKoinIO/koin)
- [x] [Screenshot Detection](https://d.android.com/about/versions/14/features/screenshot-detection)
- [x] [BuildKonfig](https://github.com/yshrsmz/BuildKonfig)
- [x] [ConstraintLayout](https://d.android.com/develop/ui/views/layout/constraint-layout) removed in [44723cb](https://github.com/michaelbel/movies/commit/44723cbbafdad89bef6043f99cbd0fbab1ecf19a)
- [x] [Dagger Hilt](https://github.com/google/dagger) removed in [#274](https://github.com/michaelbel/movies/pull/274)
- [x] [Retrofit](https://github.com/square/retrofit) removed in [#275](https://github.com/michaelbel/movies/pull/275)
## Modules
```mermaid
graph TD;
main-impl-->androidApp
main-impl-->iosComposeApp
main-impl-->desktopApp
account-->main-impl
auth-->main-impl
details-->main-impl
feed-->main-impl
gallery-->main-impl
search-->main-impl
settings-->main-impl
debug-->main-impl
account-impl-->account
auth-impl-->auth
details-impl-->details
feed-impl-->feed
gallery-impl-->gallery
search-impl-->search
settings-impl-->settings
debug-impl-->debug
core-->account-impl
core-->auth-impl
core-->details-impl
core-->feed-impl
core-->gallery-impl
core-->search-impl
core-->settings-impl
core-->debug-impl
navigation-->core
ui-->core
common-->core
interactor-->core
notifications-->core
work-->core
widget-->core
platform-services-->core
analytics-->interactor
repository-->interactor
network-->repository
persistence-->repository
```
## Roadmap
[Movies App Roadmap](https://github.com/users/michaelbel/projects/1/views/1)
## Contributing
[](https://github.com/michaelbel/movies/pulls)
All contributions are welcome!
⭐ Join [stargazers](https://github.com/michaelbel/movies/stargazers)
↗️ Submit your PR
## Issues
[](https://github.com/michaelbel/movies/issues)
If you find any problems or would like to suggest a feature, please feel free to file an [issue](https://github.com/michaelbel/movies/issues).
## Contacts
[](https://t.me/michaelbel)
[](https://linkedin.com/in/michael-bel)
[](mailto:[email protected])
[](https://instagram.com/michael_bel)
[](https://x.com/michael_bely)
[](https://www.youtube.com/@michaelbely)
## Star History
## License
[](license.txt)
Copyright 2017 Michael Bely
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.