cit223027/Notflix

Kotlin Multiplatform playground

Notflix

🛠️Migrating to KMP - Develop Branch

An android and desktop app built using Kotlin Multiplatforom that consumes TMDB API to display current trending, upcoming and popular movies🍿 and tvshows🎬.

Kotlin Multiplatform is a framework of Kotlin that allows for sharing of a single codebase for business logic across different targets/platforms. Some of the targets supported by kotlin are: Android, iOS, Kotlin/JVM, Kotlin/JS, Android NDK, Windows, Linux, macOS etc.

Compose Multiplatform is a UI framework maybe by Jetbrains that allow for simple and accelerated desktop application and web development using compose. Compose multiplatform also allows sharing compose UI code between diffrent platforms. eg android, desktop(Windows, Linux, MacOS) and web.

Table Of Content

• Prerequisite
• Pros of KMP/KMM
• App Structure
  • 1. androidApp
  • 2. desktopApp
  • 3. iosApp
  • 4. shared
    • Domain
    • Data
    • Presentation
• Libraries
  • Shared
  • Android
• Extras
• Demo
• Android App
• Desktop
• Related Resources
  • Videos 📽️
  • Articles/Blogs 📖
  • Sample Projects 🤖
• Other Helpful Resources
  • Videos 📽️
  • Articles/Blogs 📖
  • Sample Projects 🤖

Prerequisite

// ToDo

Pros of KMP/KMM

• Faster development since you only need to write most of the business logic and tests only once.
• Improve code quality.
• Highly maintainable and testable code due to separation of concern in the codebase.

App Structure

The project currently has 3 main modules:

1. androidApp

This module contains the android application's UI built using Jetpack compose.

2. desktopApp

This module contains the desktop application's UI built using Compose Multiplatform.

3. iOSApp

This module contains iOS code that holds the iosApp UI built using Swift UI

4 . shared

This module contains shared code that holds the domain and data layers and some part of the presentation logic ie.shared viewmodels

Domain

This is the core layer of the application. The domain layer is independent of any other layers this means that changes in other layers will have no effect on domain layer eg. screen UI (presentation layer) or changing database (data layer) will not result in any code change withing domain layer.

Components of domain layer include:

• Models: Defines the core structure of the data that will be used within the application.

• Repositories: Interfaces used by the use cases. Implemented in the data layer.

Data

The data layer is responsible for selecting the proper data source for the domain layer. It contains the implementations of the repositories declared in the domain layer.

Components of data layer include:

• Models

  -Dto Models: Defines POJO of network responses.

  -Entity Models: Defines the schema of the database.

• Mappers: They perform data transformation between domain, dto and entity models.

• Network: This is responsible for performing network operations eg. defining API endpoints using Ktor.

• Cache: This is responsible for performing caching operations using Realm.

• Data Sources: Responsible for deciding which data source (network or cache) will be used when fetching data and presenting the data to viewmodels.

Presentation

The presentation package contains shared viewmodels code.

Libraries

Shared

• Koin - Kotin dependency injection library with multiplatform support.
• Ktor - Provides multiplatform libraries required to make network calls to the REST API.
• Realm - Caching of application data from network responses.
• Multiplatform Settings - This is a Kotlin library for Multiplatform apps, so that common code can persist key-value data.
• kotlinx.coroutines - Library support for Kotlin coroutines with multiplatform support.
• kotlinx.serialization - Provides sets of libraries for various serialization formats eg. JSON, protocol buffers, CBOR etc.
• kotlinx.datetime - A multiplatform Kotlin library for working with date and time.
• Napier - Logger library for Kotlin Multiplatform.
• Mockk - Library for creating mocks for tests.

Android

• Jetpack Compose - Modern toolkit for building native UI.
• Coil - An image loading library for Android backed by kotlin coroutines.
• Splash Screen API - Splash screen API reduces boilerplate code required to create a splash screen.
• Accompanist Navigation Animation - Add animation support when navigating between screens using Compose navigation component.
• Accompanist Pager - A library which provides paging layouts for Jetpack Compose. If you've used Android's ViewPager before, it has similar properties.
• Accompanist Insets
• Accompanist System UI Controller - A library that provides easy-to-use utilities for updating the System UI bar colors within Jetpack Compose.
• Accompanist Material Placeholder -
• Accompanist Pager Indicator - A horizontally laid out indicator for a HorizontalPager or VerticalPager, representing the currently active page and total pages drawn using shape.

iOS

• SwiftUI - SwiftUI is Apple's brand new declarative UI Toolkit for building user interfaces for iOS, tvOS, macOS, and watchOS.
• Cached Async Image - SwiftUI Image loading framework with caching capability.
• KMP Async - A library to use kotlin coroutines in Swift.
• Cocoa Pods - CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects.
• UIimage Colors - Swift Library to extract colors from images.

Extras

• GitHub Actions -The project uses GitHub actions for CI/CD operations such as running automated builds, tests and deploying applications.
• KtLint - The project uses KtLint to check for syntax correctness.

Demo

Android App

iOS App

Desktop App

Related Resources

In this section I've included some resources ie. articles and GitHub repositories that i used to learn about kotlin multiplatform mobile:

Videos 📽️

• Your First Kotlin Multiplatform Mobile App Tutorial
• Sharing Code between iOS and Android with Kotlin #1

Articles/Blogs 📖

• Kotlin Multiplatform Hands-on: Networking and Data Storage
• KaMPKit General Architecture
• Using Koin in a Kotlin Multiplatform Project
• Create your first cross-platform mobile app – tutorial - Learn how to create and run your first Kotlin Multiplatform Mobile application.
• Kotlin Multiplatform. Very beginner’s guide (part 1-3)
• Using Realm persistence library in a Kotlin Multiplatform project

Sample Projects 🤖

• KMM Sample - A sample project for experiments with Kotlin Multiplatform mobile.
• Fantasy Premier League - Kotlin Multiplatform project with Jetpack Compose, Compose for Desktop and SwiftUI clients (and using Ktor for remote API requests and Realm for persistence).
• KaMPKit
• People In Space - Minimal Kotlin Multiplatform project with SwiftUI, Jetpack Compose, Compose for Wear OS, Compose for Desktop, Compose for Web, and Kotlin/JS + React clients along with Ktor backend.
• Poetree - Poetree is a minimalistic poetry app that helps people freely access art from a global community full of poetry lovers.

Other Helpful Resources

In this section I've included resources that are not related to kotlin multiplatform mobile but were really helpful in learning other android components and tools:

Videos 📽️

• ToDo

Articles/Blogs 📖

• Introduction to Github Actions for Android blog by Mindorks on how to set up GitHub actions for an android project.

Sample Projects 🤖