# Setup Kotlin DataFrame on Android

> For the complete documentation index, see [llms.txt](https://kotlin.github.io/dataframe/llms.txt).

> **Tip:**
> See an [Android project example](https://github.com/Kotlin/dataframe/tree/master/examples/projects/android-example).

## 1. Add the plugin

[Kotlin DataFrame Compiler Plugin](compiler-plugin.html) enables automatic generation of [extension properties](extensionpropertiesapi.html) and updates [data schemas](schemas.html) on-the-fly in Android projects, making development with Kotlin DataFrame faster, more convenient, and fully type- and name-safe.

> **Tip:**
> Requires Kotlin 2.2.20-Beta1 or higher.

To enable the plugin in your Gradle project, add it to the `plugins` section:

Kotlin DSL:

```KOTLIN
plugins {
    kotlin("plugin.dataframe") version "2.4.21"
}
```

Groovy DSL:

```GROOVY
plugins {
    id 'org.jetbrains.kotlin.plugin.dataframe' version '2.4.21'
}
```

In versions older than Kotlin 2.4.0, add the following line to your `gradle.properties`:

```PROPERTIES
kotlin.incremental=false
```

## 2. Add the library

Kotlin DataFrame doesn't provide a dedicated Android artifact yet, but you can add the Kotlin DataFrame JVM dependency to your Android project with minimal configuration:

Kotlin DSL:

```KOTLIN
dependencies {
    // Core Kotlin DataFrame API, CSV and JSON IO.
    // See custom Gradle setup:
    // https://kotlin.github.io/dataframe/setupcustomgradle.html
    implementation("org.jetbrains.kotlinx:dataframe-core:1.0.0-rc02")
    implementation("org.jetbrains.kotlinx:dataframe-json:1.0.0-rc02")
    implementation("org.jetbrains.kotlinx:dataframe-csv:1.0.0-rc02")
    // You can add any additional IO modules you like, except for 'dataframe-arrow'.
    // Apache Arrow is not well supported on Android.
}
```

Groovy DSL:

```GROOVY
dependencies {
    // Core Kotlin DataFrame API, CSV and JSON IO.
    // See custom Gradle setup:
    // https://kotlin.github.io/dataframe/setupcustomgradle.html
    implementation 'org.jetbrains.kotlinx:dataframe-core:1.0.0-rc02'
    implementation 'org.jetbrains.kotlinx:dataframe-json:1.0.0-rc02'
    implementation 'org.jetbrains.kotlinx:dataframe-csv:1.0.0-rc02'
    // You can add any additional IO modules you like, except for 'dataframe-arrow'.
    // Apache Arrow is not well supported on Android.
}
```

## Next Steps

* Once Kotlin DataFrame is set up in your Android project, continue with the [Quickstart Guide](quickstart.html) to learn the basics of working with DataFrames.

* Explore [detailed guides and real-world examples](guides-and-examples.html) to see how Kotlin DataFrame helps in different data tasks.

* Check out the [Android project example](https://github.com/Kotlin/dataframe/tree/master/examples/projects/android-example) and more [IDEA examples on GitHub](https://github.com/Kotlin/dataframe/tree/master/examples).

* Learn more about the [compiler plugin](compiler-plugin.html).

