https://github.com/robertlevonyan/countries-kmp

This is a Kotlin Multiplatform project targeting Android, iOS and Desktop.
https://github.com/robertlevonyan/countries-kmp

android android-app android-application android-development android-studio androidstudio desktop desktop-app desktop-application ios ios-app ios-application kotlin kotlin-android kotlin-coroutines kotlin-flow kotlin-multiplatform

Last synced: 3 months ago
JSON representation

This is a Kotlin Multiplatform project targeting Android, iOS and Desktop.

• Host: GitHub
• URL: https://github.com/robertlevonyan/countries-kmp
• Owner: robertlevonyan
• License: gpl-3.0
• Created: 2024-02-12T12:31:40.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-12T17:10:27.000Z (8 months ago)
• Last Synced: 2025-02-01T18:12:05.442Z (3 months ago)
• Topics: android, android-app, android-application, android-development, android-studio, androidstudio, desktop, desktop-app, desktop-application, ios, ios-app, ios-application, kotlin, kotlin-android, kotlin-coroutines, kotlin-flow, kotlin-multiplatform
• Language: Kotlin
• Homepage:
• Size: 1.52 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
### This is a Kotlin Multiplatform project targeting Android, iOS and Desktop.

### About the project

This is a simple application which gets the list of all countries and shows them grouped in the

alphabetical order

#### Screenshots per platform

| Android                        | iOS                    | Desktop                        |

|--------------------------------|------------------------|--------------------------------|

| ![Android](images/android.png) | ![iOS](images/ios.png) | ![Desktop](images/desktop.png) |

### Tech stack

* Rest API - https://restcountries.com/

* Design inspiration - https://dribbble.com/shots/20115299-Countries-and-their-details

* #### Libraries

    - Rest API Calls - Ktor

    - Local Database - SqlDelight

    - Image Loading - Coil

    - Complex Animations - Lottie

    - App Navigation and ViewModels - Precompose

    - UI Framework - Compose Multiplaform

### Project structure

* `/composeApp` is for code that will be shared across your Compose Multiplatform applications.

  It contains several subfolders:

    - `commonMain` is for code that’s common for all targets.

    - `androidMain` is for Android specific code

    - `desktopMain` is for desktop specific code

    - `iosMain` is for iOS specific code

    - `wasmJsMain` is for WEB specific code (this is planned to be supported in the feature)

* `/iosApp` contains iOS applications. Even if you’re sharing your UI with Compose Multiplatform,

  you need this entry point for your iOS app. This is also where you should add SwiftUI code for

  your project.

### Preconditions

> **_NOTE:_** To be able to run the iOS version make sure to have the latest iOS Simulator

### Learning

Learn more

about [Kotlin Multiplatform](https://www.jetbrains.com/help/kotlin-multiplatform-dev/get-started.html),

[Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform/#compose-multiplatform),

[Kotlin/Wasm](https://kotl.in/wasm/)

### Plans for future

* Add support for WEB (WASM)

* Add weather for each country