All charts

Free · Recharts · Editable React source

Pie Foundation

A flexible Recharts pie and donut base with selectable segments and custom palettes.

Switch to ECharts

This is the installable component, not a mockup. Width is a preview container setting; theme and colors use your app’s shadcn CSS variables.

Select a mark or an accessible data-table value to inspect the callback.

Waiting for an interaction…
Edit sample data · JSON

01 / Installation

Your code. Your project.

Use an initialized shadcn/Tailwind React project. The URL installs the component and its shared files recursively. No namespace configuration, platform account, or agent files.

Next.js, Vite & manual setup →
npx shadcn@latest add https://beautifulcharts.dev/r/recharts-pie-foundation.json

Package dependencies: recharts. Shared files are included in Source above. The installed license file covers the free source.

For a manual install, add those packages, copy every listed Source file to its displayed path, and adjust the @/ alias if your project uses a different one.

02 / Component API

Make it yours.

Types, defaults, and source below are generated from the distributed component. Numeric values must be finite; recipe-specific bounds are checked in source. Formatters change displayed labels, not the underlying measurements.

Pie Foundation props
PropTypeDefaultRequired
dataPieChartDatum[]sampleDataNo
nameKeystring"channel"No
valueKeystring"share"No
titlestring"Pie foundation"No
subtitlestring"Show a concise part-to-whole relationship"No
innerRadiusnumber | string"54%"No
palettestring[]defaultPaletteNo
onSelect(datum: PieChartDatum, index: number) => void—No
showTooltipbooleantrueNo
valueFormatter(value: unknown) => string—No
ariaDescriptionstring—No
childrenReactNode—No
isLoadingboolean—No
classNamestring—No
Exact data and series types
export type PieChartDatum = Record<string, string | number>;

export type PieFoundationProps = {
  data?: PieChartDatum[]; nameKey?: string; valueKey?: string; title?: string; subtitle?: string;
  innerRadius?: number | string; palette?: string[]; onSelect?: (datum: PieChartDatum, index: number) => void; showTooltip?: boolean; valueFormatter?: (value: unknown) => string; ariaDescription?: string; children?: ReactNode; isLoading?: boolean; className?: string;
};

shadcn theming

Your card, text, border, error, font, and chart colors—not a forced design system.

Native customization

Modify the local source or use the documented renderer-native extension points.

Accessible states

Loading, empty states, reduced motion, descriptions, and inspectable data tables.