Skip to content

omarzer0/AnimeAZ

Repository files navigation

AnimeAZ

Kotlin Multiplatform project with SharedUI and Shared Logic.

Note: The Desktop version is almost ready! WO HOOO 🎉🎉🎉🎉

Showcase

Android IOS (I'm limited only to 10mb video)
AZAnimeAndroid.mp4
AZAnimeIOS.mp4

Stack & Open-source libraries

  • 🎉🎉 Single codebase for both Android and IOS, and YES even Shared UI 🎉🎉 and should also work across all platforms.
  • Jetpack Compose for writing only single code for Android and IOS.
  • Ktor client for handling network requests.
  • SqlDelight database for saving favorite anime locally.
  • Koin for dependency management across both Android and IOS.
  • Compose ImageLoader for loading images.
  • Decompose + Router for easily handling navigation on all platforms.
  • Kotlin date-time for working with data and time.
  • Multiplatform Settings for saving key-value pairs like datastore.
  • AZ-Paging for handling paginating data from data sources like network or database. I still need to publish it until we have paging support.
  • MOKO Mvvm provides architecture components of Model-View-ViewModel for UI applications.
  • MOKO resources A great library for providing access to shared resources (like images, fonts, and strings) on all platforms.🔥🔥
  • MOKO Biometry for handling biometric authentication (Face ID, Touch ID, and also using PIN code).
  • Pull Refresh Standalone pull to refresh library for Jetpack Compose multiplatform without the reliance on Material (As the dev says).
  • Material 3 for theming and using dynamic color on Android.
  • Saving favorite Anime images to local file Shoutout to Philipp Lackner.

Featuring

  • Shared UI for both Android and IOS.
  • Single code for writing the logic of the app using Kotlin.
  • Handling paging data from network (loading initial, next, and refresh) and using it together with search functionality.
  • Add favorite Anime to a local database but save the image to a local file.
  • The App supports 3 languages (English, Arabic, and German).
  • Supports Dark and Light mode with Dynamic coloring on Android only.
  • Saving key-value pair (saving either to use Lock or not for the app).
  • Locking the app using Face ID, Fingerprint, and/or PIN code.
  • Handling navigation and passing objects between screens.
  • Injecting dependencies for the shared main and injecting platform-specific dependencies from each platform.
  • Use default images for error and loading state.
  • Swipe to refresh data.
  • Search with paging for your favorite anime.
  • Show all Top-rated anime.

How to run

Before running!

  • check your system with KDoctor
  • install JDK 17 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 :shared:assembleDebug
  • find .apk file in shared/build/outputs/apk/debug/shared-debug.apk

Desktop

Run the desktop application: ./gradlew :shared:run

iOS

To run the application on iPhone device/simulator:

Note

  • The idea of this app is to use as many features as possible to explore the power of KMP (The app doesn't have to make sense 😊) so feel free to add or request any feature you like.
  • The IOS still alpha currently (11/10/2023) so it is a bit laggy even with release.
  • Can't record the Biometric Auth screen.

Releases

No releases published

Packages

No packages published