RadarChart

RadarChart is built on top of victory-native, reusing its PolarChart for canvas + measurement and useAnimatedPath for polygon interpolation. victory-native does not ship a radar primitive — every visual part (grid rings, spokes, axis labels, radar polygon, vertex dots) is rendered with @shopify/react-native-skia Path, Circle, and Text. For full context on chart props and rendering internals, read the victory-native docs alongside this page.

Import

import { RadarChart } from 'heroui-native-pro';

Anatomy

<RadarChart data={...} labelKey="..." dataKey="...">
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.RadiusAxis />
  <RadarChart.Radar />
</RadarChart>

• RadarChart: Root container that wraps victory-native PolarChart in a themed outer View. Publishes data, labelKey, dataKey, maxValue, and the measured canvas size to compound subcomponents through an internal layout context that crosses the Skia reconciler via useContextBridge.
• RadarChart.Grid: Concentric rings (polygons by default) plus one radial spoke per category. Renders nothing until the canvas has been measured.
• RadarChart.AngleAxis: Category labels rendered around the chart perimeter, one per row, using data[i][labelKey]. Skia text via the default system font (matchFont).
• RadarChart.RadiusAxis: Numeric tick labels rendered along a single spoke (defaults to 12 o'clock). One label per grid ring, optionally including a 0 label at the chart center. Each tick rotates with the spoke so labels always read along its direction.
• RadarChart.Radar: Filled, stroked polygon for a single series. Render multiple siblings (each with its own dataKey) for a multi-series radar. Supports victory-native's animate config for smooth path interpolation when the underlying data changes.

Usage

Basic usage

Provide data, labelKey, and dataKey. The default RadarChart.Radar reads the root's dataKey and uses the theme chart-3 color. Height is supplied through wrapperClassName.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  wrapperClassName="h-[280px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.Radar />
</RadarChart>

Multi-series

Render multiple RadarChart.Radar siblings with distinct dataKey overrides to overlay several numeric fields on the same set of categories.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="teamA"
  wrapperClassName="h-[300px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.Radar dataKey="teamA" color="#8b5cf6" />
  <RadarChart.Radar dataKey="teamB" color="#6366f1" />
</RadarChart>

Dots only

Set fillOpacity={0} and showDots to emphasize each vertex as a discrete marker rather than reading the chart as filled areas.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  wrapperClassName="h-[280px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.Radar
    color="#8b5cf6"
    fillOpacity={0}
    strokeWidth={2}
    showDots
    dotRadius={4}
  />
</RadarChart>

Circle grid

Pass shape="circle" to RadarChart.Grid to draw perfectly round rings instead of regular polygons — useful when the chart reads as a continuous radial gauge rather than a categorical comparison.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  wrapperClassName="h-[280px]"
>
  <RadarChart.Grid shape="circle" />
  <RadarChart.AngleAxis />
  <RadarChart.Radar />
</RadarChart>

With radius axis

Render RadarChart.RadiusAxis to label each ring with a numeric tick. Pass tickFormatter to format values (units, rounding) and includeZero to render the origin tick at the chart center.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  maxValue={100}
  wrapperClassName="h-[300px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.RadiusAxis
    includeZero
    tickFormatter={(value) => `${Math.round(value)}%`}
  />
  <RadarChart.Radar />
</RadarChart>

Fixed scale

Pass maxValue on the root to fix the radial scale across all series. This keeps multi-series radars on a shared scale and the chart stable when underlying values change. Without it each series re-normalizes to the local data max.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  maxValue={100}
  wrapperClassName="h-[280px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.Radar />
</RadarChart>

Custom radius-axis spoke

Move RadarChart.RadiusAxis to a different spoke with angle (degrees, clockwise from 12 o'clock) and pick a horizontal alignment relative to that spoke with orientation. Labels rotate with the spoke so they always read along its direction.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  maxValue={100}
  wrapperClassName="h-[300px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.RadiusAxis angle={90} orientation="middle" />
  <RadarChart.Radar />
</RadarChart>

Custom axis font

Pass an SkFont built with useFont to either axis to override the default matchFont system font.

import { useFont } from '@shopify/react-native-skia';
import InterMedium from './assets/fonts/Inter-Medium.ttf';

function MyChart() {
  const font = useFont(InterMedium, 12);

  return (
    <RadarChart
      data={DATA}
      labelKey="category"
      dataKey="score"
      wrapperClassName="h-[280px]"
    >
      <RadarChart.Grid />
      <RadarChart.AngleAxis font={font} />
      <RadarChart.Radar />
    </RadarChart>
  );
}

Animate data transitions

Pass an animate config to RadarChart.Radar to interpolate the Skia polygon path when the underlying data (or dataKey) changes. Useful for filter swaps, timeframe toggles, or preset switchers.

Skia can only interpolate paths with the same number of points. If the number of categories changes between renders, the path snaps instead of animating. Keep each dataset's category count consistent when driving animate from variable-length data.

<RadarChart
  data={DATA}
  labelKey="category"
  dataKey="score"
  maxValue={100}
  wrapperClassName="h-[280px]"
>
  <RadarChart.Grid />
  <RadarChart.AngleAxis />
  <RadarChart.Radar animate={{ type: 'spring' }} />
</RadarChart>

Example

import { Card } from 'heroui-native';
import { RadarChart } from 'heroui-native-pro';
import { View } from 'react-native';

type SkillRow = {
  category: string;
  score: number;
};

const SKILLS_DATA: SkillRow[] = [
  { category: 'Design', score: 86 },
  { category: 'Frontend', score: 92 },
  { category: 'Backend', score: 74 },
  { category: 'DevOps', score: 65 },
  { category: 'Testing', score: 78 },
  { category: 'Leadership', score: 70 },
];

export default function SkillAssessmentChart() {
  return (
    <View className="flex-1 w-full px-5 justify-center">
      <Card>
        <Card.Header className="mb-3">
          <Card.Title className="text-base">Skill Assessment</Card.Title>
        </Card.Header>
        <Card.Body className="items-center">
          <RadarChart
            data={SKILLS_DATA}
            labelKey="category"
            dataKey="score"
            maxValue={100}
            wrapperClassName="h-[280px]"
          >
            <RadarChart.Grid />
            <RadarChart.AngleAxis />
            <RadarChart.Radar
              color="#8b5cf6"
              fillOpacity={0.18}
              strokeWidth={2}
              showDots
              dotRadius={3}
              animate={{ type: 'spring', damping: 14, stiffness: 100 }}
            />
          </RadarChart>
        </Card.Body>
      </Card>
    </View>
  );
}

API Reference

RadarChart

RadarChartRootAnimation

Animation configuration for the root component. Can be:

• false or "disabled": Disable only root animations
• "disable-all": Disable all animations including animated compound parts
• true or undefined: Use default animations
• object: Custom animation configuration with a state field for the same disabling semantics

The root does not drive any of its own animated styles; its sole animation responsibility is cascading isAllAnimationsDisabled to compound parts that do animate (RadarChart.Radar).

RadarChart.Grid

RadarChartGridShape

Concentric grid shape.

RadarChart.AngleAxis

RadarChart.RadiusAxis

When the chart has multiple RadarChart.Radar siblings on different keys (or a single Radar whose dataKey differs from the root's), set maxValue on the root so the axis ticks remain truthful across every polygon. Auto-derived scales can only follow one key at a time — RadarChart.RadiusAxis defaults to the root's dataKey and accepts a dataKey override to point at a different series.

RadarChartRadiusAxisOrientation

Horizontal alignment of tick labels relative to the spoke they sit on.

RadarChart.Radar

RadarChartRadarAnimateConfig

Reanimated config carried via the animate prop. Mirrors victory-native's PathAnimationConfig — a discriminated union on type.

When the polygon's data changes, the new Skia path is interpolated from the previous frame's path according to this config. Dropped when the root cascade sets animation="disable-all".