Repository files navigation

Recharts is aRedefined chart library built withReact andD3.

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 with minimal dependencies.
3. Declarative components.

Documentation atrecharts.org and ourstorybook

Also seethe wiki.

All development is done on themain branch. The current latest release and storybook documentation reflects what is on therelease branch.

<LineChartwidth={400}height={400}data={data}><XAxisdataKey="name"/><Tooltip/><CartesianGridstroke="#f5f5f5"/><Linetype="monotone"dataKey="uv"stroke="#ff7300"/><Linetype="monotone"dataKey="pv"stroke="#387908"/></LineChart>

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 react-is

react-is needs to match the version of your installedreact package.

The UMD build is also available on unpkg.com:

<scriptsrc="https://unpkg.com/react/umd/react.production.min.js"></script><scriptsrc="https://unpkg.com/react-dom/umd/react-dom.production.min.js"></script><scriptsrc="https://unpkg.com/react-is/umd/react-is.production.min.js"></script><scriptsrc="https://unpkg.com/recharts/umd/Recharts.min.js"></script>

Then you can find the library onwindow.Recharts.

Recharts is open source. If you want to contribute to the project, please read theCONTRIBUTING.mdto understand how to contribute to the project andDEVELOPING.md to set up your developmentenvironment.

Thanks toChromatic for providing the visual testing platform that helps us review UI changes and catch visual regressions.

Thanks to JetBrains for providing OSS development license for their IDEs.

MIT

Copyright (c) 2015-2024 Recharts Group.