Unsplash-KMP

KO | EN

gitlite — search

#python #javascript #nodejs #python3 #github-actions #flutter #aws #docker #pytorch #github #react #arduino

★ 28 Open GitHub ↗

A project to display images from https://unsplash.com using Kotlin Multiplatform

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Unsplash-API-KMP [![CI](https://github.com/dalafiarisamuel/unsplash-kmp/actions/workflows/workflow.yml/badge.svg?branch=master)](https://github.com/dalafiarisamuel/unsplash-kmp/actions/workflows/workflow.yml)

A project to display images from [Unsplash](https://unsplash.com) API using Kotlin Multiplatform

## Features

* Jetpack Compose & Compose Multiplatform
* Coil KMP
* MVI Architecture
* Kotlin Coroutines with Flow
* Koin
* Kotlin Gradle DSL
* Google Paging3
* Ktorfit
* Compose Navigation v3
* Room Database
* Datastore
* Glance App Widget (Android)*
* Custom Search Chips
* Theme Switching (System/Light/Dark)

## Libraries

- [Jetpack Compose](https://developer.android.com/jetpack/compose) - Android’s modern toolkit for
  building native UI.
- [Coil KMP](https://github.com/coil-kt/coil) - An image loading library for Android & KMP backed by Kotlin Coroutines.
- [View Model](https://developer.android.com/topic/libraries/architecture/viewmodel) - Presenter for persisting view state across config changes
- [Ktorfit](https://foso.github.io/Ktorfit/installation/) - type safe http client and supports coroutines out of the box.
- [Kotlin Serialization](https://kotlinlang.org/docs/serialization.html#serialize-and-deserialize-json) - JSON Parser,used to parse requests from the API
- [kotlinx.coroutines](https://github.com/Kotlin/kotlinx.coroutines) - Library Support for coroutines
- [Paging3](https://developer.android.com/jetpack/androidx/releases/paging) - The Paging Library
  makes it easier for you to load data gradually and gracefully within your app
- [Compose Navigation v3](https://developer.android.com/guide/navigation/navigation-3) - Navigation 3 is a new navigation library designed to work with Compose
- [Koin](https://insert-koin.io/docs/reference/koin-mp/kmp/) - Kotlin Multiplatform Dependency Injection
- [Room Database](https://developer.android.com/kotlin/multiplatform/room) - Room Database Kotlin Multiplatform Support
- [Datastore](https://developer.android.com/kotlin/multiplatform/datastore) - Datastore Kotlin Multiplatform Support

## New Implementations

|                                **Search Chip Creator**                                |                                  **Favourites Widget**                                  |                              **Theme Selector**                              |
|:-------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------:|
|                   ![Search Chip Creator](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/chip_creator.png)                   |                  ![Favourites Widget](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/favourites_widget.png)                   |                ![Theme Selector](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/theme_selector.png)                |
| Create and manage custom search chips for quick access to your favorite search terms. | Stay inspired with a home screen widget that showcases your bookmarked Unsplash photos. | Personalize your experience with support for System, Light, and Dark themes. |

## Prerequisite

* To successfully make API calls to [Unsplash](https://unsplash.com) Endpoint, use a valid API Token from Unsplash.
* Enter your valid API token [here](./composeApp/src/commonMain/kotlin/di/Koin.kt#L63)

## Mobile App Screenshots

| ![Android Portrait Screenshot](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/screenshot_1.png) | ![Android Foldable Screenshot](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/screenshot_2.png) |
|-----------------------------------------------------------|-----------------------------------------------------------|

| ![iPhone Dark Theme screenshot](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/screenshot_3.png) | ![iPhone Light Theme screenshot](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/screenshot_4.png) |
|------------------------------------------------------------|-------------------------------------------------------------|

## Desktop App Screenshots

| ![Desktop Screenshot 1](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/desktop_screenshot_1.png) | ![Desktop Screenshot 2](https://raw.githubusercontent.com/dalafiarisamuel/Unsplash-KMP/master/images/desktop_screenshot_2.png) |
|------------------------------------------------------------|------------------------------------------------------------|

## Before running

- Check your system with [KDoctor](https://github.com/Kotlin/kdoctor)
- Install JDK 17 or higher on your machine

#### Android

To run the application on android device/emulator:

- open project in Android Studio and run imported android run configuration

#### Desktop

Run the desktop application: `./gradlew :composeApp:run` or `./gradlew run` or `./gradlew hotRunDesktop` for hot reload

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

<br>

Unsplash-KMP

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README