Redefined chart library built with React and D3
JavaScript Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Rocket.Chat Build Status Coverage Status npm version npm downloads MIT License


Recharts is a Redefined chart library built with React and D3.

The main purpose of this library is to help you to write charts in React applications without any pain. Main principles of Recharts are:

  1. Simply deploy with React components
  2. Native SVG support, lightweight depending only on some D3 submodules
  3. Declarative components, components of charts are purely presentational


  margin={{ top: 5, right: 20, left: 10, bottom: 5 }}
  <XAxis dataKey="name" />
  <Tooltip />
  <CartesianGrid stroke="#f5f5f5" />
  <Line type="monotone" dataKey="uv" stroke="#ff7300" yAxisId={0} />
  <Line type="monotone" dataKey="pv" stroke="#387908" yAxisId={1} />

All the components of Recharts are clearly separated. The lineChart is composed of x axis, tooltip, grid, and line items, and each of them is an independent React Component. The clear separation and composition of components is one of the principle Recharts follows.



NPM is the easiest and fastest way to get started using Recharts. It is also the recommended installation method when building single-page applications (SPAs). It pairs nicely with a CommonJS module bundler such as Webpack.

# latest stable
$ npm install recharts


The UMD build is also available on

 <script src=""></script>

Then you can find the library on window.Recharts.

dev build

$ git clone
$ cd recharts
$ npm install
$ npm run build


To examine the demos in your local build, execute

$ npm run[-script] demo

and then browse to http://localhost:3000

Module Formats


We'd love ❤️ to hear what you think we should build. Please create an issue to write your usage or ideas.

We are looking for like-minded people who share the same idea about Recharts. The goal of this project is create a more flexible charting library for the React community.



Copyright (c) 2015-2017 Recharts Group