A Kotlin Multiplatform chart library built with Jetpack Compose.
Documentation · Production Demo · Snapshot Demo · Maven Central
| Project | Description |
|---|---|
| charts | Core Kotlin Multiplatform chart library for Compose apps. |
| charts-docs | Documentation site and published examples. |
| compose-gif-recorder | Utility used to record Compose chart examples as GIFs. |
Use the umbrella artifact when you want all chart types with the simplest setup.
commonMain.dependencies {
implementation("io.github.hdcharts:charts:<version>")
}Use independent modules when you want only specific chart types and smaller dependency footprint.
commonMain.dependencies {
implementation("io.github.hdcharts:line:<version>")
implementation("io.github.hdcharts:pie:<version>")
implementation("io.github.hdcharts:bar:<version>")
implementation("io.github.hdcharts:histogram:<version>")
implementation("io.github.hdcharts:stacked-bar:<version>")
implementation("io.github.hdcharts:stacked-area:<version>")
implementation("io.github.hdcharts:radar:<version>")
implementation("io.github.hdcharts:gauge:<version>")
implementation("io.github.hdcharts:scatter:<version>")
implementation("io.github.hdcharts:heatmap:<version>")
implementation("io.github.hdcharts:waterfall:<version>")
}Use BOM for version alignment where Gradle platforms are supported.
For KMP commonMain, keep explicit versions as shown above.
dependencies {
implementation(platform("io.github.hdcharts:bom:<version>"))
implementation("io.github.hdcharts:line")
implementation("io.github.hdcharts:pie")
implementation("io.github.hdcharts:bar")
implementation("io.github.hdcharts:histogram")
implementation("io.github.hdcharts:stacked-bar")
implementation("io.github.hdcharts:stacked-area")
implementation("io.github.hdcharts:radar")
implementation("io.github.hdcharts:gauge")
implementation("io.github.hdcharts:scatter")
implementation("io.github.hdcharts:heatmap")
implementation("io.github.hdcharts:waterfall")
}import androidx.compose.runtime.Composable
import io.github.hdcharts.core.model.toChartData
import io.github.hdcharts.line.LineChart
data class Nutrient(val name: String, val calories: Double)
@Composable
fun NutrientCaloriesChart() {
val nutrients = listOf(
Nutrient("Carbs", 240.0),
Nutrient("Protein", 180.0),
Nutrient("Fat", 320.0),
)
val data = nutrients.toChartData(
value = { it.calories },
category = { it.name },
)
LineChart(
data = data,
title = "Calories by nutrient",
)
}Start with charts-workspace to set up the local workspace.