Waifu-KMP is a multimodular Kotlin and Compose Multiplatform app for Android, iOS and Windows (PC).

It uses public Waifu-API to fetch and display images.

Tech Stack

• Build-tools: Gradle (project level, with version catalog) + Amper (module level) + BuildKonfig
• Framework: Kotlin Multiplatform + Compose Multiplatform
• Asynchronous programming: Kotlin Coroutines
• Dependency Injection: Kodein
• Logging: Kermit
• UI & Presentation: Material 3 + ViewModel + Navigation
• Data: Ktor Client

Project structure

• core modules - reusable, adjusted to project context, feature-agnostic components
• feature modules - specific features, might expose UI (Composables) or/and Domain (UseCase-s)
• shared - umbrella module, combines features in main App Composable
• android-app - wraps App Composable from shared for Android Application
• ios-app - wraps App Composable from shared for iOS Application
• jvm-app - wraps App Composable from shared for JVM Application

Setup & Run

Prerequisites

• IntelliJ IDEA IDE installed
• Amper plugin installed
• for Android app:
  • Android plugin installed
  • Android SDK installed and specified in local.properties file
  • Android Device or Emulator ready

General Setup

• git clone the project and open with IntelliJ
• get and add your API key for Waifu API in local.properties file: WAIFU_API_KEY=your-key
• PC app run: go to main.kt and tap on play button next to the main function
• Android app run: after Gradle project sync, run configuration should be available