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: 3 months 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 (over 8 years ago)
- Default Branch: develop
- Last Pushed: 2025-04-10T10:40:59.000Z (about 1 year ago)
- Last Synced: 2025-04-12T12:54:16.400Z (about 1 year 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: 291 MB
- Stars: 300
- Watchers: 5
- Forks: 39
- Open Issues: 10
-
Metadata Files:
- Readme: readme.md
- Funding: .github/funding.yml
- 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)
[](https://github.com/michaelbel/movies)
[](https://github.com/michaelbel/movies/actions)
[](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.
Get interactive AI-powered documentation for the repository on [DeepWiki](https://deepwiki.com/michaelbel/movies).
## Screenshots
**Android**
**iOS**
**macOS**
**Windows**
## 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://nightly.link/michaelbel/movies/workflows/ci/develop/artifact.zip)
[
](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/michaelbel/movies)
[
](https://www.openapk.net/movies/org.michaelbel.movies/)
[
](https://www.androidfreeware.net/download-movies-apk.html)
## Technologies
[](https://git-scm.com)
[](https://d.android.com/kotlin)
[](https://www.jetbrains.com/kotlin-multiplatform)
[](https://ktor.io)
[](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] [KSP](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 26
- [x] TargetSDK 36
- [x] CompileSDK 36
- [x] [Dark Theme](https://d.android.com/develop/ui/views/theming/darktheme)
- [x] Amoled Theme
- [x] SecureTextField
- [x] [SwipeToDismiss](https://d.android.com/develop/ui/compose/touch-input/user-interactions/swipe-to-dismiss)
- [x] [Material You Dynamic Colors](https://d.android.com/develop/ui/views/theming/dynamic-colors)
- [x] [Material3 Expressive](https://m3.material.io/blog/building-with-m3-expressive)
- [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] [Navigation3](https://d.android.com/guide/navigation/navigation-3)
- [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] [Koin](https://github.com/InsertKoinIO/koin)
- [x] [Screenshot Detection](https://d.android.com/about/versions/14/features/screenshot-detection)
- [x] [Battery Optimization Request](https://d.android.com/training/monitoring-device-state/doze-standby.html)
- [x] [BuildKonfig](https://github.com/yshrsmz/BuildKonfig)
## Modules
```mermaid
graph TD;
main-->androidApp
main-->iosAppCompose
main-->desktopApp
main-->webApp
account-->main
auth-->main
details-->main
feed-->main
gallery-->main
notify-->main
settings-->main
debug-->main
feed-web-->main
core-->account
core-->auth
core-->details
core-->feed
core-->gallery
core-->notify
core-->settings
core-->debug
core-->feed-web
ui-->core
ui-web-->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:michaelvel24865@gmail.com)
[](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.