# Beautiful Charts > React chart components and dashboard blocks for shadcn: 19 chart types and 27 blocks, installed as TypeScript source with the shadcn CLI, on Recharts or Apache ECharts. The Instrument theme is free and MIT. Riso and Clay are paid themes with the same props. Install any item with `npx shadcn@latest add `; the files land in your project and you own them. Data is plain rows; a missing value is `null` and stays a gap. ## Docs - [Introduction](https://beautifulcharts.dev/docs): What Beautiful Charts is, and every chart and block - [Installation](https://beautifulcharts.dev/docs/installation): The shadcn CLI in Next.js or Vite, the Pro registry, updating and troubleshooting - [Theming](https://beautifulcharts.dev/docs/theming): Colours, dark mode, your shadcn tokens, styling hooks and the three themes - [Motion](https://beautifulcharts.dev/docs/motion): How charts enter and respond, reduced motion, and optional sound - [AI and MCP](https://beautifulcharts.dev/docs/ai): The shadcn MCP server and the registry index ## Charts - [Line chart](https://beautifulcharts.dev/md/components/line-chart.md): Trends with honest gaps, forecast tails, references and a latest-value readout - [Area chart](https://beautifulcharts.dev/md/components/area-chart.md): Overlaid, stacked or 100% areas with gaps kept and forecast tails - [Composed chart](https://beautifulcharts.dev/md/components/composed-chart.md): Bars, lines and areas together, with a second value axis - [Spark chart](https://beautifulcharts.dev/md/components/spark-chart.md): A trend for a table cell or a KPI row: line, area or bar, with gaps kept and the latest value marked. Plain SVG: no chart engine - [Bar chart](https://beautifulcharts.dev/md/components/bar-chart.md): Grouped, stacked or 100%, vertical or horizontal, with a measured callout and a computed takeaway - [Radar chart](https://beautifulcharts.dev/md/components/radar-chart.md): Profiles across axes with per-axis ranges, honest gaps and an optional benchmark - [Scatter chart](https://beautifulcharts.dev/md/components/scatter-chart.md): Points by two numbers, bubbles sized by area, groups, log axes, quadrants and trend lines; rows it can't place are counted - [Bar list](https://beautifulcharts.dev/md/components/bar-list.md): Named values ranked largest first, each with a bar sized to the largest; a real list, with optional links. Plain HTML: no chart engine - [Donut chart](https://beautifulcharts.dev/md/components/donut-chart.md): Donut or pie with Other grouping, honest exclusions, labels inside or outside and a centre readout - [Radial chart](https://beautifulcharts.dev/md/components/radial-chart.md): Progress rings, full or half, with goals and honest overflow - [Waterfall chart](https://beautifulcharts.dev/md/components/waterfall-chart.md): Changes step from level to level, totals re-anchor, rises and falls coloured by meaning, and a stated total that disagrees with the sum is flagged - [Treemap](https://beautifulcharts.dev/md/components/treemap.md): Areas true to value, grouped one level, labels only where they fit; zero, negative and missing values are named instead of drawn - [Sankey chart](https://beautifulcharts.dev/md/components/sankey-chart.md): Flows with validation, disclosures and path tracing. Same props and layout on both engines - [Funnel chart](https://beautifulcharts.dev/md/components/funnel-chart.md): Steps in order with the rate from the previous or first step, drop bands, and missing or rising steps named - [Heatmap](https://beautifulcharts.dev/md/components/heatmap.md): A matrix or calendar heatmap with a stepped or diverging scale and empty outlines for missing cells. Plain SVG: no chart engine - [Tracker](https://beautifulcharts.dev/md/components/tracker.md): One block per period coloured by status, with the counts in words; missing periods are shown as missing. Plain HTML: no chart engine - [KPI stat](https://beautifulcharts.dev/md/components/kpi-stat.md): One number with its change in words, an optional target meter and sparkline. Plain SVG: no chart engine - [Gauge](https://beautifulcharts.dev/md/components/gauge.md): A meter with bands, a target and honest out-of-range handling. Plain SVG: no chart engine - [Category bar](https://beautifulcharts.dev/md/components/category-bar.md): One bar split into named ranges with an optional marker, read as one sentence. Plain HTML: no chart engine ## Blocks - [Saas dashboard](https://beautifulcharts.dev/md/blocks/saas-dashboard.md): How is the business doing, and where? - [Audience growth](https://beautifulcharts.dev/md/blocks/audience-growth.md): How fast is the audience growing, net? - [Payouts trend](https://beautifulcharts.dev/md/blocks/payouts-trend.md): Are payouts steady? - [Plan vs actual](https://beautifulcharts.dev/md/blocks/plan-vs-actual.md): Are we ahead of plan, and by how much? - [Portfolio vs index](https://beautifulcharts.dev/md/blocks/portfolio-vs-index.md): Did we beat the benchmark since the start? - [Revenue margin](https://beautifulcharts.dev/md/blocks/revenue-margin.md): Is growth profitable? - [Service latency](https://beautifulcharts.dev/md/blocks/service-latency.md): Is the service within its target, and when did it slip? - [This week vs last](https://beautifulcharts.dev/md/blocks/this-week-vs-last.md): Is this week tracking last week? - [Best week](https://beautifulcharts.dev/md/blocks/best-week.md): Which week was best? - [Budget burn](https://beautifulcharts.dev/md/blocks/budget-burn.md): Which team is burning budget fastest? - [Scatter quadrant](https://beautifulcharts.dev/md/blocks/scatter-quadrant.md): What should we build next? - [Terminal sales](https://beautifulcharts.dev/md/blocks/terminal-sales.md): How did sales go each day this month? - [Trace bars](https://beautifulcharts.dev/md/blocks/trace-bars.md): What's the value here, against the others? - [Unit bars](https://beautifulcharts.dev/md/blocks/unit-bars.md): How many units per category, countable? - [Cache hit tiers](https://beautifulcharts.dev/md/blocks/cache-hit-tiers.md): Where are requests served from? - [Category treemap](https://beautifulcharts.dev/md/blocks/category-treemap.md): Which categories carry the quarter? - [Goal rings](https://beautifulcharts.dev/md/blocks/goal-rings.md): How close is each goal? - [Market share](https://beautifulcharts.dev/md/blocks/market-share.md): Who holds what share? - [MRR bridge](https://beautifulcharts.dev/md/blocks/mrr-bridge.md): How did MRR move, and why? - [Revenue mix](https://beautifulcharts.dev/md/blocks/revenue-mix.md): Where does revenue come from? - [Weekly goals](https://beautifulcharts.dev/md/blocks/weekly-goals.md): Did we hit this week's targets? - [Budget allocation](https://beautifulcharts.dev/md/blocks/budget-allocation.md): Where does the budget go? - [Revenue flow](https://beautifulcharts.dev/md/blocks/revenue-flow.md): Which sources feed which products? - [Signup funnel](https://beautifulcharts.dev/md/blocks/signup-funnel.md): Where do signups drop off? - [Cohort retention](https://beautifulcharts.dev/md/blocks/cohort-retention.md): Do newer cohorts stick around longer? - [KPI strip](https://beautifulcharts.dev/md/blocks/kpi-strip.md): How's the week, in four numbers? - [Uptime score](https://beautifulcharts.dev/md/blocks/uptime-score.md): Is reliability in the healthy band? ## Optional - [Everything in one file](https://beautifulcharts.dev/llms-full.txt): every chart and block page above, in full - [Registry index](https://beautifulcharts.dev/r/registry.json): every free item with its source