Skip to main content
The Graphy SDK is a charting library for React, built on a grammar of graphics. Rather than picking a chart from a fixed menu, you describe a chart by composing a handful of parts — which columns map to which aesthetics, what shapes to draw, and how values become positions and colors. The same parts recombine into everything from a line chart to a polar racetrack.

One package

Start with @graphysdk/react. You describe a chart as a spec, and the provider compiles and paints it. The same spec can be stored, reused with other data, or rendered 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 a page that explains it in depth: Two more kinds of part carry the storytelling layer: highlight(...) for highlights and annotation.* for annotations. The builders are convenience — what they produce is a plain, JSON-serializable object. You can store a spec in a database and load it back to render, no builder required. 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.