Skip to main content
The Graphy SDK is a charting library for React, built on a grammar of graphics. You do not pick a chart from a fixed menu. You describe one from a few parts: which columns map to which aesthetics, what shapes to draw, and how values become positions and colors. The same parts combine into anything from a line chart to a polar racetrack.

One package

Start with @graphysdk/react. You describe a chart as a spec; GraphProvider compiles it with your data and GraphRenderer paints it. The same spec can be stored, reused with other data, or compiled outside React — see How a chart is built.

Anatomy of a spec

A spec is assembled from a few kinds of part, folded together with pipe:
Each part has its own page: Two more parts call things out: highlight(...) for highlights and annotation.* for annotations. The builders only assemble a plain JSON object. You can store a spec in a database and load it back to render, with no builder in sight. See Serializable spec.

Where to start

Quickstart

Install @graphysdk/react and render your first chart.

How a chart is built

The spec pipeline and the compile → render model.

Data structure

The data table and how mappings reference it.

Chart types

Recipes for line, bar, pie, scatter and more.