en ru

Movies

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 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.

Build

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

Download

Technologies

• Modularization
• MVVM
• KTS Gradle Files
• Kotlin Symbol Processing API
• Gradle Version Catalog
• Build Variants
• Product Flavors
• Using buildSrc Directory
• MinSDK 23
• TargetSDK 34
• CompileSDK 34
• Dark Theme
• Amoled Theme
• SwipeToDismiss
• Material You Dynamic Colors
• Themed App Icon
• Palette Colors API
• Accompanist
• Compose PreviewParameterProvider
• Downloadable Fonts
• KotlinX Coroutines
• KotlinX Serialization
• Appcompat
• ViewModel
• Lifecycle
• WorkManager
• DataStore
• Startup
• Navigation
• Paging3
• Browser
• OkHttp
• Chucker
• Flaker
• Timber
• App Shortcuts
• Github Releases
• Lint
• Detekt
• Spotless
• Distribute App via Telegram Bot
• Non-Transitive R classes
• SplashScreen API
• Per-App Language Preferences
• Settings Panel
• Benchmark
• Support Localization
• Notification Runtime Permission
• Changing Launcher App Icon
• Predictive Back Gesture
• Codacy Static Code Analysis
• Display Content Edge-to-Edge
• Support Landscape Orientation
• Support Display Cutouts
• Voice Input
• User Interactions
• Glance AppWidget
• Tile Quick Settings
• Grammatical Gender
• Biometric Authentication Dialog
• Type safety Navigation
• LeakCanary
• Koin
• Screenshot Detection
• BuildKonfig
• Dagger Hilt removed in #274
• Retrofit removed in #275

Modules

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

Loading

Roadmap

Movies App Roadmap

Contributing

All contributions are welcome!

⭐ Join stargazers
↗️ Submit your PR

Issues

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

Contacts

Star History

License

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.