121 lines
10 KiB
Markdown
121 lines
10 KiB
Markdown
|
|
|
|
[](https://pub.dartlang.org/packages/fl_chart)
|
|
[](https://codecov.io/gh/imaNNeo/fl_chart)
|
|
<a href="https://github.com/Solido/awesome-flutter#charts"><img src="https://img.shields.io/badge/awesome-flutter-blue.svg?longCache=true" alt="Awesome Flutter"></a>
|
|
<a href="https://pub.dev/packages/fl_chart"><img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/imaNNeo/fl_chart"></a>
|
|
<a href="https://github.com/imaNNeo/fl_chart/graphs/contributors"><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/imaNNeo/fl_chart"></a>
|
|
<a href="https://githubc.com/imaNNeo/fl_chart/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/imaNNeo/fl_chart" alt="GitHub closed issues"></a>
|
|
|
|
<span class="badge-buymeacoffee">
|
|
<a href="https://www.buymeacoffee.com/fl_chart" title="Donate to this project using Buy Me A Coffee"><img src="https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg" alt="Buy Me A Coffee donate button" /></a>
|
|
</span>
|
|
|
|
### Our Financial Heroes
|
|
Your financial support acts as fuel for fl_chart's development. [Support here](https://github.com/sponsors/imaNNeo).
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<a href="https://github.com/sponsors/imaNNeo">
|
|
<img src="https://github.com/imaNNeo/fl_chart_landing/blob/main/static/img/sponsors/intero-the-sniffers.png?raw=true">
|
|
</a>
|
|
</td>
|
|
<td>
|
|
<a href="https://github.com/sponsors/imaNNeo">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/imaNNeo/fl_chart/raw/main/repo_files/sponsors/become_a_sponsor_dark.png">
|
|
<source media="(prefers-color-scheme: light)" srcset="https://github.com/imaNNeo/fl_chart/raw/main/repo_files/sponsors/become_a_sponsor_light.png">
|
|
<img alt="Become a sponsor" >
|
|
</picture>
|
|
</a>
|
|
</td>
|
|
<td>
|
|
<a href="https://github.com/sponsors/imaNNeo">
|
|
<img src="https://github.com/imaNNeo/fl_chart/raw/main/repo_files/sponsors/become_a_hero_empty.png">
|
|
</a>
|
|
</td>
|
|
<td>
|
|
<a href="https://github.com/sponsors/imaNNeo">
|
|
<img src="https://github.com/imaNNeo/fl_chart/raw/main/repo_files/sponsors/become_a_hero_empty.png">
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
### Overview
|
|
FL Chart is a highly customizable Flutter chart library that supports **[Line Chart](https://app.flchart.dev/#/line)**, **[Bar Chart](https://app.flchart.dev/#/bar)**, **[Pie Chart](https://app.flchart.dev/#/pie)**, **[Scatter Chart](https://app.flchart.dev/#/scatter)**, and **[Radar Chart](https://app.flchart.dev/#/radar)**.
|
|
|
|
<a href="https://www.youtube.com/watch?v=hVRU-kpKNjQ&list=PL1-_rCwRcnbNpvodmbt43O81wMUdBv8-a"><img src="https://github.com/imaNNeo/fl_chart/raw/main/repo_files/images/overview_thumbnail.png"></p></a>
|
|
|
|
|
|
### Chart Types
|
|
|
|
|LineChart |BarChart |PieChart |
|
|
|:------------:|:------------:|:-------------:|
|
|
| [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/line_chart.md#sample-1-source-code) [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/line_chart.md#sample-2-source-code) | [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/bar_chart.md#sample-1-source-code) [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/bar_chart.md#sample-2-source-code) | [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/pie_chart.md#sample-1-source-code) [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/pie_chart.md#sample-2-source-code) |
|
|
|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/line_chart.md)|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/bar_chart.md)|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/pie_chart.md)|
|
|
|
|
|ScatterChart |RadarChart| CandlestickChart|
|
|
|:------------:|:------------:|:-------------:|
|
|
| [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/scatter_chart.md#sample-1-source-code) [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/scatter_chart.md#sample-2-source-code) |  | |
|
|
|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/scatter_chart.md)|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/radar_chart.md)|[Read More](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/candlestick_chart.md)|
|
|
|
|
Banner designed by [Soheil Saffar](https://www.linkedin.com/in/soheilsaffar), and
|
|
samples inspired from
|
|
[David Kovalev](https://dribbble.com/shots/5560237-Live-Graphs-XD),
|
|
[Ricardo Salazar](https://dribbble.com/shots/1956890-Data-Stats),
|
|
[Dmitro Petrenko](https://dribbble.com/shots/5425378-Mobile-Application-Dashboard-for-Stock-Platform),
|
|
[Ghani Pradita](https://dribbble.com/shots/6379476-Calories-Management-App),
|
|
[MONUiXD](https://www.uplabs.com/posts/chart-pie-chart-bar-chart).
|
|
Thank you all!
|
|
|
|
|
|
|
|
# Let's get started
|
|
|
|
First of all, you need to add the `fl_chart` in your project. In order to do that, follow [this guide](https://pub.dev/packages/fl_chart/install).
|
|
|
|
Then you need to read the docs. Start from [here](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/index.md).
|
|
|
|
We suggest you to check samples source code.
|
|
|
|
##### - You can read about the animation handling [here](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/handle_animations.md)
|
|
|Sample1 |Sample2 |Sample3 |
|
|
|:------------:|:------------:|:-------------:|
|
|
| [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/line_chart.md#sample-1-source-code) | [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/line_chart.md#sample-2-source-code) | [](https://github.com/imaNNeo/fl_chart/blob/main/repo_files/documentations/bar_chart.md#sample-1-source-code) |
|
|
|
|
### Try it out
|
|
You can try the FL Chart sample app on the platforms that are available below:
|
|
|
|
[](https://play.google.com/store/apps/details?id=dev.flchart.app)
|
|
[](https://apps.apple.com/us/app/fl-chart/id6476523019)
|
|
[](https://app.flchart.dev)
|
|
|
|
[//]: # ([](https://apps.apple.com/app/your-macos-app-id))
|
|
[//]: # ([](https://your-linux-distribution-link.com))
|
|
[//]: # ([](https://your-windows-app-link.com))
|
|
|
|
|
|
### Donation
|
|
Your donation **motivates** me to work more on the **fl_chart** and resolve more issues.
|
|
There are multiple ways to donate me:
|
|
|
|
1. You can be my sponsor on [GitHub](https://github.com/sponsors/imaNNeo) (This is the most reliable way to donate me)
|
|
2. You can <a href="https://www.buymeacoffee.com/fl_chart">buy me a coffee!</a>
|
|
3. Or if you are a fan of crypto, you can donate me Bitcoins here: `1L7ghKdcmgydmUJAnmYmMaiVjT1LoP4a45`
|
|
|
|
### Contributing
|
|
##### :beer: Pull requests are welcome!
|
|
Don't forget that `open-source` makes no sense without contributors. No matter how big your changes are, it helps us a lot even it is a line of change.
|
|
|
|
There might be a lot of grammar issues in the docs. It's a big help to us to fix them if you are fluent in English.
|
|
|
|
Check out [CONTRIBUTING.md](https://github.com/imaNNeo/fl_chart/blob/main/CONTRIBUTING.md), which contains a guide for those who want to contribute to the FL Chart.
|
|
|
|
Reporting bugs and issues are contribution too, yes it is.
|
|
|
|
#### Below are the people who has contributed to the FL Chart. We hope we have your picture here soon.
|
|
[](https://github.com/imaNNeo/fl_chart/graphs/contributors)
|