Skip to main content

Documentation Index

Fetch the complete documentation index at: https://brandtnewlabs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

LiveChartSeries draws multiple line series that share an axis, time window, and crosshair. Pass a SharedValue<SeriesConfig[]>.
import { useSharedValue } from "react-native-reanimated";
import { LiveChartSeries, type SeriesConfig } from "react-native-livechart";

const series = useSharedValue<SeriesConfig[]>([
  { id: "btc", label: "BTC", color: "#f7931a", data: [], value: 0 },
  { id: "eth", label: "ETH", color: "#627eea", data: [], value: 0 },
]);

<LiveChartSeries series={series} legend dot />;
Update the series the same way you feed a single chart — append points in place with series.modify(...) (mutating each entry’s data array and value), or replace the whole array with series.set(...). Avoid series.value = ....

Series options

Each SeriesConfig supports:
FieldPurpose
idStable identifier (required)
dataLiveChartPoint[] history (required)
valueLatest live value for interpolation (required)
colorLine color (falls back to the built-in series palette)
labelLegend chip text
visibleShow/hide the series (default true)
style"solid" or "dashed" (with intervals)
strokeWidthPer-series width override
glowSoft glow behind the line
kind"outcome" (default) or "derived" (subdued/dashed chip)

Legend

The legend renders toggle chips by default. Configure it with the legend prop, and listen for taps with onSeriesToggle:
<LiveChartSeries
  series={series}
  legend={{ position: "top", compact: false }}
  onSeriesToggle={(id, visible) => {
    // Persist the toggle back onto the series shared value.
    series.set(series.get().map((s) => (s.id === id ? { ...s, visible } : s)));
  }}
/>

Per-series dots

The dot prop controls the live dots, their pulse, value lines, and inline labels:
<LiveChartSeries
  series={series}
  dot={{ radius: 3.5, pulse: true, valueLine: true, valueLabel: true }}
/>
See the full prop list in the LiveChartSeries reference.