🎮 Hangman - Built With Compose Multuplatform 🖌️

Play / Download

Platform	Access
🌐 Web	Play in browser
🍎 macOS	Download DMG
🪟 Windows	Download MSI
🐧 Linux	Download DEB · Download RPM
🤖️ Android	Download APK
📱 iOS	Run locally on macOS + Xcode: bash scripts/run-ios-sim.sh

Thanks to Cicero Hellmann For giving this cool idea to build Hangman game with Compose for Android.

🎇 What's New: v0.2.0

• Kotlin Multiplatform architecture (app, composeApp, game-core, core/*, feature/*, navigation)
• Platform support: Android
• Platform support: Web (WASM + GitHub Pages)
• Platform support: Desktop (JVM: macOS/Windows/Linux)
• Platform support: iOS (Xcode project + simulator flow)
• Gameplay: 60-second timer per level
• Gameplay: hints (Reveal, Eliminate) with cooldown
• Gameplay: persistent game settings + history
• Gameplay: scoring improvements
• Difficulty: Introduced VERY_HARD difficulty for words >= 11+ chars
• Categories: Introduced new categories and extended vocabulary.
• Responsive game layout (mobile/desktop/web) with previews and shared creepy design system.
• Cross-platform sound support (Android/Web/Desktop/iOS)
• Navigation3 update

Screenshots (v0.2.0)

Foldable

Onboarding	Game	History

Mobile

Onboarding	Game	Summary

History	Select Category	Select Difficulty

Initial Version (v0.1.0)

• Players will be challenged with unique words only.
• Players can view their score/game history.
• Players should know how many unique words can still guess.
• Players can see how many attempts they have to guess the word.
• Players can try out letters in any order they want.
• Players can to know how many points made when I completed a word.
• Players can to know how many points scored by completing all levels.
• Persist the game state at any point of the game.

Local Development

Common commands

• Run Android app:
  • ./gradlew :app:assembleDebug
• Run Desktop app:
  • ./gradlew :composeApp:desktopRun
• Run Web locally:
  • ./gradlew :composeApp:wasmJsBrowserDevelopmentRun
• Build Web distribution:
  • ./gradlew :composeApp:wasmJsBrowserDistribution
• Run iOS simulator (from repo root, macOS + Xcode required):
  • bash scripts/run-ios-sim.sh

Tests

• CI-equivalent local test run:
  • ./gradlew :app:testDebugUnitTest :game-core:desktopTest :feature:onboarding:desktopTest :feature:game:desktopTest :feature:history:desktopTest
• Broader KMP module tests:
  • ./gradlew :composeApp:allTests :core:data:allTests :core:designsystem:allTests :feature:common-ui:allTests :feature:game:allTests :feature:history:allTests :feature:onboarding:allTests :game-core:allTests :navigation:allTests

CI / Releases

• .github/workflows/tests.yaml
  • Runs on pull requests
  • Runs JVM unit + desktop tests
  • Runs Android instrumentation on push/workflow_dispatch
• .github/workflows/pages-production.yml
  • Deploys web app to GitHub Pages
• .github/workflows/packages.yml
  • On master push:
    • builds Android APK
    • builds desktop installers (DMG/MSI/DEB/RPM)
    • updates release artifacts

Contributing

See CONTRIBUTING.md.

• Open an issue for bugs.
• Open a discussion for feature ideas.
• Send a PR with focused changes and passing checks.

Credits

• Game sounds: Pixabay
• Font: Creepster
• Icons/background assets: modified assets from unDraw and iconscout
• Sound license documents: pixabay-license

License

Apache License 2.0. See LICENSE.

Copyright 2022 Rajasekhar K E

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.