Reactochart

Overview


Reactochart is a library of React components for creating data visualization charts and graphs. Components include line chart, bar chart, area chart, heat maps, scatterplot, histogram, pie chart, sankey diagram, and tree map.

Getting started

1. Install reactochart using npm.

``
npm i reactochart --save
`

2. Then you can import an individual Reactochart component:

`jsx
import LineChart from 'reactochart/LineChart';
`

3. If you prefer, you can import all of Reactochart at once, though this may hinder some optimizations, such as webpack tree-shaking:

`jsx
import { XYPlot, XAxis, YAxis, LineChart } from 'reactochart';
`

or

`jsx
import * as Reactochart from 'reactochart';
`

4. Import reactochart's base styles

`jsx
import 'reactochart/styles.css';
`

5. Build your first chart and see it rendered! For example, the following code snippet:

`jsx
import XYPlot from 'reactochart/XYPlot';
import XAxis from 'reactochart/XAxis';
import YAxis from 'reactochart/YAxis';
import LineChart from 'reactochart/LineChart';
import 'reactochart/styles.css';

const MyFirstLineChart = props => (



data={Array(100)
.fill()
.map((e, i) => i + 1)}
x={d => d}
y={d => Math.sin(d * 0.1)}
/>

);
`

results in this:

Live Examples

The examples contain more details about each component and the prop-types it accepts. To run the examples locally and play with the different types of charts in a live code editor:

1. Clone this repo and cd to the newly-created directory
2. Run npm run serve in your terminal (note: if you're running Python in v3 or higher you'll need to run python -m http.server)
3. Go to http://localhost:8000

Reactochart Components

Chart Foundations

$3

- XYPlot

$3

- XAxis, YAxis
- XAxisTitle, YAxisTitle
- XAxisLabels, YAxisLabels
- XTicks, YTicks
- XGrid, YGrid

Chart Types

$3

- PieChart
- TreeMap
- SankeyDiagram

$3

- AreaBarChart
- AreaChart
- AreaHeatmap
- BarChart
- ColorHeatmap
- FunnelChart
- Histogram
- LineChart
- MarkerLineChart
- RangeBarChart
- ScatterPlot

$3

- Bar
- RangeRect
- XLine, YLine

$3

- ZoomContainer

Development

If you'd like to contribute to the development this project, first fork & clone this repo, and then follow these steps:

$3

- This project uses NPM to manage dependencies and run scripts. Run npm -v to check if you already have it installed.
If you don't have it, NPM is packaged with Node.js - download and run the
install package located on nodejs.org to install.
- Babel is used to transpile ES6+ code to ES5 syntax. Install by running npm install --global babel
- Webpack is used to bundle the JS & styles for the examples. Install by running npm install --global webpack

$3

- Run npm install in the project root directory. This will install all of the project dependencies into the
node_modules directory.

$3

- Run npm run dev to run the development server (webpack-dev-server), which will serve a live development version of the examples at localhost:9876.
- Make changes to the library code in the src directory, and/or changes to the examples in the examples/src directory.
- If you'd like to make changes or add further component documentation, follow the example on react-docgen.
- Once you're happy with your library and/or documentation changes, run npm run docs. This allows the documentation build to run with your updated src code. git add and git commit the updated build.
- git push to your forked version of the repo.
- Open a Github pull request with your changes against master. 🎉

$3

If you have an app that depends on reactochart and you want to develop locally, follow the following steps:

1. In the folder for this repo, run npm build and then npm link
2. In your app folder, run npm link reactochart. If you're using webpack, then you also may need the following config:

`json
{
"resolve": {
"symlinks": true,
"alias": {
"react": path.resolve("./node_modules/react"),
"react-dom": path.resolve("./node_modules/react-dom")
}
}
}
`

$3

- Do not make any changes in the lib or examples/build` directories, as these directories are destroyed and
regenerated on each build.
- The development server uses react-hot-loader to automatically
"hot reload" changes to React components, so refreshing your web browser is not necessary.

Code of Conduct

This project adheres to the [Open Code of Conduct][code-of-conduct]. By participating, you are expected to honor this code.

[code-of-conduct]: https://github.com/spotify/code-of-conduct/blob/master/code-of-conduct.md