WordMasterKMP - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #go #android #rust #linux #nodejs #windows #cli #pytorch #ios #mcp

WordMasterKMP

(★ 106)

Kotlin Multiplatform sample with SwiftUI and Compose (Desktop and Android) clients. Heavily inspired by Wordle game.

File Explorer

Download Latest Version (.zip)

- - android.yml
  - desktop.yml
  - ios.yml
- guidelines.md
- build.gradle.kts
- screenshot1.png
- .gitignore
- build.gradle.kts
- words.txt
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- - ContentView.swift
  - Info.plist
  - iOSApp.swift
  - ViewModel.swift
  - words.txt
- - project.pbxproj
- build.gradle.kts
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts
words.txt

# Installation Guide

1. Get the code

git clone https://github.com/joreilly/WordMasterKMP

Downloads the entire project code from GitHub to your computer.

cd WordMasterKMP

Moves into the project folder you just downloaded.

2. Gradle (Java/Kotlin)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java/Kotlin projects.
Gradle If the repo includes gradlew (Gradle Wrapper), you don't need to install Gradle separately.

cd androidApp

This project's files live in a subfolder, so move into it first.

./gradlew build

Builds the project using Gradle.

✅ A BUILD SUCCESSFUL message means it worked. The output is created under build/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WordMasterKMP

![kotlin-version](https://img.shields.io/badge/kotlin-2.4.10-blue?logo=kotlin)

Kotlin Multiplatform sample heavily inspired by [Wordle](https://www.powerlanguage.co.uk/wordle/) game and also [Word Master](https://github.com/octokatherine/word-master) and [wordle-solver](https://github.com/dlew/wordle-solver) samples.  The main game logic/state is included in shared KMP code with basic UI then in following clients
- iOS (SwiftUI)
- Android (Jetpack Compose)
- Desktop (Compose for Desktop)

### Screenshots

<img width="792" height="498" alt="Screenshot 2025-08-16 at 15 21 14" src="https://github.com/user-attachments/assets/7788d21b-9f4c-4e71-8ed9-3ee83666c722" />

### Shared KMP game logic/state

The shared `WordMasterService` class exposes the game state as `StateFlow`s:

```
val boardGuesses = StateFlow<ArrayList<ArrayList<String>>>()       // letters entered on each row
val boardStatus  = StateFlow<ArrayList<ArrayList<LetterStatus>>>() // per-letter result
val keyStatus    = StateFlow<Map<String, LetterStatus>>()          // best status per key, colours the keyboard
val guessError   = StateFlow<String?>()                            // validation feedback
```

Each client renders a board of read-only tiles plus an on-screen keyboard. Key presses call
`WordMasterService.addLetter()` / `removeLetter()`, and `submitGuess()` validates the row against the
word list (surfacing "Not enough letters" / "Not in word list" via `guessError`) before evaluating it
and updating the flows above.  The Compose clients observe state as following (with any updates to those
`StateFlow`'s triggering recomposition)

```
val boardStatus by wordMasterService.boardStatus.collectAsState()
val keyStatus by wordMasterService.keyStatus.collectAsState()
```

On iOS we're using the [KMP-NativeCoroutines](https://github.com/rickclephas/KMP-NativeCoroutines) library to map the `StateFlow` to Swift `AsyncSequence`.  So, for example, our Swift view model includes

```
@Published public var boardStatus: [[LetterStatus]] = []
@Published public var boardGuesses: [[String]] = []
```

which are then updated using for example

```
let stream = asyncSequence(for: wordMasterService.boardStatus)
for try await data in stream {
  self.boardStatus = data as! [[LetterStatus]]
}

let stream = asyncSequence(for: wordMasterService.boardGuesses)
for try await data in stream {
    self.boardGuesses = data as! [[String]]
}

```

Any updates to `boardStatus` or `boardGuesses` will trigger our SwiftUI UI to be recomposed again.

## Full set of Kotlin Multiplatform/Compose/SwiftUI samples

*  PeopleInSpace (https://github.com/joreilly/PeopleInSpace)
*  GalwayBus (https://github.com/joreilly/GalwayBus)
*  Confetti (https://github.com/joreilly/Confetti)
*  BikeShare (https://github.com/joreilly/BikeShare)
*  FantasyPremierLeague (https://github.com/joreilly/FantasyPremierLeague)
*  ClimateTrace (https://github.com/joreilly/ClimateTraceKMP)
*  GeminiKMP (https://github.com/joreilly/GeminiKMP)
*  MortyComposeKMM (https://github.com/joreilly/MortyComposeKMM)
*  StarWars (https://github.com/joreilly/StarWars)
*  WordMasterKMP (https://github.com/joreilly/WordMasterKMP)
*  Chip-8 (https://github.com/joreilly/chip-8)
*  FirebaseAILogicKMPSample (https://github.com/joreilly/FirebaseAILogicKMPSample)