sharifmrcreed/jetpack_compose_graphs

✨ A very Minimal, Sleek and Powerful Graph library for Android using Jetpack Compose

Composable-Graphs ( Jetpack Compose )

✨ A very Minimal, Sleek and Lightweight Graph library for Android using Jetpack Compose

Gradle Setup

Latest version:

allprojects {
    repositories {
        maven { url "https://jitpack.io" }
    }
}

dependencies {
    implementation 'com.github.jaikeerthick:Composable-Graphs:v1.0'
}

Screenshots

Usage

1. Bar Graph

BarGraph(
  dataList = listOf(20, 30, 10, 60, 35), //  dataList : List<Number>
)

2. Line Graph

LineGraph(
    xAxisData = listOf("Sun", "Mon", "Tues", "Wed", "Thur", "Fri", "Sat").map {
        GraphData.String(it)
    }, // xAxisData : List<GraphData>, and GraphData accepts both Number and String types
    yAxisData = listOf(200, 40, 60, 450, 700, 30, 50),
)

Example for passing String and Number:

xAxisData = listOf("Sun", "Mon", "Tues", "Wed", "Thur", "Fri", "Sat").map {
                       GraphData.String(it)
            }

xAxisData = listOf(20, 40, 30, 50, 70, 0, 40).map {
                       GraphData.Number(it)
            }

Note: xAxisData can be of GraphData.String & GraphData.Number, but yAxisData can be only of type Number

Styling

BarGraphStyle and LineGraphStyle can be used to style the Graphs effetively

You can control the following things using Style classes:

• Height
• Padding
• Colors
• Visibility - control visibility for crosshair, labels, headers, etc.

// BarGraph
val style = BarGraphStyle(
                    visibility = BarGraphVisibility(
                        isYAxisLabelVisible = true
                    )
                )

// LineGraph
val style2 = LineGraphStyle(
                    visibility = LinearGraphVisibility(
                        isHeaderVisible = true,
                        isYAxisLabelVisible = false,
                        isCrossHairVisible = true
                    ),
                    colors = LinearGraphColors(
                        lineColor = GraphAccent2,
                        pointColor = GraphAccent2,
                        clickHighlightColor = PointHighlight2,
                        fillGradient = Brush.verticalGradient(
                            listOf(Gradient3, Gradient2)
                        )
                    )
                )

And you can pass it to the graph like this:

 BarGraph(
    dataList = listOf(20, 30, 10, 60, 35),
    style = style
)   

Contribution:

Fork the repo and create PRs 🦄