frappe /charts
Simple, responsive, modern SVG Charts with zero dependencies
★ 15,097⑂ 756👁 210⑃ 150● 283▤ 18
+0
Daily
+5
Weekly
+10
Monthly
15,097
stars
756
forks
210
watchers
150
prs
283
issues
18
releases
README
Frappe Charts
GitHub-inspired modern, intuitive and responsive charts with zero dependencies
Explore Demos - Edit at CodeSandbox - Documentation
Frappe Charts
Frappe Charts is a simple charting library with a focus on a simple API. The design is inspired by various charts you see on GitHub.
Motivation
ERPNext needed a simple sales history graph for its user company master to help users track sales. While using c3.js for reports, the library didn’t align well with our product’s classic design. Existing JS libraries were either too complex or rigid in their structure and behavior. To address this, I decided to create a library for translating value pairs into relative shapes or positions, focusing on simplicity.
Key Features
- Variety of chart types: Frappe Charts supports various chart types, including Axis Charts, Area and Trends, Bar, Line, Pie, Percentage, Mixed Axis, and Heatmap.
- Annotations and tooltips: Charts can be annotated with x and y markers, regions, and tooltips for enhanced data context and clarity.
- Dynamic data handling: Add, remove, or update individual data points in place, or refresh the entire dataset to reflect changes.
- Customizable configurations: Flexible options like colors, animations, and custom titles allow for a highly personalized chart experience.
Usage
sh
npm install frappe-charts
Import in your project:
js
import { Chart } from 'frappe-charts'
// or esm import
import { Chart } from 'frappe-charts/dist/frappe-charts.esm.js'
// import css
import 'frappe-charts/dist/frappe-charts.min.css'
Or directly include script in your HTML
html
js
const data = {
labels: ["12am-3am", "3am-6pm", "6am-9am", "9am-12am",
"12pm-3pm", "3pm-6pm", "6pm-9pm", "9am-12am"
],
datasets: [
{
name: "Some Data", chartType: "bar",
values: [25, 40, 30, 35, 8, 52, 17, -4]
},
{
name: "Another Set", chartType: "line",
values: [25, 50, -10, 15, 18, 32, 27, 14]
}
]
}
const chart = new frappe.Chart("chart", { // or a DOM element,
// new Chart() in case of ES6 module with above usage
title: "My Awesome Chart",
data: data,
type: 'axis-mixed', // or 'bar', 'line', 'scatter', 'pie', 'percentage'
height: 250,
colors: ['7cd6fd', '743ee2']
})
Contributing
1. Clone this repo.
2. cd into project directory
3. npm install
4. npm i npm-run-all -D (optional -- might be required for some developers)
5. npm run dev
Links
- Read the blogTop issues
#295100's of js errors - Error: <rect> attribute width: A negative value is not valid21 comments · 2020-06-22#289Charts example code does not work when added to a frappe page10 comments · 2020-06-10#195Hide axes lines and labels? Legends - enable and disable? Option to disable the dots(data points)? 10 comments · 2018-08-20#81Horizontal charts10 comments · 2017-11-23#220Need to accept empty data9 comments · 2019-04-08#211Development Roadmap?9 comments · 2018-12-27#294bars off the chart8 comments · 2020-06-18#86Y axis: define low and high point of data8 comments · 2017-11-29
Latest release
Frappe Charts v1.6.3 v1.6.3 2022-04-27Fixes: fix: rounding error in the y-axis when max less than 1 (https://github.com/frappe/charts/pull/352) fix: ignore local timezones when creating a heatmap (https://github.com/frappe/charts/pull/377)