README.md

🍞📈 Spread your data on TOAST UI Chart. TOAST UI Chart is Beautiful Statistical Data Visualization library.

📦 Packages

The functionality of TOAST UI Chart is available when using the Plain JavaScript, React, Vue Component.

• toast-ui.chart - Plain JavaScript component implemented by NHN.
• toast-ui.vue-chart - Vue wrapper component implemented by NHN.
• toast-ui.react-chart - React wrapper component implemented by NHN.

📙 Documents

• Getting Started
• Tutorials
  • English
  • 한국어
• APIs
• v4.0 Migration Guide
  • English
  • 한국어

😍 Why TOAST UI Chart?

Simple, Easy to Use, And It's Beautiful!

TOAST UI Chart makes your data pop and presents it in a manner that is easy to understand. Furthermore, it provides a wide range of theme options for customizing the charts to be suitable for all of your services. Chart components like the title, axes, legends, tooltips, plots, series, and more can be customized through the options.

Variety of powerful features!

Responsive

Add different options and animations according to the charts' sizes by using the responsive option.

Zoomable

Make the data presented in the Line, Area, and Treemap Charts zoomable with the zoomable option.

Live Update

View and manage new data as they are added realtime with the addData API and the options.series.shift option.

Area	Line	Heatmap

LineArea	Column	ColumnLine

Synchronize Tooltip

Use and synchronize the tooltip features at the moment the cursor hovers over the chart with the showTooltip API and the on custom event.

🎨 Features

Charts

The TOAST UI Chart provides many types of charts to visualize the various forms of data.

Area	Line	Bar	Column

Bullet	BoxPlot	Treemap	Heatmap

Scatter	Bubble	Radar	Pie

LineArea	LineScatter	ColumnLine	NestedPie

RadialBar	Gauge

• Stack Options(Explained in each chart guide)
• Diverging Options(Explained in each chart guide)
• Change Event Detect Type(Explained in each chart guide)
• Custom Theme
• Custom Tooltip
• Export xls, csv, png, jpeg file
• Live Update
• Responsive Layout

In addition, a variety of powerful features can be found on the demo page below. 👇👇👇

🐾 Examples

• Line Chart
• Area Chart
• LineArea Chart
• Bar Chart
• Column Chart
• ColumnLine Chart
• Bullet Chart
• BoxPlot Chart
• Treemap Chart
• Heatmap Chart
• Scatter Chart
• LineScatter Chart
• Bubble Chart
• Pie Chart
• NestedPie Chart
• Radar Chart
• RadialBar Chart
• Gauge Chart

Here are more examples and play with TOAST UI Chart!

🔧 Pull Request Steps

TOAST UI products are open source, so you can create a pull request(PR) after you fix issues. Run npm scripts and develop yourself with the following process.

Setup

Fork main branch into your personal repository. Clone it to local computer. Install node modules. Before starting development, you should check to have any errors.

$ git clone https://github.com/{your-personal-repo}/tui.chart.git
$ npm install
$ cd apps/chart
$ npm install
$ npm run test

Develop

Let's start development! You can develop UI through webpack-dev-server or storybook, and you can write tests through Jest. Don't miss adding test cases and then make green rights.

Run webpack-dev-server

$ npm run serve

Run storybook

$ npm run storybook

Run test

$ npm run test

Pull Request

Before uploading your PR, run test one last time to check if there are any errors. If it has no errors, commit and then push it!

For more information on PR's steps, please see links in the Contributing section.

💬 Contributing

• Code of Conduct
• Contributing guideline
• Issue guideline
• Commit convention

🌏 Browser Support

Chrome	Internet Explorer	Edge	Safari	Firefox
Yes	10+	Yes	Yes	Yes

🍞 TOAST UI Family

• TOAST UI Editor
• TOAST UI Grid
• TOAST UI Calendar
• TOAST UI Image-Editor
• TOAST UI Components

🚀 Used By

• NHN Cloud - Total Cloud Service
• NHN - ToastCam
• NHN Dooray! - Collaboration Service (Project, Messenger, Mail, Calendar, Drive, Wiki, Contacts)
• NHN - Smart Downloader
• NHN - Gamebase
• NHN Edu - iamTeacher
• HANGAME
• Payco

📜 License

This software is licensed under the MIT © NHN.