discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

FormidableLabs/victory · source

Snapshot 0 · 2026-11-04T12:47:23Z · TypeScript ·

GitHub description at capture

A collection of composable React components for building interactive data visualizations

README at capture

<div align="center">
  <a href="https://commerce.nearform.com/open-source/" target="_blank">
    <img alt="Victory — Formidable, We build the modern web" src="https://oss.nearform.com/api/banner.svg?badge=victory&bg=9c2f1e" />
  </a>

  <strong>
    an ecosystem of composable React components for building interactive data visualizations.
  </strong>

  <br />
  <br />

  <a href="https://npmjs.com/package/victory">
    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/victory.svg">
  </a>
  <a href="https://npmjs.com/package/victory">
    <img alt="current version" src="https://img.shields.io/npm/v/victory.svg">
  </a>
  <a href="https://github.com/FormidableLabs/victory/actions">
    <img alt="build status" src="https://github.com/FormidableLabs/victory/actions/workflows/ci.yml/badge.svg">
  </a>

  <a href="https://github.com/FormidableLabs/victory#maintenance-status">
    <img alt="Maintenance Status" src="https://img.shields.io/badge/maintenance-active-green.svg" />
  </a>

  <br />
  <br />
</div>

# `Victory`

## Contents

- [Getting Started](#getting-started)
- [Victory Native](#victory-native)
- [API Documentation](http://commerce.nearform.com/open-source/victory/docs)
- [Guides](http://commerce.nearform.com/open-source/victory/guides)
- [Contributing](#contributing)

* See the **docs and examples** on the website: https://commerce.nearform.com/open-source/victory
* **Experiment** with all Victory components in this [code sandbox](https://codesandbox.io/s/dj4f7t)

## Getting started

1. Add Victory to your project:

```sh
# npm
$ npm i --save victory
# or yarn
$ yarn add victory
```

2. Add your first Victory component:

```js
import React from "react";
import { render } from "react-dom";
import { VictoryPie } from "victory";

const PieChart = () => {
  return <VictoryPie />;
};

render(<PieChart />, document.getElementById("app"));
```

3. `VictoryPie` component will be rendered, and you should see:

<p align="center">
  <img align="center" width="471" alt="pie" src="https://cloud.githubusercontent.com/assets/3719995/20915779/b51e3652-bb3c-11e6-8243-6e7521a59115.png">
</p>

<br />

## Requirements

Projects using Victory should also depend on [React][]. As of `victory@38.0.0` Victory requires React `18.0.0` or above. For React 16 or 17, use Victory 37.

## Victory Native

Want to use Victory with React Native? Check out [Victory Native XL](https://github.com/FormidableLabs/victory-native-xl), our rewrite of Victory Native designed specifically for React Native (`victory-native@latest`).

The legacy `victory-native` package is no longer developed in this repository. Its last release is still available on npm under the `legacy` tag. See the [available versions on npm](https://www.npmjs.com/package/victory-native?activeTab=versions).

## Contributing

Please see the [Contributing guide](CONTRIBUTING.md).

## Maintenance Status

**Active:** Formidable is actively working on this project, and we expect to continue to work for the foreseeable future. Bug reports, feature requests and pull requests are welcome.

[react]: https://facebook.github.io/react/