Skip to content

KladCanvas Org Chart

κλάδος, “branch” — a fast, framework-agnostic org chart for very large trees

An org chart of six cards in perspective, floating above their connectors

Quick Start

bash
npm install @klad/core
ts
import { createKlad } from '@klad/core'

const chart = createKlad(document.getElementById('chart')!, {
  data: [
    { id: 'ceo', name: 'Jamie Fox', title: 'CEO' },
    { id: 'cto', parentId: 'ceo', name: 'Amy Chen', title: 'CTO' },
    { id: 'cfo', parentId: 'ceo', name: 'Priya Rao', title: 'CFO' },
  ],
  nodeSize: { w: 180, h: 64 },
  label: (item) => String(item.name ?? ''),
})

Pan, zoom, click, keyboard navigation. data is flat — { id, parentId?, ...yours } — so the array from your API is usually already the right shape.

One Thing to Know

nodeSize is declared, not measured. Layout runs in a Web Worker, where there is no element to call getBoundingClientRect() on — that is what buys the 50,000. Your content fits the box you declare.

If your chart is a hundred nodes and every card is a different height decided by its content, use a DOM-based chart instead. Sizing has the whole trade.

AGPL-3.0-or-later, with a commercial licence available.