Skip to content
DocsChartsAreaLast updated Nov 2, 2026

Area

A trend with weight under it. Sample data: spot price, Sep 10 to Oct 9.

Open in
Daily closeDaily close from Sep 10 to Oct 9: from 3,211 to 3,412.3.5K3.4K3.3K3.2KSEP 10SEP 17SEP 24OCT 1OCT 9
Daily close
DayClose
Sep 103,211
Sep 113,231
Sep 123,224
Sep 133,214
Sep 143,226
Sep 153,229
Sep 163,224
Sep 173,237
Sep 183,250
Sep 193,254
Sep 203,263
Sep 213,271
Sep 223,287
Sep 233,278
Sep 243,275
Sep 253,286
Sep 263,296
Sep 273,279
Sep 283,289
Sep 293,290
Sep 303,310
Oct 13,325
Oct 23,311
Oct 33,314
Oct 43,334
Oct 53,344
Oct 63,352
Oct 73,357
Oct 83,376
Oct 93,412
Daily closeDaily close from Sep 10 to Oct 9: from 3,211 to 3,412.3.5K3.4K3.3K3.2KSEP 10SEP 24OCT 1OCT 9
Daily close
DayClose
Sep 103,211
Sep 113,231
Sep 123,224
Sep 133,214
Sep 143,226
Sep 153,229
Sep 163,224
Sep 173,237
Sep 183,250
Sep 193,254
Sep 203,263
Sep 213,271
Sep 223,287
Sep 233,278
Sep 243,275
Sep 253,286
Sep 263,296
Sep 273,279
Sep 283,289
Sep 293,290
Sep 303,310
Oct 13,325
Oct 23,311
Oct 33,314
Oct 43,334
Oct 53,344
Oct 63,352
Oct 73,357
Oct 83,376
Oct 93,412

Installation

  1. 1

    Set up the registry once

    This chart is free in Hearth and MIT licensed: no token. Add @chartory to components.json once (the URL alone, no headers), or skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Area component to your project.

    npx shadcn add @chartory/area
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { Area }  from "@/components/chartory/area"<Area  data={spotPrice}  size="m"/>

Props

<Area>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.AreaDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
color: The data colour of the primary marks (data/primary)."cat-1" | "cat-2" | "cat-3" | "cat-4""cat-1"

AreaData

The data prop: one object for the whole chart.

PropTypeDefault
vals: The values, in order.number[]Required
min: The bottom of the value scale.numberRequired
max: The top of the value scale.numberRequired
ticks: The axis tick labels.string[]Required
xl: The x axis labels, by index.Record<number, string>Required
yW?: The width of the y axis label column, in px.number36
smooth?: Draws the line as a curve.booleanfalse
area?: The fill under the line."flat" | "gradient"—
dots?: Which points get a dot.number[] | "all"—
end?: Labels the last point.booleanfalse
tip?: The highlighted point: index and label.AreaTip—

AreaTip

The tip object.

PropTypeDefault
i: The index of the item it belongs to.numberRequired
text: The label as shown.stringRequired

The data as a JSON Schema: schemas/area.json

Area chart: a React and Figma chart in four sizes

What does an area chart show?

An area chart is a line chart with the space below it filled, so the trend also reads as an amount. The fill fades toward the axis and keeps the line in front. Use it for prices, balances and volumes where the level matters as much as the direction.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Area component?

It is one <Area> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is one value per point in time.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Is it one series? Yes means the area fits.
  • Does the level matter, not only the trend? Yes means the area fits.
  • Is one value per period enough? Yes means the area fits.

When does another type fit better?

  • Several fills stack up and hide. Use Overlapping areas instead.
  • Only the direction matters. Use Line chart instead.
  • Open, high, low and close matter. Use Candlestick instead.

Area chart questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.