Domain Specific Languages in Kotlin

A Domain Specific Language (DSL) in Kotlin is a programming style that uses extension functions, lambdas with receivers, and other language features to create APIs that read like a custom mini language tailored to a specific problem. Kotlin DSLs appear in Gradle build scripts, Jetpack Compose layouts, Ktor routing, and many other frameworks. Understanding how they work is essential for both consuming existing DSLs and designing your own. By the end of this lesson, you will be able to:

• Explain how lambdas with receivers enable DSL syntax.
• Describe the role of extension functions and @DslMarker in DSL design.
• Build a simple DSL using Kotlin's type safe builder pattern.
• Identify common DSL examples in the Android and Kotlin ecosystem.

Lambdas with Receivers

The foundation of every Kotlin DSL is the lambda with receiver. A regular lambda has the signature (parameters) -> ReturnType. A lambda with receiver has the signature ReceiverType.(parameters) -> ReturnType. Inside the lambda body, this refers to the receiver, so you can call the receiver's members without qualification:

fun buildString(block: StringBuilder.() -> Unit): String {
    val sb = StringBuilder()
    sb.block()
    return sb.toString()
}

val result = buildString {
    append("Hello, ")
    append("World!")
}

The append calls resolve against the StringBuilder receiver. The caller writes code that looks like a configuration block rather than a chain of method calls on an explicit object.

Extension Functions in DSLs

Extension functions let you add new members to existing types without modifying their source. In a DSL context, they define the vocabulary available inside a builder block. Consider a simple HTML builder:

class Tag(val name: String) {
    val children = mutableListOf<Tag>()
    var text: String = ""

    fun tag(name: String, block: Tag.() -> Unit) {
        val child = Tag(name)
        child.block()
        children.add(child)
    }
}

fun html(block: Tag.() -> Unit): Tag {
    val root = Tag("html")
    root.block()
    return root
}