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.

Android

iOS

macOS

Take a look at local.properties and fill it with your own TMDB API key like this:

TMDB_API_KEY=your_own_tmdb_api_key

The app is still usable without an API key. In this case functionality will be limited.

Choose a run configuration for an appropriate target in Android Studio and run it.

• Clone this repository using latest version 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:

    ./gradlew :androidApp:installGmsDebug

  • Android with Huawei Mobile Services:

    ./gradlew :androidApp:installHmsDebug

  • Android Free and Open Source Software:

    ./gradlew :androidApp:installFossDebug

• Desktop Run

    ./gradlew :desktopApp:run

• Modularization
• MVVM
• KTS Gradle Files
• KSP
• Version Catalog
• Build Variants
• Product Flavors
• Using buildSrc Directory
• MinSDK 26
• TargetSDK 37
• CompileSDK 37
• Dark Theme
• SecureTextField
• Font Scale Cap (max 1.15)
• SwipeToDismiss
• Tooltips
• DropdownMenu
• Infinite Pager
• Material You Dynamic Colors
• Material3 Expressive
• Themed App Icon
• EyeDropper
• Compose PreviewParameterProvider
• Downloadable Fonts
• KotlinX Coroutines
• KotlinX Serialization
• Appcompat
• ViewModel
• Lifecycle
• WorkManager
• DataStore
• Startup
• Navigation3
• Paging3
• Browser
• OkHttp
• Chucker
• Timber
• App Shortcuts
• Github Releases
• Lint
• Detekt
• Distribute App via Telegram Bot
• Non-Transitive R classes
• SplashScreen API
• Per-App Language Preferences
• Settings Panel
• Benchmark
• Support Localization
• Open Supported Links
• Notification Runtime Permission
• Do Not Disturb Access
• Changing Launcher App Icon
• Predictive Back Gesture
• Codacy Static Code Analysis
• Edge-to-Edge
• Support Landscape Orientation
• Support Display Cutouts
• Voice Input
• User Interactions
• Glance AppWidget
• Tile Quick Settings
• Grammatical Gender
• Biometric Authentication Dialog
• LeakCanary
• Koin
• Screenshot Detection
• Battery Optimization Request
• BuildKonfig

All contributions are welcome!

⭐ Join stargazers
↗️ Submit your PR

If you find any problems or would like to suggest a feature, please feel free to file an issue.

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.