Installation

Use a Kotlin/JVM project with Maven Central. Runtime artifacts require Java 17 or later and a Kotlin 2.3.0 or later consumer. See the compatibility reference for tested versions.

Add core to your Gradle Kotlin DSL build:

build.gradle.kts

repositories {
  mavenCentral()
}

dependencies {
  implementation("org.buildmosaic:mosaic-core:0.6.0")
}

Core exposes the coroutine APIs it uses. Runtime installation needs no compiler plugin, KSP processor, or Tile registration.

Align optional modules

Use the BOM when adding testing or tracing:

build.gradle.kts

dependencies {
  implementation(platform("org.buildmosaic:mosaic-bom:0.6.0"))
  implementation("org.buildmosaic:mosaic-core")
  // Optional execution tracing:
  implementation("org.buildmosaic:mosaic-opentelemetry")

  testImplementation(platform("org.buildmosaic:mosaic-bom:0.6.0"))
  testImplementation("org.buildmosaic:mosaic-test")
  testImplementation(kotlin("test"))
}

The BOM aligns core, test, and OpenTelemetry modules. It does not add those libraries, install tracing, or align analysis tooling. The tracing adapter exposes OpenTelemetry API; your application provides its SDK or Java agent.

Continue with the Quick Start. Install optional build analysis separately using the architecture guide.