Installation

Maven Central

Isometric is published to Maven Central. Add the dependency to your module’s build.gradle.kts:

build.gradle.kts

dependencies {
    implementation("io.github.jayteealao:isometric-compose:1.1.0")
}

Version Catalog

gradle/libs.versions.toml

[versions]
isometric = "1.1.0"

[libraries]
isometric-core = { module = "io.github.jayteealao:isometric-core", version.ref = "isometric" }
isometric-compose = { module = "io.github.jayteealao:isometric-compose", version.ref = "isometric" }

Then in your build.gradle.kts:

dependencies {
    implementation(libs.isometric.compose)
}

Composite Build (Unreleased / Development)

To depend on an unreleased version from source, clone the Isometric repository alongside your project and use a composite build:

settings.gradle.kts

includeBuild("path/to/Isometric") {
    dependencySubstitution {
        substitute(module("io.github.jayteealao:isometric-core")).using(project(":isometric-core"))
        substitute(module("io.github.jayteealao:isometric-compose")).using(project(":isometric-compose"))
    }
}

Then add the dependency as usual:

dependencies {
    implementation("io.github.jayteealao:isometric-compose:1.2.0-SNAPSHOT")
}

Gradle’s dependency substitution will resolve these coordinates against the included build automatically.

Requirements

Requirement	Minimum Version
Android minSdk	24
Kotlin	1.9+
Jetpack Compose	1.5+
JVM target	11

Modules

Isometric is split into focused modules so you can depend on only what you need.

Module	Description
isometric-core	Pure Kotlin/JVM engine. Contains the math, geometry, and projection logic.
isometric-compose	Jetpack Compose integration. Provides IsometricScene and shape composables.
isometric-android-view	Legacy Android View support for non-Compose projects.

Most projects should depend on isometric-compose, which transitively includes isometric-core.