# @joint/core

> JavaScript diagramming library

Latest version **4.3.4** (published 2026-10-27) · MPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install @joint/core
pnpm add @joint/core
yarn add @joint/core
bun add @joint/core
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.3.4 |
| Published | 2026-10-27 |
| First published | 2024-02-01 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5402 |
| Author | client IO |
| Maintainers | joint_admin, zbynekstara |
| Keywords | joint, jointjs, diagram, diagrams, chart, charts, svg, flowchart, graph, visualization, visual, data, dataviz, flow, workflow, process, network, sequence, circuit, hierarchy, hierarchical, editor, javascript, typescript, library, layout, tree, grid, stack, directed, tree-layout, stack-layout, grid-layout, force-directed, visio, bpmn, vsm, value-stream, mapping, family-tree, treeview, entity-relationship, er-diagram, er, planogram, database, orgchart, org, uml, chatbot, kanban, mindmap, vector, yamazumi, shortest, path, finder, shortest-path-finder |

## Links

- npm: https://www.npmjs.com/package/@joint/core
- Repository: https://github.com/clientIO/joint
- Homepage: https://jointjs.com
- Issues: https://github.com/clientIO/joint/issues
- npm.io page: https://npm.io/package/@joint/core

## Alternatives

- [d3-force-3d](https://npm.io/package/d3-force-3d.md) — 1.0M weekly downloads
- [ng2-charts](https://npm.io/package/ng2-charts.md) — 486.8K weekly downloads
- [@arcgis/core](https://npm.io/package/@arcgis/core.md) — 257.8K weekly downloads
- [react-sparklines](https://npm.io/package/react-sparklines.md) — 249.3K weekly downloads
- [react-native-gifted-charts](https://npm.io/package/react-native-gifted-charts.md) — 182.3K weekly downloads

## Recent versions

- 4.3.4 (latest) — 2026-10-27
- 4.1.4 (release-4.1) — 2026-10-27
- 4.2.6 (release-4.2) — 2026-10-27
- 4.3.0-beta.2 (beta) — 2026-06-16
- 4.2.0-alpha.1 (alpha) — 2025-09-25
- 4.3.3 — 2026-09-04
- 4.3.2 — 2026-08-21
- 4.3.1 — 2026-07-27
- 4.3.0 — 2026-07-07
- 4.3.0-beta.1 — 2026-06-15
- 4.2.5 — 2026-06-11
- 4.2.4 — 2026-02-13
- 4.2.3 — 2026-01-21
- 4.2.2 — 2025-12-16
- 4.2.1 — 2025-11-20
- … 16 more at https://npm.io/package/@joint/core/versions

## README

# JointJS — The JavaScript diagramming library you don't replace at scale

[JointJS](https://jointjs.com) is a proven JavaScript/TypeScript diagramming library for building complex, production-scale diagramming applications.

Teams use it to build AI workflow builders, flowchart and process editors, BPMN modelers, SCADA/HMI and monitoring dashboards, data modeling tools, energy network diagrams, electronic design tools, and org chart builders.

JointJS is framework-agnostic, with first-class support for React.

[![Use Cases](https://user-images.githubusercontent.com/3967880/200360293-808f148c-32af-4f46-bec1-b4ae4e1592a0.jpg)](https://user-images.githubusercontent.com/3967880/200360293-808f148c-32af-4f46-bec1-b4ae4e1592a0.jpg)

Further information, examples and documentation can be found at [jointjs.com](https://jointjs.com).

- 🚀 [Getting started guide](https://docs.jointjs.com)
- 💡 Ask a question or share feedback in our [GitHub discussions](https://github.com/clientIO/joint/discussions)
- 🖊️ [180+ demo apps](https://www.jointjs.com/demos) to kickstart your development
- 🤖 [MCP server integration](https://mcp.jointjs.com/mcp) for AI coding agents
- ⚛️ **New:** [JointJS for React](https://www.jointjs.com/react-diagrams) — build diagramming UIs in your React app

## Use cases

JointJS is used to build production diagramming applications across many domains:

| Domain | Examples |
|---|---|
| Workflow & process | Flowchart editors, process automation, activity and sequence diagrams |
| AI workflow builders | Node-based AI pipeline and agent builders, marketing automation studios |
| BPMN | Business process modelers, swimlanes, Visio BPMN import/export |
| Data modeling | ER diagrams, database schema designers, data mapping tools |
| UML & software modeling | Class, sequence, statechart and use-case diagrams |
| Industrial / SCADA & HMI | P&ID diagrams, monitoring and control dashboards |
| Energy networks | Power and telecom network diagrams, DWDM circuits |
| Electronic design | Logic circuits, wiring and cable diagrams |
| Org charts | Organizational charts, hierarchy and tree builders |
| Timelines | Project and milestone timelines, Gantt and PERT charts |

Explore all [180+ demo apps](https://www.jointjs.com/demos) that serve as boilerplates for your project.

## Framework integrations

JointJS is framework-agnostic and works with any frontend stack. React has first-class, native support; the others have integration guides and examples:

- [**React**](https://docs.jointjs.com/react) — native components and hooks (JointJS for React)
- [Angular](https://docs.jointjs.com/learn/integration/angular/)
- [Vue](https://docs.jointjs.com/learn/integration/vue)
- [Svelte](https://docs.jointjs.com/learn/integration/svelte)
- [Salesforce Lightning](https://docs.jointjs.com/learn/integration/lightning)

## Features

- essential diagram elements (rect, circle, ellipse, text, image, path)
- ready-to-use diagram elements of well-known diagrams (ERD, Org chart, FSA, UML, PN, DEVS, ...)
- custom diagram elements based on SVG or programmatically rendered
- connecting diagram elements with links or links with links
- customizable links, their arrowheads and labels
- configurable link shapes (anchors, connection points, vertices, routers, connectors)
- custom element properties and data
- import/export from/to JSON format
- customizable element ports (look and position, distributed around shapes or manually positioned)
- rich graph API (traversal, dfs, bfs, find neighbors, predecessors, elements at point, ...)
- granular interactivity
- hierarchical diagrams (containers, embedded elements, child-parent relationships)
- element & link tools (buttons, status icons, tools to change the shape of links, ...)
- highlighters (provide visual emphasis to your elements)
- automatic layouts (arrange the elements and links automatically)
- highly event driven (react on any event that happens inside the diagram)
- zoom in/out
- touch support
- MVC architecture
- SVG based
- ... a lot more

## Using JointJS with AI coding agents

JointJS is built to work well with AI-assisted development.

**MCP server** — connect your AI coding agent (Claude Code, Cursor, and other MCP-compatible tools) to the JointJS Model Context Protocol server so it can search the official docs and demos while you build.

```
https://mcp.jointjs.com/mcp
```

Exposes `search_docs` and `search_demos` so your agent writes correct JointJS code against the real API instead of guessing.

## Supported browsers

- Latest Google Chrome (including mobile)
- Latest Firefox
- Latest Safari (including mobile)
- Latest Microsoft's Edge
- Latest Opera

## Commercial version

The open-source library covers core diagramming. **[JointJS+](https://www.jointjs.com/jointjs-plus)** adds production-ready plugins (stencils, inspectors, toolbars, advanced layouts, import/export, and more), professional demo apps (including source code), JointJS for React, and direct support from the team that builds the library. [Start a free 30-day trial.](https://www.jointjs.com/free-trial)

## Development Environment

If you want to work on *JointJS* locally, use the following guidelines to get started.

### Dependencies

Make sure you have the following dependencies installed on your system:

- [Node.js](https://nodejs.org/)
- [grunt-cli](http://gruntjs.com/using-the-cli)
- [git](https://git-scm.com/)
- [yarn](https://yarnpkg.com/getting-started/install)

The installation requires Node version 22.14.0, to avoid syntax errors during installation.

Make sure that you are using Yarn version >= 2.0.0, so that you have access to [Yarn workspace ranges](https://yarnpkg.com/features/workspaces#workspace-ranges-workspace) functionality. If you are using [Volta](https://volta.sh/), it will automatically read this restriction from `package.json`.

### Setup

Clone this git repository:

```
git clone https://github.com/clientIO/joint.git
```

Navigate to the `joint` directory:

```
cd joint
```

Install all dependencies:

```
yarn install
```

Generate distribution files from the source code:

```
yarn run dist
```

You are now ready to browse our example applications, which combine functionality from multiple JointJS packages:

```
cd examples
```

Refer to each application's `README.md` file for additional instructions.

You can also browse the demo applications of our JointJS Core package:

```
cd packages/joint-core/demo
```

Most demos can be run by simply opening the `index.html` file in your browser. Some demos have additional instructions, which you can find in their respective `README.md` files.

### Tests

To run all tests:

```
yarn run test
```

To run only the server-side tests:

```
yarn run test-server
```

To run only the client-side tests:

```
yarn run test-client
```

To run only TypeScript tests:

```
yarn run test-ts
```

### Lint

To check for linting errors in `src` and `types` directories:

```
yarn run lint
```

To auto fix errors, run eslint for `src` and `types` directories:

```
yarn run lint-fix
```

### Code Coverage Reports

To output a code coverage report in HTML:

```
yarn run test-coverage
```

To output a code coverage report in [lcov format](http://ltp.sourceforge.net/coverage/lcov/geninfo.1.php):

```
yarn run test-coverage-lcov
```

The output for all unit tests will be saved in the `packages/joint-core/coverage` directory.

## Contributors

[![](https://contrib.rocks/image?repo=clientIO/joint)](https://github.com/clientIO/joint/graphs/contributors)

## License

The *JointJS* library is licensed under the [Mozilla Public License 2.0](https://github.com/clientIO/joint/blob/master/LICENSE).

Copyright © 2013-2026 client IO

---
_Source: https://npm.io/package/@joint/core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
