Documentation
Overview
KatuCharts is a dependency-light charting library. 64 chart types, a single declarative API, and optional modules for finance, bioinformatics and data tables — v0.2.31.
Install
Install the core package from npm. Each add-on module is a separate import, so you only load the modules you use.
npm install katucharts.js
# optional modules register themselves when imported
import KatuCharts from 'katucharts.js';
import 'katucharts.js/finance';
import 'katucharts.js/bio';
import { DataTable } from 'katucharts.js/datatable';
import { KatuChartsReact } from 'katucharts.js/react';Or drop in the UMD build from a CDN — no bundler required:
<script src="https://unpkg.com/katucharts.js/dist/katucharts.umd.js"></script>
<div id="chart" style="width:100%;height:420px"></div>
<script>
var KatuCharts = window.KatuCharts.default || window.KatuCharts.KatuCharts || window.KatuCharts;
KatuCharts.chart('chart', {
series: [{ type: 'line', data: [1, 3, 2, 5, 4] }]
});
</script>Quick start
Every chart is created with KatuCharts.chart(container, options). The container can be an element id or a DOM node.
import KatuCharts from 'katucharts.js';
KatuCharts.chart('my-chart', {
chart: { type: 'areaspline' },
title: { text: 'Weekly Traffic' },
xAxis: { categories: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'] },
series: [
{ name: 'Desktop', data: [450, 520, 480, 610, 580] },
{ name: 'Mobile', data: [280, 350, 420, 510, 490] }
]
});Browsing for a chart type? The live gallery renders all 64 types, and Chart Types documents the data shape for each.
Modules
The core bundle covers cartesian, statistical, hierarchical and flow charts. Specialised charts ship as opt-in modules that register their chart types when imported, e.g. import 'katucharts.js/bio'.
| Import | Adds |
|---|---|
katucharts.js | Core — line, area, column, bar, scatter, bubble, pie/donut, gauge, polar, treemap, sunburst, funnel, heatmap, waterfall, boxplot, sankey, network, dependency wheel |
katucharts.js/finance | Heikin-Ashi, hollow candlestick, volume, baseline, Renko, Kagi and more + 19 technical indicators |
katucharts.js/bio | Volcano, Manhattan, Kaplan-Meier, forest plot, sequence logo, clustered heatmap, circos, PCoA, phylo tree |
katucharts.js/datatable | Sortable, filterable, paginated interactive data grid |
katucharts.js/react | React wrapper component |
Why KatuCharts
- One API, 64 types — switch chart type by changing a single
typestring. - Modular — finance, bio and data-table are separate opt-in imports you add on top of the core.
- Built for science & finance — publication-ready bioinformatics plots and financial time series out of the box.
- Real-time — stream from WebSocket, SSE or polling with built-in adapters.
- Accessible — ARIA roles, keyboard navigation and screen-reader descriptions.
- Exports — PNG, JPEG, SVG, PDF, CSV, XLS in a single call (PDF needs the optional jspdf package).