cxwudi / realworld-compose-http4k-example-app

An unfinished Conduit (https://github.com/gothinkster/realworld) example app developed in Compose Multiplatform and Http4k

2024.08 Update: I am pausing the implementation for now. More information at this discussion

Compose Multiplatform + http4k codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This codebase was created to demonstrate a fully fledged fullstack application built with Compose Multiplatform and http4k including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the community styleguides & best practices of Compose Multiplatform and http4k.

For more information on how this works with other frontends/backends, head over to the RealWorld repo.

How it works

The project is divided into 4 modules:

1. conduit-common - the shared code between the client and the server.
2. conduit-frontend - the KMP client source code.
3. conduit-backend - the server source code.
4. build-src - shared Gradle build logic, including the version catalog that is used globally across the project.

Develop

Install Android Studio and IntelliJ IDEA, then:

• Frontend: Open the conduit-frontend directory in Android Studio.
• Backend: Open the conduit-backend directory in IntelliJ IDEA.

About Frontend

For frontend development, you need to follow this guide to set up the Compose Multiplatform development environment.

conduit-frontend declares all 4 platforms of JVM, Android, JS, and iOS. However, iOS is only declared in Gradle but not developed since I don't have a Mac machine.

conduit-frontend contains multiplatform tests that run on all 4 platforms. However, tests on the JS platform require a browser, so far useChromiumHeadless() is defined in kmp-library.gradle.kts, which means you need to install Chromium for running tests on the JS platform. If you already have a Chrome browser, feel free to change to useChromeHeadless()(or useFirefox() and others) for your convenience.

realworld-compose-http4k-example-app's Issues

Main page navigation

Starting from today, all PoC and integration are done, we are now back again moving on feature implementation.

First is the main page navigation

JS Persistence solution, which one?

We just finished SQLDelight setup but found that it doesn't support persistence in JS browser.

Two options:

1. Try out https://github.com/dellisd/sqldelight-sqlite-wasm
2. Switch to KStore

Is it a recomposition performance issue?

So far I noticed that all NavigationBarItem in MainNavPage are recomposited upon the navigation bar switching to another page. This is definitely wrong. Fortunately, for the NavigationBarItem that is untouched, the content inside is skipped for recomposition. So not sure if it is considered as a performance issue.

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Pending Branch Automerge

These updates await pending status checks before automerging. Click on a checkbox to abort the branch automerge, and create a PR instead.

• ⬆ upgrade mvikotlin to v4.2.0 (com.arkivanov.mvikotlin:mvikotlin-logging, com.arkivanov.mvikotlin:mvikotlin-extensions-coroutines, com.arkivanov.mvikotlin:mvikotlin-main, com.arkivanov.mvikotlin:mvikotlin)

Detected dependencies

github-actions

.github/workflows/decompose-frontend-test.yml

• actions/checkout v4
• actions/setup-java v4
• browser-actions/setup-chrome v1
• gradle/actions v4
• actions/upload-artifact v4

.github/workflows/http4k-backend-test.yml

• actions/checkout v4
• actions/setup-java v4
• gradle/actions v4
• actions/upload-artifact v4

gradle

build-src/libs.versions.toml

• org.jetbrains.kotlinx:kotlinx-serialization-json 1.7.1
• org.lighthousegames:logging 1.5.0
• org.jetbrains.kotlinx:kotlinx-coroutines-bom 1.8.1
• dev.chrisbanes.material3:material3-window-size-class-multiplatform 0.5.0
• com.arkivanov.essenty:lifecycle-coroutines 2.1.0
• com.arkivanov.decompose:decompose 3.1.0
• com.arkivanov.decompose:extensions-compose 3.1.0
• com.arkivanov.mvikotlin:mvikotlin 4.1.0
• com.arkivanov.mvikotlin:mvikotlin-main 4.1.0
• com.arkivanov.mvikotlin:mvikotlin-extensions-coroutines 4.1.0
• com.arkivanov.mvikotlin:mvikotlin-logging 4.1.0
• io.insert-koin:koin-bom 4.0.0-RC1
• org.jetbrains.kotlin-wrappers:kotlin-wrappers-bom 1.0.0-pre.787
• io.github.xxfast:kstore 0.8.0
• io.github.xxfast:kstore-file 0.8.0
• io.github.xxfast:kstore-storage 0.8.0
• androidx.core:core-ktx 1.13.1
• androidx.appcompat:appcompat 1.7.0
• androidx.lifecycle:lifecycle-runtime-ktx 2.8.4
• androidx.activity:activity-compose 1.9.1
• org.http4k:http4k-bom 5.26.1.0
• org.jetbrains.exposed:exposed-bom 0.53.0
• org.junit:junit-bom 5.10.3
• io.kotest:kotest-bom 5.9.1
• io.kotest.extensions:kotest-extensions-koin 1.3.0
• io.mockk:mockk 1.13.12
• org.xerial:sqlite-jdbc 3.46.0.1
• com.zaxxer:HikariCP 5.1.0
• org.flywaydb:flyway-core 10.17.0
• ch.qos.logback:logback-classic 1.5.6
• org.slf4j:slf4j-api 2.0.15
• com.github.CXwudi:kotlin-jvm-inline-logging 1.0.1
• org.jetbrains.kotlin:kotlin-gradle-plugin 2.0.10
• org.jetbrains.kotlin:compose-compiler-gradle-plugin 2.0.10
• com.android.tools.build:gradle 8.5.2
• org.jetbrains.compose:compose-gradle-plugin 1.6.11
• org.jetbrains.kotlin:kotlin-serialization 2.0.10
• dev.mokkery:mokkery-gradle 2.2.0
• com.gradle.develocity:com.gradle.develocity.gradle.plugin 3.17.6
• org.gradle.toolchains:foojay-resolver 0.8.0
• org.jetbrains.kotlin.jvm 2.0.10
• org.jetbrains.kotlin.multiplatform 2.0.10
• com.android.library 8.5.2
• com.android.application 8.5.2
• org.jetbrains.kotlin.plugin.serialization 2.0.10
• org.jetbrains.kotlin.plugin.compose 2.0.10
• org.jetbrains.compose 1.6.11
• com.github.gmazzo.buildconfig 5.4.0

build-src/plugins/settings.gradle.kts

build-src/plugins/build.gradle.kts

build-src/plugins/kotlin-jvm-app/build.gradle.kts

build-src/plugins/kotlin-jvm-app/src/main/kotlin/my/kotlin-jvm.gradle.kts

build-src/plugins/multiplatform-library/build.gradle.kts

build-src/plugins/multiplatform-library/src/main/kotlin/my/kmp-frontend-library.gradle.kts

build-src/plugins/multiplatform-library/src/main/kotlin/my/kmp-library.gradle.kts

build-src/plugins/version-catalog-util/build.gradle.kts

build-src/plugins/version-catalog-util/src/main/kotlin/my.dummy.gradle.kts

build-src/settings/settings.gradle.kts

build-src/settings/root-settings-plugin/build.gradle.kts

build-src/settings/root-settings-plugin/src/main/kotlin/my.root-settings-plugin.settings.gradle.kts

conduit-backend/gradle.properties

conduit-backend/settings.gradle.kts

conduit-backend/build.gradle.kts

conduit-common/gradle.properties

conduit-common/settings.gradle.kts

conduit-common/build.gradle.kts

conduit-frontend/gradle.properties

conduit-frontend/settings.gradle.kts

conduit-frontend/build.gradle.kts

conduit-frontend/app-android/build.gradle.kts

conduit-frontend/app-desktop/build.gradle.kts

conduit-frontend/app-js/build.gradle.kts

conduit-frontend/frontend-compose-ui/build.gradle.kts

conduit-frontend/frontend-decompose-logic/build.gradle.kts

• co.touchlab:stately-common 2.0.7

gradle-wrapper

conduit-backend/gradle/wrapper/gradle-wrapper.properties

• gradle 8.9

conduit-common/gradle/wrapper/gradle-wrapper.properties

• gradle 8.9

conduit-frontend/gradle/wrapper/gradle-wrapper.properties

• gradle 8.9

---

• Check this box to trigger a request for Renovate to run again on this repository