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'.

ImportAdds
katucharts.jsCore — line, area, column, bar, scatter, bubble, pie/donut, gauge, polar, treemap, sunburst, funnel, heatmap, waterfall, boxplot, sankey, network, dependency wheel
katucharts.js/financeHeikin-Ashi, hollow candlestick, volume, baseline, Renko, Kagi and more + 19 technical indicators
katucharts.js/bioVolcano, Manhattan, Kaplan-Meier, forest plot, sequence logo, clustered heatmap, circos, PCoA, phylo tree
katucharts.js/datatableSortable, filterable, paginated interactive data grid
katucharts.js/reactReact wrapper component

Why KatuCharts

  • One API, 64 types — switch chart type by changing a single type string.
  • 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).