Compile-time object mapping for Kotlin Multiplatform — annotate your wire models, get type-safe mappers generated by KSP. No reflection, no runtime registry, no boilerplate.

data class User(val id: Long, val joined: LocalDate)

@MapTo(User::class)
data class UserResponse(val id: Long, val joined: String)

// generated at compile time:
val user: Result<User> = UserResponse(7, "2026-06-12").toUserResult()

What makes that different from every mapper you've hand-written:

• Failures are values. Generated mappers return Result<T> — malformed wire data is a typed MappingException, never a surprise crash. The fallback ladder (value > constructor default > null > error) keeps one bad field from destroying a payload, and every absorbed error is reported to an observability sink.
• Errors carry a path. Cannot convert customer.address.zipCode: … — R8-safe, three objects deep.
• Lossy conversions don't compile. Long → Int fails the build with a guiding message instead of silently truncating in production.
• User–author parity. Your converters, validators, and collection wrappers run on exactly the same rails as the 35 built-ins — no privileged internals.

Full guide on GitBook: https://kmapper.gitbook.io/docs

Source Markdown in the repo: English · Türkçe — installation, the mental model, field mapping, null-safety, converters, validation, collections, enums, error handling, observability, multi-module setup, full annotation reference.

Prefer reading code? The sample gallery has 26 runnable examples covering every feature, ordered basic → advanced (./gradlew sample:runSample).

Working on a project that uses KMapper? Start here:

• llms.txt — curated index of the docs (llmstxt.org format); llms-full.txt — the entire guide as one file for context ingestion. (The GitBook site serves its own at kmapper.gitbook.io/docs/llms.txt.)
• docs/AGENTS.md — consumer cheat sheet: the 3-rule mental model, annotation table, sharp edges, and compile-error → fix mappings.
• Writing 1.x-era API (@Ignore, @UseMapTypeConverter, @ValidateFrom/To, @MapDefaultValue)? Those names still resolve but fail compilation with guided ERROR-level deprecations naming the 2.0 replacement — follow the message or the migration guide.

plugins {
    id("com.google.devtools.ksp") version "2.3.10-2.0.5"
}

dependencies {
    implementation("io.github.sahsenvar:kmapper-core:2.2.2")
    implementation("io.github.sahsenvar:kmapper-annotations:2.2.2")
    ksp("io.github.sahsenvar:kmapper-compiler:2.2.2")
}

KMP setup and add-ons: installation guide.

Group io.github.sahsenvar:

kotlinx-datetime (LocalDate, Instant, …) and kotlin.time.Duration converters are core built-ins — no add-on needed.

Latest release: 2.2.2 (11 artifacts) — on Maven Central. 2.x is the converter-subsystem redesign; upgrading from 1.x? Migration guide · CHANGELOG.

Design ledger & implementation plans live in docs/superpowers/ and docs/converter-redesign.md.