Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ibenabdallah/the-movie-db

The Movie BD : Android 📱, iOS 📱 and wearOS ⌚ application built with Kotlin Multiplatform, Compose Multiplatform with MVVM, Clean Architecture recommended by Google
https://github.com/ibenabdallah/the-movie-db

android clean-architecture coil3 compose-multiplatform courotines flow ios jetpack-compose koin koin-kotlin kotlin-multiplatform ktor wearos

Last synced: 9 days ago
JSON representation

The Movie BD : Android 📱, iOS 📱 and wearOS ⌚ application built with Kotlin Multiplatform, Compose Multiplatform with MVVM, Clean Architecture recommended by Google

Host: GitHub
URL: https://github.com/ibenabdallah/the-movie-db
Owner: ibenabdallah
License: apache-2.0
Created: 2024-01-25T05:02:29.000Z (10 months ago)
Default Branch: main
Last Pushed: 2024-07-21T19:22:44.000Z (4 months ago)
Last Synced: 2024-08-01T19:54:06.379Z (4 months ago)
Topics: android, clean-architecture, coil3, compose-multiplatform, courotines, flow, ios, jetpack-compose, koin, koin-kotlin, kotlin-multiplatform, ktor, wearos
Language: Kotlin
Homepage: https://ibenabdallah.github.io/
Size: 12.1 MB
Stars: 73
Watchers: 1
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-list - ibenabdallah/the-movie-db - The Movie BD : Android 📱, iOS 📱 and wearOS ⌚ application built with Kotlin Multiplatform, Compose Multiplatform with MVVM, Clean Architecture recommended by Google (Kotlin)

README

        # The Movie DB (Compose Multiplatform)

