Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/TargetProcess/tauCharts/llms.txt

Use this file to discover all available pages before exploring further.

Taucharts is a data-focused JavaScript charting library built on D3, designed to make it easy to visualize complex datasets with a clean, declarative API. Rather than configuring chart internals, you describe your data’s structure and how fields map to visual dimensions — Taucharts handles the rest.

Quickstart

Build your first chart in minutes with a working code example

Installation

Install via npm, CDN, or Bower with full setup instructions

Chart Types

Explore scatter plots, line charts, bar charts, maps, and more

Plugins

Extend charts with tooltip, legend, annotations, trendlines, and export

Configuration

Learn how to configure data, scales, guides, and settings

API Reference

Full API reference for Chart, Plot, and all public exports

Why Taucharts?

Taucharts is built around three core ideas: Data-first design — Your data drives everything. Pass a flat array of objects, map fields to visual properties (x, y, color, size), and Taucharts automatically detects dimension types and configures appropriate scales. Composable architecture — Charts are built from composable grammar elements (points, lines, intervals, areas) layered on coordinate systems. Facets let you split a single chart into a grid of small multiples by adding a second dimension to x or y. Extensible plugins — Every built-in feature — tooltips, legends, annotations, trend lines, export — is a plugin. You can write your own plugins that hook into chart events and modify specifications at any stage of rendering.

Supported chart types

TypeDescription
scatterplotPoints plotted at (x, y) coordinates, optionally sized and colored
lineConnected lines for time series and trend visualization
barVertical bars for categorical comparisons
horizontal-barHorizontal bars for long category labels
stacked-barStacked vertical bars for part-to-whole relationships
horizontal-stacked-barStacked horizontal bars
stacked-areaFilled areas showing cumulative values over time
mapGeographic choropleth and point maps
parallelParallel coordinates for multivariate data

Getting started

1

Install Taucharts

Install via npm or load from CDN — see the installation guide for all options.
npm install taucharts
2

Create a chart

Import Taucharts, prepare your data, and call renderTo with a DOM element.
import Taucharts from 'taucharts';
import 'taucharts/dist/taucharts.min.css';

const chart = new Taucharts.Chart({
    type: 'scatterplot',
    x: 'Effort',
    y: 'Bugs',
    color: 'Team',
    data: [
        { Effort: 40, Bugs: 12, Team: 'Alpha' },
        { Effort: 55, Bugs: 8,  Team: 'Beta' }
    ]
});

chart.renderTo('#chart');
3

Add plugins

Enhance your chart with built-in plugins for tooltips, legends, and more.
const chart = new Taucharts.Chart({
    type: 'scatterplot',
    x: 'Effort',
    y: 'Bugs',
    color: 'Team',
    data: [...],
    plugins: [
        Taucharts.api.plugins.get('tooltip')(),
        Taucharts.api.plugins.get('legend')()
    ]
});

TypeScript support

Taucharts ships with TypeScript type definitions in types/index.d.ts. Import types directly from the package:
import Taucharts, { Chart, Plot } from 'taucharts';
All ChartSpec, ChartGuide, ChartSettings, and plugin types are exported and fully documented.

Build docs developers (and LLMs) love