Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/piashcse/kmp-movie
KMP Movie 📱 app for Android, iOS and desktop built with Compose Multiplatform (KMP, CMP) and MVVM Architecture recommended by Google.
https://github.com/piashcse/kmp-movie
android bottom-navigation clean-architecture compose compose-multiplatform coroutines decompose desktop flow ios kmm kmp kotlin kotlin-serialization ktor moviedbapi mvvm navigation precompose viewmodel
Last synced: 13 days ago
JSON representation
KMP Movie 📱 app for Android, iOS and desktop built with Compose Multiplatform (KMP, CMP) and MVVM Architecture recommended by Google.
- Host: GitHub
- URL: https://github.com/piashcse/kmp-movie
- Owner: piashcse
- Created: 2022-07-02T17:30:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-24T16:36:07.000Z (4 months ago)
- Last Synced: 2024-08-04T23:06:23.096Z (3 months ago)
- 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
- Language: Kotlin
- Homepage:
- Size: 32.1 MB
- Stars: 166
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-kotlin-multiplatform - kmm-movie
README
# KMP Movie (Compose Multiplatform)
[](https://developer.android.com/jetpack/compose)
[](https://kotlinlang.org)
[](https://www.apache.org/licenses/LICENSE-2.0)
KMP Movie app using [The Movie DB](https://www.themoviedb.org) built with Compose Multiplatform and MVVM architecture.
# Platform
- iOS
- Android
- Desktop
- ~~Web~~
# Main Features
- Movie List
- Movie Search
- Movie Detail
- Artist Detail
- Bottom Navigation
- Navigation Rail
## Architecture
- MVVM Architecture (Model - ComposableView - ViewModel)
## Built With ðŸ›
- [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) - Compose Multiplatform, a modern UI framework for Kotlin that makes building performant and beautiful user interfaces.
- [PreCompose](https://github.com/Tlaster/PreCompose) - Compose Multiplatform Navigation && State Management
- [Ktor Client](https://ktor.io/docs/welcome.html) - Ktor includes a multiplatform asynchronous HTTP client, which allows you to make requests and handle responses.
- [kotlinx.serialization](https://github.com/Kotlin/kotlinx.serialization) - Kotlin multiplatform / multi-format reflectionless serialization
- [View Model](https://developer.android.com/topic/libraries/architecture/viewmodel) - The ViewModel class is a business logic or screen level state holder. It exposes state to the UI and encapsulates related business logic
- [Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) - For asynchronous and more.
- [Flow](https://kotlin.github.io/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/) - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.
- [Landscapist](https://github.com/skydoves/landscapist) - 🌻 A pluggable, highly optimized Jetpack Compose and Kotlin Multiplatform image loading library that fetches and displays network images with Glide, Coil, and Fresco.
- [Android Studio](https://developer.android.com/studio/intro) - Android Studio is the official Integrated Development Environment (IDE) for Android app development.
- [XCode](https://developer.apple.com/xcode/) - Xcode 14 includes everything you need to develop, test, and distribute apps across all Apple platforms.
## Before running!
- check your system with [KDoctor](https://github.com/Kotlin/kdoctor)
- install JDK 17 or higher on your machine
- add `local.properties` file to the project root and set a path to Android SDK there
### Android
To run the application on android device/emulator:
- open project in Android Studio and run imported android run configuration
To build the application bundle:
- run `./gradlew :composeApp:assembleDebug`
- find `.apk` file in `composeApp/build/outputs/apk/debug/composeApp-debug.apk`
Run android simulator UI tests: `./gradlew :composeApp:pixel5Check`
### Desktop
Run the desktop application: `./gradlew :composeApp:run`
Run desktop UI tests: `./gradlew :composeApp:jvmTest`
### iOS
To run the application on iPhone device/simulator:
- Open `iosApp/iosApp.xcproject` in Xcode and run standard configuration
- Or use [Kotlin Multiplatform Mobile plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile) for Android Studio
Run iOS simulator UI tests: `./gradlew :composeApp:iosSimulatorArm64Test`
## Project structure
This Compose Multiplatform project includes three modules:
### [`composeApp`](/composeApp)
This is a Kotlin module that contains the logic common for both Android and iOS applications, the code you share between platforms.
This shared module is also where you write your Compose Multiplatform code. In `composeApp/src/commonMain/kotlin/App.kt`, you can find the shared root `@Composable` function for your app.
It uses Gradle as the build system. You can add dependencies and change settings in `shared/build.gradle.kts`. The shared module builds into an Android library and an iOS framework.
### [`androidApp`](/composeApp/src/androidMain/)
This is a Kotlin module that builds into an Android application. It uses Gradle as the build system. The `androidApp` module depends on and uses the shared module as a regular Android library.
### [`iosApp`](/iosApp)
This is an Xcode project that builds into an iOS application. It depends on and uses the shared module as a CocoaPods dependency.
## Acknowledgements
- [Kotlin Multiplatform Wizard](https://kmp.jetbrains.com/) For Starter template
## 👨 Developed By
**Mehedi Hassan Piash**
[](https://twitter.com/piashcse)
[](https://piashcse.github.io/)
[](https://medium.com/@piashcse)
[](https://www.linkedin.com/in/piashcse/)
# License
```
Copyright 2024 piashcse (Mehedi Hassan Piash)
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.
```