[![Compose Multiplatform](https://img.shields.io/github/v/release/JetBrains/compose-multiplatform?color=brightgreen&label=Compose%20Multiplatform)](https://github.com/JetBrains/compose-multiplatform/releases/latest)

[![Platform Android](https://img.shields.io/badge/Platform-Android-brightgreen)](https://developer.android.com/about?hl=fr)

[![Platform iOS](https://img.shields.io/badge/Platform-iOS-lightgray)](https://developer.apple.com/ios/)

[![Platform wearOS](https://img.shields.io/badge/Platform-wearOS-lightgreen)](https://wearos.google.com/intl/fr_fr/)

[![Kotlin](https://img.shields.io/badge/Kotlin-1.9.22-blue.svg?style=flat&logo=kotlin)](https://kotlinlang.org)

[![GitHub license](https://img.shields.io/github/license/ibenabdallah/the-movie-db)](https://github.com/ibenabdallah/the-movie-db/blob/main/LICENSE)

[![GitHub ibenabdallah](https://img.shields.io/static/v1?label=GitHub&message=ibenabdallah&color=C51162)](https://github.com/ibenabdallah)

The Movie DB app using [The Movie DB](https://www.themoviedb.org) built with Kotlin Multiplatform & Compose Multiplatform.


# Platform Supports :iphone:

- Android 📱

- iOS 📱

- WearOS ⌚

- TV 📺 (in progress)



  

  

  

  

  



## Built With 🛠

- [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 15.2 includes everything you need to develop, test, and distribute apps across all Apple platforms.

- [Kotlin Multiplatform Mobile](https://kotlinlang.org/docs/multiplatform-get-started.html) - The Kotlin Multiplatform technology, to use it you must integrate the following plugins [plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile)

- [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) - Compose Multiplatform, a modern UI framework for Kotlin that makes building performant and beautiful user interfaces.

- [Navigation Compose](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-navigation-routing.html) - Compose Multiplatform Navigation

- [Lifecycle Viewmodel Compose](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-lifecycle.html#viewmodel-implementation) - Model-View-ViewModel architecture components for mobile (android & ios) Kotlin Multiplatform development.

- [kotlinx.serialization](https://github.com/Kotlin/kotlinx.serialization) - Kotlin multiplatform / multi-format reflectionless serialization

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

- [Ktor Client](https://ktor.io/docs/welcome.html) - Ktor includes a multiplatform asynchronous HTTP client, which allows you to make requests and handle responses.

- [Koin](https://github.com/InsertKoinIO/koin) - Koin a pragmatic lightweight dependency injection framework for Kotlin & Kotlin Multiplatform.

- [Coil3](https://github.com/coil-kt/coil/tree/3.x) - An image loading library for Android backed by Kotlin Coroutines for Kotlin Multiplatform.

- [Paging](https://github.com/cashapp/multiplatform-paging) - A library that adds additional Kotlin Multiplatform targets to AndroidX Paging, and provides UI components to use Paging on iOS.

- [Kermit](https://github.com/touchlab/Kermit) - Kermit is a Kotlin Multiplatform centralized logging utility

- [BuildKonfig](https://github.com/yshrsmz/BuildKonfig) - Supports embedding values from gradle file.

ℹ️ Please note, I used some libraries which are not yet in stable version, this remains as an example of a project to gain expertise on new technologies.

## Architecture :toolbox:

The app architecture has three layers : a [data layer](https://developer.android.com/jetpack/guide/data-layer), a [domain layer](https://developer.android.com/jetpack/guide/domain-layer) and a [UI layer](https://developer.android.com/jetpack/guide/ui-layer).

I followed the [Guide to app architecture](https://developer.android.com/topic/architecture) by google.

Also I applied the [SOLID principles](https://fr.wikipedia.org/wiki/SOLID_(informatique))

## Project structure :bow_and_arrow:

The project follows the standard Kotlin Multiplatform structure, with the following notable files and directories, that targeting Android, iOS, wearOS and TV (in Progress).

* [`uiCompose`](/uiCompose) Contains the project code common.

  - [`src/commonMain`](/composeApp/src/commonMain) This is a Kotlin module that contains the UI 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 `uiCompose/src/commonMain/kotlin/AppScreen.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 `uiCompose/build.gradle.kts`. The shared module builds into an Android library and an iOS framework..

  - [`src/androidMain`](/composeApp/src/androidMain) Contains the Android-specific code and specific configuration files.

  - [`src/iosMain`](/composeApp/src/iosMain) Contains the iOS-specific code and specific configuration files.

* [`data`](/data) This is the network layer module.

* [`domain`](/domain) This is the logic layer module.

* [`model`](/model) This is the module that contains the models of the ui layer.

* [`androidApp`](/androidApp) Contains the android-specific configuration files.

* [`iosApp`](/iosApp) Contains the iOS-specific configuration files.

* [`wearOS`](/wearOS) Contains the wearOS-specific code ui and specific configuration files.

* [`build.gradle.kts`](/composeApp/build.gradle.kts) The main Gradle build script for the project.

## Getting Started 🛠

1. Clone this repository to your local machine.

    ```text

    git clone https://github.com/ibenabdallah/the-movie-db.git

    ```

2. Open the project in Android Studio.

3. Set up your Android and iOS device/emulator/simulator.

4. You must create an account on the site [The Movie DB](https://www.themoviedb.org) to create a key afterwards, then set up the `local.properties` file in the project's root directory (if it doesn't already exist) by adding the following properties :

```properties

api_key=

```

5. Build and run the project.

## Run project on Different Platforms 🚀

### 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 :androidApp:assembleDebug`

- find `.apk` file in `androidApp/build/outputs/apk/debug/androidApp-debug.apk`

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

### wearOS

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 :wearOS:assembleDebug`

- find `.apk` file in `wearOS/build/outputs/apk/debug/wearOS-debug.apk`

## Contributing :writing_hand:

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request. Please ensure that your contributions adhere to the project's coding style and guidelines.

## Contributors 📢



    



## License :spiral_notepad:

This project is licensed under the [MIT License](LICENSE).

## Connect with me :man_shrugging:

[![](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/ibenabdallah/)

[![](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/Ingbaismail)