Bert's Atlas is an offline geography trivia game for Android and iOS. Product behavior and acceptance criteria live in spec.md; engineering principles live in principles.md.

Project layout

domain: pure multiplatform quiz and progression rules
composeApp: shared Compose UI and platform-neutral application code
androidApp: thin Android launcher required by Android Gradle Plugin 9
catalogTool: JVM catalog validator and human-review report generator
iosApp: thin Xcode host for the shared Compose framework

The extra Android launcher is deliberate. AGP 9 does not support combining com.android.application and Kotlin Multiplatform in one module, so the three substantive modules remain separate from both thin platform hosts.

Toolchain

Builds use JDK 21 and the checked-in Gradle wrapper. Compose Multiplatform 1.12 requires Android compile SDK 37; target SDK remains 36 and minimum SDK is 26.

export JAVA_HOME=/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home
./gradlew :androidApp:assembleDebug
./gradlew :composeApp:linkDebugFrameworkIosSimulatorArm64
./gradlew :catalogTool:run

Generate the Xcode project after changing iosApp/project.yml:

cd iosApp
xcodegen generate

No automated test sources or test dependencies are part of V1. Verification is manual and release catalog validation is performed by catalogTool.