antoniusnaumann / pianist-charts

A beautiful chart library for Jetpack Compose (Android) and Compose for Desktop which supports Material 3 themeing.

👷🚧 Under Construction 🛠

This project is currently under development and not supposed to be used at this point

Pianist Charts

A beautiful chart library for Jetpack Compose (Android) and Compose for Desktop which supports Material 3 themeing.

About

Yet another chart library?

Yes! Because unlike most available chart libraries, Pianist aims to focus on styling and themeing to bring beautiful charts to your dashboard apps written in Compose, supporting all the latest and greatest features of Material 3 like Material You dynamic color out of the box.

Why the name?

For every software tool, there is this mediocre joke game going on with the tools names. For Compose libraries, Google started it with the Accompanist library. So naturally, I had the urge to continue this musical reference game. I found the name Pianist quite fitting, because like a pianist presents a composition to its audience in their own style, the pianist chart library provides charts to present data in a human understandable way in a style compatible with the Material 3 guidelines.

How does it look?

Tooltip on tap	Adjustable line width

Current State

• Line Chart
  • Draw line from data points (upwards oriented coordinate system)
  • Support Material 3 semantic colors
  • React to hover / touch events
    • Highlight a point on hover / touch
    • Expose a hover event to display tooltips etc. via a callback
    • Add a standard tooltip
  • Add extensive customization options for themeing
    • Change point style
    • Add support for custom color set
    • Optionally highlight background under the curve
    • Provide styling for chart background
    • Options for axis styling and labels
• Bar Chart
  • TODO
• Multi-Chart (e.g. three line charts and a bar chart overlayed)
  • TODO

License

This library is available under GPL 3.0. Contact me if you need to obtain this library under a different license.

Pianist - A beautiful chart library for the Compose UI framework (Android & JVM/Desktop)
Copyright (C) 2022 Antonius Naumann

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.