Skip to content
GaudiGaudi Design System home

Search documentation

Search every page, heading and paragraph.

OrgChart

A connected organization hierarchy with person cards, expandable reporting lines, and contained scrolling.

Charts@gaudi/design-system/charts/OrgChartView in StorybookSource

Installation

pnpm add github:ahmadassaf/design-system recharts

Import from @gaudi/design-system. Load @gaudi/design-system/global.css once and add transpilePackages: ['@gaudi/design-system'] in Next.js.

import { OrgChart } from '@gaudi/design-system/charts/OrgChart';

Usage

import { OrgChart } from '@gaudi/design-system/charts/OrgChart';
const team = { id: 'lead', name: 'Bram Ellery', role: 'Engineering Lead', children: [{ id: 'dev', name: 'Sam Rivera', role: 'Engineer' }] };<OrgChart label='Engineering organization' data={team} />

Examples

Playground

Storybook

Collapsed departments

Storybook

Empty

Storybook

API

8 props

Accessibility

Nested lists convey reporting relationships. Branch buttons expose expanded state, retain focus when toggled, and work with Enter or Space. The labelled scroll region is keyboard focusable. Avatars are decorative because names are visible.