Kiln Samples

Runnable examples for Kiln — compile-time CRUD generation for Kotlin Multiplatform SQLite.

These samples consume Kiln exactly the way you would: the plugin and artifacts come from Maven Central, and there are no project(":") references back into the library. What you see here is what your own project looks like.

Samples

Each sample is a self-contained folder under samples/ with its own README.

Sample	What it shows
compose-multiplatform	One @Composable and one set of generated repositories shared by Android and iOS. Centres on a many-to-many junction table with a composite primary key.
android-views	The same library in a traditional XML / RecyclerView Android app — for codebases not on Compose.

./gradlew :compose-multiplatform:installDebug   # Compose, Android
./gradlew :android-views:installDebug           # Views, Android
./gradlew :compose-multiplatform:linkDebugFrameworkIosSimulatorArm64   # iOS

The whole setup

plugins {
    id("io.github.sufarook.kiln") version "1.0.0-alpha05"
}

That one line applies KSP, wires the processor, and adds the annotations + runtime dependencies. You still choose a SQLite driver for your platform — Kiln doesn't bundle one.

Highlight: a junction table from three data classes

@DbEntity(tableName = "tasks")
data class Task(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val title: String,
    @Column(name = "is_done") val isDone: Boolean = false
)

@DbEntity(tableName = "tags")
data class Tag(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val name: String
)

// Both columns are part of the composite primary key *and* foreign keys —
// which is exactly what a join table is.
@DbEntity(tableName = "task_tags")
data class TaskTag(
    @PrimaryKey @Relation val taskId: Long,
    @PrimaryKey @Relation val tagId: Long
)

From TaskTag alone, Kiln generates TaskTagKey(taskId, tagId), findByTask / findByTag, their observeBy… variants, and deleteByTask / deleteByTag — plus the correct table-level PRIMARY KEY ("task_id", "tag_id") constraint.

Requirements

Kiln	1.0.0-alpha05
Kotlin	2.3.20
Compose Multiplatform	1.11.1
AGP	8.11.2
JDK	17
minSdk / compileSdk	24 / 36

Trying an unreleased Kiln

settings.gradle.kts includes mavenLocal(), so you can point these samples at a locally-built Kiln:

cd ../Kiln && ./gradlew publishToMavenLocal    # then bump `kiln` in gradle/libs.versions.toml

License

Apache-2.0, same as Kiln.