Radial Chart

A radial chart for gauge, progress ring, and circular data visualizations with customizable arcs and labels.

Usage

Energy Activity

Calories1,623/2,000 kcal
Steps8,328/10,000 steps
Exercise25/120 min
Calories700 kcal
"use client";

import type { ReactNode } from "react";

import { RadialChart } from "@thenamespace/uikit";

Anatomy

Import the RadialChart component and access all parts using dot notation.

import { RadialChart } from "@thenamespace/uikit";

<RadialChart>
  <RadialChart.AngleAxis />
  <RadialChart.Bar>
    <RadialChart.Cell />
  </RadialChart.Bar>
  <RadialChart.Tooltip />
</RadialChart>;

Gauge

Activity

Active Users1,358
"use client";

import type { ReactNode } from "react";

import { RadialChart } from "@thenamespace/uikit";

Gauge Grid

Conversion

75%

Engagement

75%

Bounce Rate

35%

Errors

90%
"use client";

import type { ReactNode } from "react";

import { RadialChart } from "@thenamespace/uikit";

Progress Ring

Daily Steps

75%7,452 / 10,000
"use client";

import type { ReactNode } from "react";

import { RadialChart } from "@thenamespace/uikit";

With Legend

Storage Breakdown

88 GB of 128 GB used

88GB used
Documents42 GB
Media28 GB
System18 GB
"use client";

import type { ReactNode } from "react";

import { RadialChart } from "@thenamespace/uikit";

CSS Classes

Element Classes

  • .radial-chart — Root container wrapping ResponsiveContainer and the Recharts chart.

Recharts Theming

The following CSS rules target Recharts internal class names to apply Namespace UIKit design tokens automatically:

  • .radial-chart .recharts-tooltip-cursor — Tooltip cursor. Hidden for radial charts.
  • .radial-chart .recharts-tooltip-wrapper — Tooltip wrapper. Elevated z-index to render above center content.
  • .radial-chart .recharts-radial-bar-background-sector — Bar background track. Uses the separator token for a subtle fill.

API Reference

RadialChart

The root wrapper. Renders a ResponsiveContainer + Recharts RadialBarChart with Namespace UIKit CSS theming applied automatically.

PropTypeDefaultDescription
dataRecord<string, number | string>[]Chart data — array of objects. Each entry becomes a concentric ring.
heightnumber300Chart height in pixels.
widthnumber | `${number}%` "100%"Chart width in pixels or percentage string.
barSizenumber10Bar thickness in pixels.
innerRadiusnumber | string"30%"Inner radius of the bar area.
outerRadiusnumber | string"80%"Outer radius of the bar area.
startAnglenumber90Start angle in degrees.
endAnglenumber-270End angle in degrees.
childrenReactNodeRecharts child components (RadialChart.Bar, RadialChart.Cell, etc.).

Also supports all native div HTML attributes.

RadialChart.Bar

Re-exported Recharts RadialBar component. Follows the Recharts RadialBar API.

RadialChart.Cell

Re-exported Recharts Cell component. Follows the Recharts Cell API.

RadialChart.AngleAxis

Re-exported Recharts PolarAngleAxis component. Follows the Recharts PolarAngleAxis API.

RadialChart.Tooltip

Re-exported Recharts Tooltip component. Follows the Recharts Tooltip API. Use with RadialChart.TooltipContent for styled tooltips.

RadialChart.TooltipContent

Pre-built tooltip renderer for Recharts. Pass as the content prop of RadialChart.Tooltip. See ChartTooltip for full props.