chartopia
2.0.8indexedOffers a library for creating various charts, currently supporting a customizable DonutChart with segments defined by angle, color, and progress. Future chart types planned.
25
Stars
—
Used by
dependents
—
Health
/ 100
Chartopia
Chartopia is a Kotlin/Compose Multiplatform library that provides a variety of customizable charts to visually represent data.
Be sure to show your support by starring ⭐️ this repository, and feel free to contribute if you're interested!
🌟 Features
- 🍩 DonutChart: A circular chart for visualizing proportional data, with smooth animations and extensive customization options. Add a list of segments to represent categories, making it perfect for percentages or distribution comparisons.
- 📈 LineChart: A versatile chart for displaying trends and patterns, fully customizable with animated transitions. Supports multiple lines on the same chart, enabling clear and effective comparisons of different datasets on shared axes.
🛠️ Installation
Add the dependency in your common module's commonMain sourceSet:
In your settings.gradle.kts file, add Maven Central to your repositories:
repositories {
mavenCentral()
}
Then add Chartopia dependency to your module:
- With version catalog, open
libs.versions.toml:
[versions]
chartopia = "2.0.0" // Check latest version
[libraries]
chartopia = { group = "io.github.tweener", name = "chartopia", version.ref = "chartopia" }
Then in your module build.gradle.kts add:
dependencies {
implementation(libs.chartopia)
}
- Without version catalog, in your module
build.gradle.ktsadd:
dependencies {
val chartopia_version = "2.0.0" // Check latest version
implementation("io.github.tweener:chartopia:$chartopia_version")
}
The latest version is:
🧑💻 Usage
🍩 Donut chart
A DonutChart requires a list of Segments, with the first segment starting from the given startAngleFromOrigin in degrees.
Each segment is defined by an angle, its color and an optional progress option.
See .degrees to easily use float angles in degrees.
This code gives the following output:
📈 Line chart
A LineChart is a versatile chart used to visualize data points connected by straight or curved lines. It is ideal for displaying trends, relationships, or changes over time.
LineChart(
modifier = Modifier
.fillMaxWidth()
.height(200.dp),
lines = lines,
xAxis = xAxis,
yAxis = yAxis,
textStyle = MaterialTheme.typography.labelLarge,
gridVisibility = LineChartDefaults.gridVisibility(
showXAxis = true,
showYAxis = true,
),
colors = LineChartDefaults.chartColors(
xAxisValues = MaterialTheme.colorScheme.onBackground,
xAxisGrid = MaterialTheme.colorScheme.outline,
yAxisValues = MaterialTheme.colorScheme.onBackground,
yAxisGrid = MaterialTheme.colorScheme.outline,
),
sizes = LineChartDefaults.chartSizes(
axisStrokeWidth = 1.dp,
axisDashOn = 8.dp,
axisDashOff = 8.dp,
axisXValuesPadding = Size.Padding.Small,
axisYValuesPadding = Size.Padding.ExtraSmall,
)
)
Some examples of output with straight or curved lines:
👨💻 Contributing
We love your input and welcome any contributions! Please read our contribution guidelines before submitting a pull request.
🙏 Credits
- Logo by Freeicons
📜 Licence
Chartopia is licensed under the Apache-2.0.