Getting Started

Requirements

Kotlin 2.3+
Java 21 or Java 25, depending on the target repository
Gradle Kotlin DSL
Spring Boot 3/4 or Ktor 3 when using framework integrations

Add The Central BOM

Use bluetape4k-dependencies as the first dependency-management layer.

dependencyManagement {
    imports {
        mavenBom("io.github.bluetape4k:bluetape4k-dependencies:1.0.0")
    }
}

For Exposed integrations, add the Exposed BOM after the central BOM.

dependencyManagement {
    imports {
        mavenBom("io.github.bluetape4k:bluetape4k-dependencies:1.0.0")
        mavenBom("io.github.bluetape4k:bluetape4k-exposed-bom:1.8.0")
    }
}

Pick A Starting Point

Goal	Start here
Shared version governance	`bluetape4k-dependencies`
Core Kotlin and Spring Boot backend utilities	`bluetape4k-projects`
Exposed JDBC/R2DBC repositories	`bluetape4k-exposed`
AWS SDK v2 and Kotlin SDK wrappers	`bluetape4k-aws`
Graph database integrations	`bluetape4k-graph`
Distributed leader election and runtime coordination	`bluetape4k-leader`
Korean/Japanese tokenizers and text processing	`bluetape4k-text`
Backend image processing	`bluetape4k-image`
Audit history and entity diff workflows	`bluetape4k-javers`
Platform migration and incubation work	`bluetape4k-experimental`
General end-to-end examples	`bluetape4k-workshop`
Exposed JDBC examples	`exposed-workshop`
Exposed R2DBC examples	`exposed-r2dbc-workshop`
Optimization examples	`timefold-workshop`
Reference application	`clinic-appointment`

Verify A Project

./gradlew compileTestKotlin --no-daemon

Run compile checks before widening the dependency surface. For modules backed by containers, run the focused integration tests after compile succeeds.