Chart

Installation

Install the component via the CLI in one command.

npx shadcn@latest add @intentui/chart

Manual installation

Use this approach if you prefer to install and wire up the component yourself instead of using the CLI.

npm install recharts tailwind-merge

Hooks

For responsive charts, you can use this hook (hooks/use-mobile.ts):

import { useEffect, useState } from "react"

const MOBILE_BREAKPOINT = 768
export function useIsMobile() {
  const [isMobile, setIsMobile] = useState<boolean | undefined>(undefined)

  useEffect(() => {
    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`)
    const onChange = () => {
      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
    }
    mql.addEventListener("change", onChange)
    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT)
    return () => mql.removeEventListener("change", onChange)
  }, [])

  return !!isMobile
}

Examples

Area

Area charts are great for showing trends, comparisons, and patterns over time. They keep your data clean and easy to read.

Loading...

Bar

Bar charts help visualize data comparisons across categories. They are effective for highlighting differences and trends using vertical or horizontal bars.

Loading...

Pie

Pie charts are useful for showing how parts contribute to a whole. They are best for displaying proportions and percentages in a visually appealing way.

Loading...

Container height

When using charts, whether area, bar, or pie, you can control the container height to match your layout. Setting an explicit height ensures the chart renders correctly. If you want different heights for desktop and mobile, you can use the useIsMobile hook:

export default function App() {
  const isMobile = useIsMobile();

  return (
    <AreaChart
      containerHeight={isMobile ? 200 : 300}
      ...

If you do not set a height, the chart defaults to 370 on desktop and 200 on mobile.

Component API

CartesianGrid

CartesianGrid extends the Recharts <CartesianGrid> component.

classNamestring

Chart

Chart extends the native <div> element.

childrenReactElement | ((props: ChartContextProps) => ReactElement)
classNamestring
configChartConfig
containerHeightnumber
Default: 370 desktop / 200 mobile
dataRecord<string, any>[]
Default: []
dataKeystring
Default: value
idstring
Default: generated
layoutChartLayout
Default: horizontal

ChartLegendContent

ChartLegendContent extends the React Aria Components <ToggleButtonGroup> component.

alignLegendProps["align"]
Default: right
classNamestring
hideIconboolean
Default: false
nameKeystring
payloadReadonlyArray<LegendPayload>
verticalAlignLegendProps["verticalAlign"]
Default: bottom

ChartLegend

ChartLegend extends the Recharts <Legend> component.

ChartTooltip

ChartTooltip extends the Recharts <Tooltip> component.

ChartTooltipContent

ChartTooltipContent extends the native <div> element.

classNamestring
colorstring
formatterTooltipContentProps["formatter"]
hideIndicatorboolean
Default: false
hideLabelboolean
Default: false
indicator"line" | "dot" | "dashed"
Default: dot
labelClassNamestring
labelFormatterTooltipContentProps["labelFormatter"]
labelKeystring
labelSeparatorboolean
Default: true
nameKeystring

XAxis

XAxis extends the Recharts <XAxis> component.

classNamestring
displayEdgeLabelsOnlyboolean
intervalTypeIntervalType
Default: preserveStartEnd
minTickGapnumber
Default: 5

YAxis

YAxis extends the Recharts <YAxis> component.

classNamestring
domainYAxisPrimitiveProps["domain"]
Default: ["auto", "auto"]
typeYAxisPrimitiveProps["type"]
Default: layout-based
widthnumber
Default: layout-based

See the Recharts for the full API reference.

Design