# recharts

> React charts

Latest version **3.10.1** (published 2026-07-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install recharts
pnpm add recharts
yarn add recharts
bun add recharts
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.10.1 |
| Published | 2026-07-25 |
| First published | 2015-08-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18 |
| Dependencies | 11 |
| Unpacked size | 7.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 27556 |
| Author | recharts group |
| Maintainers | nikolasrieble, ckifer, corkscreewe |
| Keywords | react, reactjs, chart, react-component |

## Links

- npm: https://www.npmjs.com/package/recharts
- Repository: https://github.com/recharts/recharts
- Issues: https://github.com/recharts/recharts/issues
- npm.io page: https://npm.io/package/recharts

## Dependencies (11)

- [clsx](https://npm.io/package/clsx.md) ^2.1.1
- [immer](https://npm.io/package/immer.md) ^11.1.8
- [reselect](https://npm.io/package/reselect.md) 5.2.0
- [es-toolkit](https://npm.io/package/es-toolkit.md) ^1.39.3
- [react-redux](https://npm.io/package/react-redux.md) 8.x.x || 9.x.x
- [eventemitter3](https://npm.io/package/eventemitter3.md) ^5.0.1
- [tiny-invariant](https://npm.io/package/tiny-invariant.md) ^1.3.3
- [victory-vendor](https://npm.io/package/victory-vendor.md) ^37.0.2
- [@reduxjs/toolkit](https://npm.io/package/@reduxjs/toolkit.md) ^1.9.0 || 2.x.x
- [decimal.js-light](https://npm.io/package/decimal.js-light.md) ^2.5.1
- [use-sync-external-store](https://npm.io/package/use-sync-external-store.md) ^1.2.2

## Alternatives

- [d3-force-3d](https://npm.io/package/d3-force-3d.md) — 1.0M weekly downloads
- [ng2-charts](https://npm.io/package/ng2-charts.md) — 486.8K weekly downloads
- [@arcgis/core](https://npm.io/package/@arcgis/core.md) — 257.8K weekly downloads
- [react-sparklines](https://npm.io/package/react-sparklines.md) — 249.3K weekly downloads
- [react-native-gifted-charts](https://npm.io/package/react-native-gifted-charts.md) — 182.3K weekly downloads

## Recent versions

- 3.10.1 (latest) — 2026-07-25
- 3.11.0-canary.3 (canary) — 2026-09-09
- 3.0.0-beta.2 (beta) — 2025-06-18
- 3.0.0-alpha.9 (alpha) — 2025-03-16
- 3.11.0-canary.2 — 2026-09-08
- 3.11.0-canary.1 — 2026-09-08
- 3.11.0-canary.0 — 2026-08-23
- 3.10.0 — 2026-07-20
- 3.9.2 — 2026-07-04
- 3.9.1 — 2026-06-30
- 3.9.0 — 2026-06-23
- 3.9.0-canary.0 — 2026-06-07
- 3.8.1 — 2026-03-25
- 3.8.0 — 2026-03-06
- 3.7.0 — 2026-01-21
- … 277 more at https://npm.io/package/recharts/versions

## README

# Recharts

[![storybook](https://raw.githubusercontent.com/storybooks/brand/master/badge/badge-storybook.svg)](https://recharts.github.io/en-US/storybook)
[![Build Status](https://github.com/recharts/recharts/workflows/Node.js%20CI/badge.svg)](https://github.com/recharts/recharts/actions)
[![codecov](https://codecov.io/gh/recharts/recharts/graph/badge.svg?token=Bn6L2hrl8T)](https://codecov.io/gh/recharts/recharts)
[![npm version](https://badge.fury.io/js/recharts.svg)](http://badge.fury.io/js/recharts)
[![npm downloads](https://img.shields.io/npm/dm/recharts.svg?style=flat-square)](https://www.npmjs.com/package/recharts)
[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](/LICENSE)

## Introduction

Recharts is a **Redefined** chart library built with [React](https://facebook.github.io/react/) and [D3](http://d3js.org).

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 at [recharts.github.io](https://recharts.github.io) and our [storybook](https://recharts.github.io/en-US/storybook)

Also see [the wiki](https://github.com/recharts/recharts/wiki).

All development is done on the `main` branch. The current latest release and storybook documentation reflects what is on the `release` branch.

## Examples

```jsx
<LineChart width={400} height={400} data={data}>
  <XAxis dataKey="name" />
  <Tooltip />
  <CartesianGrid stroke="#f5f5f5" />
  <Line type="monotone" dataKey="uv" stroke="#ff7300" />
  <Line type="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.

## Installation

### npm

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.

```sh
# latest stable
$ npm install recharts react-is
```

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

### Deno

Deno is a drop-in replacement for npm, so Recharts installs the same way:

```sh
$ deno add recharts react-is
```

### umd

The UMD build is also available on unpkg.com:

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

Then you can find the library on `window.Recharts`.

## Contributing

Recharts is open source. If you want to contribute to the project, please read the [CONTRIBUTING.md](/CONTRIBUTING.md)
to understand how to contribute to the project and [DEVELOPING.md](/DEVELOPING.md) to set up your development
environment.

## Thanks

<a href="https://www.chromatic.com/"><img src="https://user-images.githubusercontent.com/321738/84662277-e3db4f80-af1b-11ea-88f5-91d67a5e59f6.png" width="153" height="30" alt="Chromatic" /></a>

Thanks to [Chromatic](https://www.chromatic.com/) for providing the visual testing platform that helps us review UI changes and catch visual regressions.

[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSourceSupport)

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

Browser testing via

[![TestMu AI](www/public/assets/testmu-logo-black.svg)](https://www.testmuai.com/?utm_medium=sponsor&utm_source=recharts)

## License

[MIT](http://opensource.org/licenses/MIT)

Copyright (c) 2015-2026 Recharts Group.

---
_Source: https://npm.io/package/recharts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
