{"id":13407033,"url":"https://github.com/piashcse/kmp-movie","last_synced_at":"2025-12-25T18:57:32.758Z","repository":{"id":104352939,"uuid":"509820279","full_name":"piashcse/kmp-movie","owner":"piashcse","description":"KMP Movie 📱 app for Android, iOS and desktop built with Compose Multiplatform (KMP, CMP) and MVVM Architecture recommended by Google.","archived":false,"fork":false,"pushed_at":"2024-07-24T16:36:07.000Z","size":33708,"stargazers_count":166,"open_issues_count":0,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-04T23:06:23.096Z","etag":null,"topics":["android","bottom-navigation","clean-architecture","compose","compose-multiplatform","coroutines","decompose","desktop","flow","ios","kmm","kmp","kotlin","kotlin-serialization","ktor","moviedbapi","mvvm","navigation","precompose","viewmodel"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piashcse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-02T17:30:54.000Z","updated_at":"2024-08-06T22:04:42.201Z","dependencies_parsed_at":null,"dependency_job_id":"f040985d-3d91-45ab-bf6f-b2ca8c10bc59","html_url":"https://github.com/piashcse/kmp-movie","commit_stats":null,"previous_names":["piashcse/kmp-movie","piashcse/kmm-movie"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piashcse%2Fkmp-movie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piashcse%2Fkmp-movie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piashcse%2Fkmp-movie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piashcse%2Fkmp-movie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piashcse","download_url":"https://codeload.github.com/piashcse/kmp-movie/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243569281,"owners_count":20312385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","bottom-navigation","clean-architecture","compose","compose-multiplatform","coroutines","decompose","desktop","flow","ios","kmm","kmp","kotlin","kotlin-serialization","ktor","moviedbapi","mvvm","navigation","precompose","viewmodel"],"created_at":"2024-07-30T20:00:18.183Z","updated_at":"2025-12-25T18:57:32.751Z","avatar_url":"https://github.com/piashcse.png","language":"Kotlin","funding_links":[],"categories":["App Projects"],"sub_categories":[],"readme":"# KMP Movie (Compose Multiplatform)\n\n[![Compose Multiplatform](https://img.shields.io/badge/Compose%20Multiplatform-v1.9.3-green)](https://developer.android.com/jetpack/compose)\n[![Kotlin](https://img.shields.io/badge/Kotlin-2.3.0-blue.svg?style=flat\u0026logo=kotlin)](https://kotlinlang.org)\n[![ktorCleint](https://img.shields.io/badge/ktor_client-3.3.3-pink)](https://ktor.io/docs/welcome.html)\n![badge-Android](https://img.shields.io/badge/Platform-Android-brightgreen)\n![badge-iOS](https://img.shields.io/badge/Platform-iOS-lightgray)\n![badge-desktop](http://img.shields.io/badge/Platform-Desktop-4D76CD.svg?style=flat)\n![badge-web](https://img.shields.io/badge/Platform-Web-blueviolet.svg?style=flat)\n[![GitHub license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](https://www.apache.org/licenses/LICENSE-2.0)\n\u003ca href=\"https://github.com/piashcse\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/static/v1?label=GitHub\u0026message=piashcse\u0026color=C51162\"/\u003e\u003c/a\u003e\n\nKMP Movie app built with Compose Multiplatform, supporting Android, iOS, Desktop, and Web. The app\nfollows the MVVM architecture to ensure clean, maintainable code and delivers a responsive, modern\nUI experience across all platforms, leveraging [The Movie DB API](https://www.themoviedb.org). \u003c/br\u003e\n\n# Platform\n\n- iOS\n- Android\n- Desktop\n- Web\n\n\u003cp float=\"center\"\u003e\n  \u003cimg width=\"100%\" height=\"50%\" src=\"https://github.com/piashcse/kmm-movie/blob/master/screenshots/Screenshot 2024-11-06-movie.png\"/\u003e \u003c/br\u003e\u003c/br\u003e\n  \u003cimg width=\"100%\" height=\"50%\" src=\"https://github.com/piashcse/kmm-movie/blob/master/screenshots/Screenshot 2024-11-06-detail.png\" /\u003e\u003c/br\u003e\u003c/br\u003e\n  \u003cimg width=\"100%\" height=\"50%\" src=\"https://github.com/piashcse/kmm-movie/blob/master/screenshots/Screen Recording 2024-11-06.gif\" /\u003e\n\u003c/p\u003e\n\n# Main Features\n\n### Movies\n- 🎞 Now Playing, Popular, Top Rated \u0026 Upcoming movie sections\n- 🔍 Movie Detail Pages with Cast \u0026 Crew\n- 🎯 Recommended Movies\n- 🔍 Search Movies\n- 👤 Artist/Actor Detail Page with navigation from movie cast\n\n### TV Series\n- 📺 Airing Today, On The Air, Popular \u0026 Upcoming TV series sections\n- 🔍 TV Series Detail Pages with Cast \u0026 Crew\n- 🎯 Recommended TV Series\n- 🔍 Search TV Series\n- 👤 Artist/Actor Detail Page with navigation from TV series cast\n\n### Celebrity\n- 🌟 Popular and Trending Celebrities/Persons sections\n- 🔍 Celebrity Search functionality\n- 👤 Celebrity Detail Page with navigation from movie/tv cast\n### Common Features\n- 🧭 **Bottom Navigation**\n- 🚦 **Navigation Rail**\n- 📄 **Pagination** supports for all platforms \n\n## Architecture\n\n- **MVVM Architecture (Model - ComposableView - ViewModel)**\n\n\u003cp float=\"left\"\u003e\n  \u003cimg width=\"100%\" height=\"60%\" src=\"https://github.com/piashcse/kmm-movie/blob/master/screenshots/mvvm_architecture.png\" /\u003e\n\u003c/p\u003e\n\n## API Key 🔑\n\nYou will need to provide a developer key to fetch the data from TMDB API.\n\n* Generate a new key (v3 auth) from [here](https://www.themoviedb.org/settings/api). Copy the key\n  and go back to the project.\n* Add a new entry in `local.properties` file:\n\n```kotlin\nAPI_KEY=superSecretSampleApiKeyOf32Chars\n```\n#### ⚠️ If you haven’t generated an API key yet, feel free to use the demo key below for development use only.\n\n```kotlin\nAPI_KEY=59cd6896d8432f9c69aed9b86b9c2931\n```\n\n## Built With 🛠\n\n- [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) - Compose\n  Multiplatform, a modern UI framework for Kotlin that makes building performant and beautiful user\n  interfaces.\n- [Navigation 3](https://developer.android.com/guide/navigation/navigation-3) - Compose Multiplatform Navigation backed by JetBrains\n- [Ktor Client](https://ktor.io/docs/welcome.html) - Ktor includes a multiplatform asynchronous HTTP\n  client, which allows you to make requests and handle responses.\n- [Koin](https://insert-koin.io/) - A pragmatic lightweight dependency injection framework for Kotlin\n- [kotlinx.serialization](https://github.com/Kotlin/kotlinx.serialization) - Kotlin multiplatform /\n  multi-format reflectionless serialization\n- [View Model](https://developer.android.com/topic/libraries/architecture/viewmodel) - The ViewModel\n  class is a business logic or screen level state holder. It exposes state to the UI and\n  encapsulates related business logic\n- [Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) - For asynchronous\n  and more.\n- [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/) -\n  A cold asynchronous data stream that sequentially emits values and completes normally or with an\n  exception.\n- [Landscapist](https://github.com/skydoves/landscapist) - 🌻 A pluggable, highly optimized Jetpack\n  Compose and Kotlin Multiplatform image loading library that fetches and displays network images\n  with Glide, Coil, and Fresco.\n- [Android Studio](https://developer.android.com/studio/intro) - Android Studio is the official\n  Integrated Development Environment (IDE) for Android app development.\n- [XCode](https://developer.apple.com/xcode/) - Xcode 14 includes everything you need to develop,\n  test, and distribute apps across all Apple platforms.\n\n## Before running!\n\n- check your system with [KDoctor](https://github.com/Kotlin/kdoctor)\n- install JDK 11 or higher on your machine\n- add `local.properties` file to the project root and set a path to Android SDK there\n\n### Android\n\nTo run the application on Android device/emulator:\n\n- open the project in Android Studio and run the imported android run configuration\n\nTo build the application bundle:\n\n- run `./gradlew :composeApp:assembleDebug`\n- find `.apk` file in `composeApp/build/outputs/apk/debug/composeApp-debug.apk`\n  Run android simulator UI tests: `./gradlew :composeApp:pixel5Check`\n\n### iOS\n\nTo run the application on an iPhone device/simulator:\n\n- Open `iosApp/iosApp.xcproject` in Xcode and run standard configuration\n- Or\n  use [Kotlin Multiplatform Mobile plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile)\n  for Android Studio\n  Run iOS simulator UI tests: `./gradlew :composeApp:iosSimulatorArm64Test`\n\n### Desktop\n\n- Run the desktop application: `./gradlew :composeApp:run`\n- Run desktop UI tests: `./gradlew :composeApp:jvmTest`\n\n### Web\n\n- Before running make sure you have `yarn 1.22.22`\n- Run the web application: `./gradlew wasmJsBrowserDevelopmentRun`\n\n## Project structure\n\n### [`composeApp`](/composeApp)\n\nThis is a Kotlin module that contains the logic common for all platforms.\nThis shared module is where you write your Compose Multiplatform code. In\n`composeApp/src/commonMain/kotlin/App.kt`, you can find the shared root `@Composable` function for\nyour app.\nIt uses Gradle as the build system. You can add dependencies and change settings in\n`composeApp/build.gradle.kts`. The shared module builds into platform-specific libraries:\n- Android library for Android\n- Framework for iOS\n- JVM library for Desktop\n- JavaScript library for Web\n\n#### Complete `composeApp` directory structure\n\nThe complete structure of the `composeApp` module showing all platform-specific directories:\n\n```\ncomposeApp/\n├── build.gradle.kts\n├── src/\n│   ├── androidMain/\n│   │   ├── kotlin/\n│   │   ├── res/\n│   │   │   ├── drawable/\n│   │   │   ├── drawable-v24/\n│   │   │   ├── mipmap-anydpi-v26/\n│   │   │   ├── mipmap-hdpi/\n│   │   │   ├── mipmap-mdpi/\n│   │   │   ├── mipmap-xhdpi/\n│   │   │   ├── mipmap-xxhdpi/\n│   │   │   ├── mipmap-xxxhdpi/\n│   │   │   └── values/\n│   │   └── AndroidManifest.xml\n│   ├── commonMain/\n│   │   ├── composeResources/\n│   │   │   ├── drawable/\n│   │   │   └── values/\n│   │   └── kotlin/\n│   │       ├── constant/\n│   │       │   └── AppConstant.kt\n│   │       ├── data/\n│   │       │   ├── model/\n│   │       │   │   ├── artist/\n│   │       │   │   ├── celebrities/\n│   │       │   │   ├── movie_detail/\n│   │       │   │   ├── tv_detail/\n│   │       │   │   ├── BaseModel.kt\n│   │       │   │   ├── MovieItem.kt\n│   │       │   │   └── TvSeriesItem.kt\n│   │       │   ├── remote/\n│   │       │   │   ├── ApiClient.kt\n│   │       │   │   ├── ApiInterface.kt\n│   │       │   │   └── ApiService.kt\n│   │       │   └── repository/\n│   │       │       └── Repository.kt\n│   │       ├── di/\n│   │       │   ├── AppModule.kt\n│   │       │   ├── KoinApplication.kt\n│   │       │   ├── KoinInitializer.kt\n│   │       │   └── PlatformModule.kt\n│   │       ├── navigation/\n│   │       │   ├── NavGraph.kt\n│   │       │   └── NavigationScreen.kt\n│   │       ├── theme/\n│   │       │   ├── Color.kt\n│   │       │   ├── Shape.kt\n│   │       │   ├── Theme.kt\n│   │       │   └── Type.kt\n│   │       ├── ui/\n│   │       │   ├── component/\n│   │       │   ├── screens/\n│   │       │   └── App.kt\n│   │       └── utils/\n│   │           ├── network/\n│   │           ├── CommonExtension.kt\n│   │           ├── Platform.kt\n│   │           ├── UIExtension.kt\n│   │           └── Utils.kt\n│   ├── desktopMain/\n│   │   └── kotlin/\n│   ├── iosMain/\n│   │   └── kotlin/\n│   └── wasmJsMain/\n│       ├── kotlin/\n│       └── resources/\n```\n\n### [`androidApp`](/composeApp/src/androidMain/)\n\nThis is a Kotlin module that builds into an Android application. It uses Gradle as the build system.\nThe `androidApp` module depends on and uses the shared module as a regular Android library.\n\n### [`iosApp`](/composeApp/src/iosMain/)\n\nThis is an Xcode project that builds into an iOS application. It depends on and uses the shared\nmodule as a regular iOS framework.\n\n## Acknowledgements\n\n- [Kotlin Multiplatform Wizard](https://kmp.jetbrains.com/) For Starter template\n\n## 👨 Developed By\n\n\u003ca href=\"https://twitter.com/piashcse\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://avatars.githubusercontent.com/piashcse\" width=\"90\" align=\"left\"\u003e\n\u003c/a\u003e\n\n**Mehedi Hassan Piash**\n\n[![Twitter](https://img.shields.io/badge/-Twitter-1DA1F2?logo=x\u0026logoColor=white\u0026style=for-the-badge)](https://twitter.com/piashcse)\n[![Medium](https://img.shields.io/badge/-Medium-00AB6C?logo=medium\u0026logoColor=white\u0026style=for-the-badge)](https://medium.com/@piashcse)\n[![Linkedin](https://img.shields.io/badge/-LinkedIn-0077B5?logo=linkedin\u0026logoColor=white\u0026style=for-the-badge)](https://www.linkedin.com/in/piashcse/)\n[![Web](https://img.shields.io/badge/-Web-0073E6?logo=appveyor\u0026logoColor=white\u0026style=for-the-badge)](https://piashcse.github.io/)\n[![Blog](https://img.shields.io/badge/-Blog-0077B5?logo=readme\u0026logoColor=white\u0026style=for-the-badge)](https://piashcse.blogspot.com)\n\n# License\n\n```\nCopyright 2024 piashcse (Mehedi Hassan Piash)\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiashcse%2Fkmp-movie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiashcse%2Fkmp-movie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiashcse%2Fkmp-movie/lists"}