| 1 | # Chart.js
|
| 2 |
|
| 3 | [](https://travis-ci.org/chartjs/Chart.js) [](https://codeclimate.com/github/chartjs/Chart.js) [](https://coveralls.io/github/chartjs/Chart.js?branch=master) [](https://chart-js-automation.herokuapp.com/)
|
| 4 |
|
| 5 | *Simple HTML5 Charts using the canvas element* [chartjs.org](http://www.chartjs.org)
|
| 6 |
|
| 7 | ## Installation
|
| 8 |
|
| 9 | You can download the latest version of Chart.js from the [GitHub releases](https://github.com/chartjs/Chart.js/releases/latest) or use a [Chart.js CDN](https://cdnjs.com/libraries/Chart.js).
|
| 10 |
|
| 11 | To install via npm:
|
| 12 |
|
| 13 | ```bash
|
| 14 | npm install chart.js --save
|
| 15 | ```
|
| 16 |
|
| 17 | To install via bower:
|
| 18 | ```bash
|
| 19 | bower install chart.js --save
|
| 20 | ```
|
| 21 |
|
| 22 | #### Selecting the Correct Build
|
| 23 |
|
| 24 | Chart.js provides two different builds that are available for your use. The `Chart.js` and `Chart.min.js` files include Chart.js and the accompanying color parsing library. If this version is used and you require the use of the time axis, [Moment.js](http://momentjs.com/) will need to be included before Chart.js.
|
| 25 |
|
| 26 | The `Chart.bundle.js` and `Chart.bundle.min.js` builds include Moment.js in a single file. This version should be used if you require time axes and want a single file to include, select this version. Do not use this build if your application already includes Moment.js. If you do, Moment.js will be included twice, increasing the page load time and potentially introducing version issues.
|
| 27 |
|
| 28 | ## Documentation
|
| 29 |
|
| 30 | You can find documentation at [www.chartjs.org/docs](http://www.chartjs.org/docs). The markdown files that build the site are available under `/docs`. Previous version documentation is available at [www.chartjs.org/docs/latest/developers/#previous-versions](http://www.chartjs.org/docs/latest/developers/#previous-versions).
|
| 31 |
|
| 32 | ## Contributing
|
| 33 |
|
| 34 | Before submitting an issue or a pull request, please take a moment to look over the [contributing guidelines](https://github.com/chartjs/Chart.js/blob/master/docs/developers/contributing.md) first. For support using Chart.js, please post questions with the [`chartjs` tag on Stack Overflow](http://stackoverflow.com/questions/tagged/chartjs).
|
| 35 |
|
| 36 | ## Building
|
| 37 | Instructions on building and testing Chart.js can be found in [the documentation](https://github.com/chartjs/Chart.js/blob/master/docs/developers/contributing.md#building-and-testing).
|
| 38 |
|
| 39 | ## Thanks
|
| 40 | - [BrowserStack](https://browserstack.com) for allowing our team to test on thousands of browsers.
|
| 41 | - [@n8agrin](https://twitter.com/n8agrin) for the Twitter handle donation.
|
| 42 |
|
| 43 | ## License
|
| 44 |
|
| 45 | Chart.js is available under the [MIT license](http://opensource.org/licenses/MIT).
|