Skip to content
InsightCharts

Search

Search guides and components

Open source · React 19 · Apache ECharts 6

A React chart library built on Apache ECharts

InsightCharts has 61 atoms, 19 molecules and 20 templates. 10 of the templates are infographics. Each one is a chart, a figure, a page layout or a poster that can be written as JSX or as a JSON spec.

$npm i insightcharts echarts
Monthly churn, December
2.1%
−2.1 pts vs January
02MoleculeStat row
Monthly churn, December
2.1%
−2.1 pts vs January
New accounts finishing setup in week one
61%
+19 pts vs January
Net revenue retention
112%
Top quartile for the sector is 110%
Annual revenue retained
$1.9m
Compared with churn staying at the January rate of 4.2%
03TemplateExecutive brief
These are live components. The first is one figure as an atom. The second is a row of figures as a molecule. The third is a one-page brief that starts with that row, as a template.

Infographics

10 templates draw a whole poster

An infographic is one designed sheet with a painted background, little text and large graphics. See all 10 infographics, or read the guide.

Atoms, molecules, templates

Components come in three levels

Atoms are single charts and figure primitives. Molecules combine a few atoms to make one point. Templates arrange molecules and atoms into a complete page. Each card below names the components it uses. Every component page lists what the component is built from and where it is used.

01

Atoms

One chart form or one figure primitive.

All 61 atoms

A boxed statement of fact with a short bold lead and a sentence of explanation. The tone is marked by icon and tint.

A featured statistic with its label, change and the context that gives it meaning.

Used inStat row

02

Molecules

A combination of atoms that is used often.

All 19 molecules

Two to five key figures in one row separated by hairlines, collapsing to two columns and then one as the container narrows.

A responsive grid of trend cards drawn from one dataset: each metric shows its latest value, its change and a sparkline.

03

Templates

A complete page built from molecules and atoms.

All 20 templates

A long article read by scrolling. It has a headline, then an ordered list of blocks in a reading column, then a source note. The blocks are prose, figures, charts with a callout, scrolly sequences, pull quotes, stat rows, small multiples and chapter breaks. Exhibits can be wider than the column.

A one-page summary. It has a headline that states the main finding with its number, a deck, a row of three or four key figures, one hero chart with a takeaway callout, two smaller supporting exhibits, a short list of actions and a source note.

Templates

Templates lay out a whole page

Each template is one component that takes its whole content as props: a title, figures, chart specs and sources. Read the guide, or open any of the 10 below.

  • A compared with B on one page. It has a headline that states the result, the headline figures mirrored either side of their labels, one hero exhibit that shows both sides, paired exhibits on a shared scale, a verdict callout and a source note.

  • A set of linked charts over one shared dataset that filter each other. It has a headline, a sentence of instructions with filter chips, a row of figures that recompute from the filtered rows, two to four charts and an optional detail table. It opens on selections the author chooses.

  • A one-page summary. It has a headline that states the main finding with its number, a deck, a row of three or four key figures, one hero chart with a takeaway callout, two smaller supporting exhibits, a short list of actions and a source note.

  • A vertical infographic in one narrow column. It opens with a big number or a proportion statement (hook), then the hero exhibit, then numbered sections with one exhibit each, a conclusion with an optional link, and sources.

  • A section of an analytical report laid out as a document. It has a title block, a summary, numbered findings, then method, limitations and sources. Each finding has one exhibit, an observation and a separately labelled interpretation with a confidence rating and a caveat.

  • A recurring report. It has a masthead with the report name and period, a headline that states the main change, a KPI grid with changes and sparklines, a ranked list beside one or two trend charts, an optional comparison table, short notes and a source note.

  • A graphic that states one fact, at a fixed aspect ratio (1:1, 4:5, 16:9 or 9:16). It has a kicker, a headline, one exhibit, a source and a credit, painted on the theme surface. A button downloads the whole card as a PNG.

  • A sequence of full-frame cards (title, stat, chart, quote, closing) that the reader swipes or steps through. Each card states one fact. It has an optional fixed aspect ratio, a keyboard-accessible pager and a stacked layout for print.

  • A story told in date order. It has a headline, one overview exhibit of the whole period (a timeline chart or an annotated line), dated chapters along a rail, a closing paragraph and a source note. Each chapter has a short text and an optional small exhibit.

  • A long article read by scrolling. It has a headline, then an ordered list of blocks in a reading column, then a source note. The blocks are prose, figures, charts with a callout, scrolly sequences, pull quotes, stat rows, small multiples and chapter breaks. Exhibits can be wider than the column.

JSON specs

Every component can be written as JSON

Props are field names, format strings and transform objects, with no accessor functions, so a chart can be a plain JSON document. Edit the spec below. <Insight spec /> redraws it each time the JSON is valid.

Valid spec. Try changing the type to line-chart or the highlight to Mar.

Support tickets fell from 84 in March to 43 in June

Tickets per 1,000 accounts

Crossfiltering

A click on one chart filters the others

Wrap charts in InsightData, mark some as select, and they share one dataset and one selection. You do not write any state code. Read the guide.

Click a bar to filter the other charts.

By region

By source

Renewable generation by year

TWh, stacked by source. Follows both selections above.

Illustrative data

Scroll stories

A chart that changes as the reader scrolls

Scrolly pins a graphic and gives it a new state at each step. The chart animates from one state to the next. On phones the steps become cards that swipe, and a steps mode with buttons works in any container. Read the guide.

Renewable generation, TWh

2020, 2022 and 2024 combined

Illustrative data
Renewable generation in three regions, grouped by source. Hydro generated 11,520 TWh, 53% of the total.
Solar generated 3,870 TWh, 18% of the total.
The same rows grouped by region.
Asia generated 10,590 TWh, 49% of the total.

Theming

Themes and dark mode

Charts read shadcn/ui variables when they are present. Every colour token has an --ic-* CSS variable. Presets replace the whole palette. Dark mode is detected from the page. Read the guide.

Revenue, Q4 ($m)
$97
+12.8% vs Q3
Subscriptions were 65% of the total

Subscription revenue rose from $42m in Q1 to $63m in Q4

Revenue by line of business

$ millions per quarter

Illustrative data

Export

Export to PNG, JPEG, SVG, PDF, CSV and JSON

PNG, JPEG, SVG and PDF exports include the title, subtitle and source line. CSV and JSON exports contain the rows the chart drew. Read the guide.

Paid signups rose from 120 in week 1 to 470 in week 6

New accounts per week

Source: Product analytics · Illustrative data
Export

Get started

The quickstart renders a first chart. The catalogue lists every component.