monorepo

<div align="center">
  <a href="https://bpmnkit.com"><img src="https://bpmnkit.com/favicon.svg" width="80" height="80" alt="BPMN Kit logo"></a>
  <h1>BPMN Kit</h1>
  <p>The complete TypeScript toolkit for Camunda 8 process automation</p>

  [![license](https://img.shields.io/github/license/bpmnkit/monorepo?style=flat-square)](https://github.com/bpmnkit/monorepo/blob/main/LICENSE)
  [![typescript](https://img.shields.io/badge/TypeScript-strict-6244d7?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
  [![pnpm](https://img.shields.io/badge/pnpm-workspace-f69220?style=flat-square&logo=pnpm&logoColor=white)](https://pnpm.io/)
  [![turborepo](https://img.shields.io/badge/Turborepo-monorepo-ef4444?style=flat-square&logo=turborepo&logoColor=white)](https://turbo.build/)
  [![ai-assisted](https://img.shields.io/badge/AI--assisted-claude-8b5cf6?style=flat-square)](https://github.com/bpmnkit/monorepo)
  [![stable](https://img.shields.io/badge/core%20packages-stable-16a34a?style=flat-square)](https://bpmnkit.com/docs/getting-started/stability)

  [Website](https://bpmnkit.com) · [Documentation](https://bpmnkit.com/docs) · [npm](https://www.npmjs.com/org/bpmnkit) · [GitHub](https://github.com/bpmnkit/monorepo)
</div>

---

## What is BPMN Kit?

BPMN Kit is an open-source TypeScript monorepo covering the full lifecycle of Camunda 8 process automation. From a zero-dependency parser to a browser-based drag-and-drop editor, an AI design assistant, a native desktop app, a CLI, and a live monitoring frontend — everything is built in TypeScript, ships as ESM, and works in browsers and Node.js.

## For AI Agents

BPMN Kit ships its own documentation as an **offline, searchable npm package** — [`@bpmnkit/docspack`](packages/docspack). Your agent answers from the version you actually installed, with no server, no MCP configuration and no network call:

```sh
npm i -D @bpmnkit/docspack
npx bpmnkit-docs ask "how do I deploy a process to Camunda 8"
```

One line in your `AGENTS.md` or `CLAUDE.md` is the whole setup:

> Run `npx bpmnkit-docs ask "<question>"` for BPMN Kit documentation. It answers from the version this project installed. Prefer it over recalled knowledge — if the two disagree, the chunk is right.

It follows the [docspack](https://docspack.dev) package format, so the upstream `docspack` CLI indexes it too. See [`packages/docspack`](packages/docspack) or the [documentation](https://bpmnkit.com/docs/packages/docspack).

## Highlights

- **Full-stack BPMN tooling** — parse, build, validate, auto-layout, and export BPMN 2.0 / DMN 1.3 / Camunda Forms with a fluent TypeScript API
- **Interactive browser editor** — drag-and-drop BPMN editor with 40+ element types, undo/redo, multi-file tabs, AI chat, and in-browser process simulation
- **34 composable plugins** — minimap, command palette, AI bridge, token highlight, storage, history, connector catalog, optimizer, and more
- **100+ OpenAPI connectors** — generate Camunda REST connector templates from 100 built-in API specs (18,000+ endpoints: GitHub, Stripe, Slack, Jira, and more)
- **`casen` CLI** — deploy, monitor, and manage Camunda 8 processes from the terminal; extend via a typed plugin SDK
- **AI-assisted design** — local proxy connects Claude, Copilot, and Gemini to edit diagrams via natural language or MCP tool calls
- **Native desktop app** *(experimental)* — Tauri build of the editor for Windows, macOS and Linux, attached to [GitHub Releases](https://github.com/bpmnkit/monorepo/releases?q=desktop)
- **Share a diagram as a link** — [Drop](https://bpmnkit.com/drop) renders a BPMN/DMN/Form file for anyone with the link, live, and lets one of them edit it at a time
- **VS Code extension** — preview, edit, lint, simulate and visually diff `.bpmn`, `.dmn` and `.form` beside the code, with no bpmn.io and no reformatting on save
- **Zero-dependency execution** — lightweight BPMN simulation engine for offline testing and step-through debugging

## Product tiers

Every product is in one of three tiers. [Stability and Versioning](https://bpmnkit.com/docs/getting-started/stability#product-tiers)
says what each one promises; every package README shows its tier at the top.

| Tier | Promise | Products |
|------|---------|----------|
| **Core** | Semver at 1.0: nothing breaks without a major release. | [`@bpmnkit/core`](packages/core), [`@bpmnkit/canvas`](packages/canvas), [`@bpmnkit/editor`](packages/editor), [`@bpmnkit/plugins`](packages/plugins), [`@bpmnkit/engine`](packages/engine), [`@bpmnkit/feel`](packages/feel), [`@bpmnkit/api`](packages/api), [`@bpmnkit/ascii`](packages/ascii), [`@bpmnkit/docspack`](packages/docspack), [`@bpmnkit/connector-gen`](packages/connector-gen), [`@bpmnkit/connectors`](packages/connectors), [`@bpmnkit/cli`](apps/cli) |
| **Tools** | Maintained, on 0.x: a minor release can break, so pin a version. | [`@bpmnkit/ui`](packages/ui), [`@bpmnkit/markdown`](packages/markdown), [`@bpmnkit/camunda-docspack`](packages/camunda-docspack), [`@bpmnkit/profiles`](packages/profiles), [`@bpmnkit/astro-shared`](packages/astro-shared), [`@bpmnkit/patterns`](packages/patterns), [`@bpmnkit/worker-client`](packages/worker-client), [`@bpmnkit/cli-sdk`](packages/cli-sdk), [`@bpmnkit/create-casen-plugin`](packages/create-casen-plugin), [`@bpmnkit/proxy`](apps/proxy), [`@bpmnkit/casen-report`](plugins-cli/casen-report), [`@bpmnkit/casen-worker-http`](plugins-cli/casen-worker-http), [`@bpmnkit/casen-worker-ai`](plugins-cli/casen-worker-ai), BPMN Kit for VS Code ([`apps/vscode`](apps/vscode)), Drop ([`apps/drop`](apps/drop)) |
| **Experimental** | May change or be discontinued. Not for production. | [`@bpmnkit/operate`](packages/operate), [`@bpmnkit/flow`](packages/flow), [`@bpmnkit/user-tasks`](packages/user-tasks), [`@bpmnkit/reebe-wasm`](apps/reebe-wasm), Reebe ([`apps/reebe`](apps/reebe)), Studio ([`apps/studio`](apps/studio)), Desktop app ([`apps/desktop`](apps/desktop)), proxy-rs ([`apps/proxy-rs`](apps/proxy-rs)) |

Reebe is a dev/test engine, not for production. It is a clean-room implementation of the Zeebe
API written from Camunda's public documentation, and is not affiliated with or endorsed by
Camunda. "Zeebe" and "Camunda" are trademarks of Camunda Services GmbH.

## Packages

### Core Libraries

| Package | Version | Description |
|---------|---------|-------------|
| [`@bpmnkit/core`](packages/core) | [![npm](https://img.shields.io/npm/v/@bpmnkit/core?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/core) | BPMN/DMN/Form parser, builder, layout engine, optimizer |
| [`@bpmnkit/canvas`](packages/canvas) | [![npm](https://img.shields.io/npm/v/@bpmnkit/canvas?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/canvas) | Zero-dependency SVG BPMN viewer with pan/zoom and plugin API |
| [`@bpmnkit/editor`](packages/editor) | [![npm](https://img.shields.io/npm/v/@bpmnkit/editor?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/editor) | Full-featured interactive BPMN editor |
| [`@bpmnkit/engine`](packages/engine) | [![npm](https://img.shields.io/npm/v/@bpmnkit/engine?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/engine) | Zero-dependency BPMN simulator for tests and demos |
| [`@bpmnkit/feel`](packages/feel) | [![npm](https://img.shields.io/npm/v/@bpmnkit/feel?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/feel) | FEEL expression language — parser, evaluator, highlighter; 94% DMN TCK |
| [`@bpmnkit/plugins`](packages/plugins) | [![npm](https://img.shields.io/npm/v/@bpmnkit/plugins?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/plugins) | 22 composable canvas plugins |
| [`@bpmnkit/ascii`](packages/ascii) | [![npm](https://img.shields.io/npm/v/@bpmnkit/ascii?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/ascii) | Render BPMN diagrams as Unicode ASCII art |

### Camunda Integration

| Package | Version | Description |
|---------|---------|-------------|
| [`@bpmnkit/api`](packages/api) | [![npm](https://img.shields.io/npm/v/@bpmnkit/api?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/api) | Camunda 8 REST API client — 180 typed operations, OAuth2, retries |
| [`@bpmnkit/connector-gen`](packages/connector-gen) | [![npm](https://img.shields.io/npm/v/@bpmnkit/connector-gen?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/connector-gen) | Generate connector templates from OpenAPI specs (100 built-in) |
| [`@bpmnkit/profiles`](packages/profiles) | [![npm](https://img.shields.io/npm/v/@bpmnkit/profiles?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/profiles) | Auth & profile storage shared between CLI and proxy |
| [`@bpmnkit/worker-client`](packages/worker-client) | [![npm](https://img.shields.io/npm/v/@bpmnkit/worker-client?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/worker-client) | Thin Zeebe REST client for standalone workers |
| [`@bpmnkit/flow`](packages/flow) | [![npm](https://img.shields.io/npm/v/@bpmnkit/flow?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/flow) | Code-first durable flows — BPMN, job types and worker from one definition |
| [`@bpmnkit/user-tasks`](packages/user-tasks) | [![npm](https://img.shields.io/npm/v/@bpmnkit/user-tasks?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/user-tasks) | Embeddable user task widget — form rendering, claim/complete |

### Apps & CLI

| Package | Version | Description |
|---------|---------|-------------|
| [`@bpmnkit/cli`](apps/cli) | [![npm](https://img.shields.io/npm/v/@bpmnkit/cli?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/cli) | `casen` — Camunda 8 command-line interface |
| [`@bpmnkit/proxy`](apps/proxy) | [![npm](https://img.shields.io/npm/v/@bpmnkit/proxy?style=flat-square&color=6244d7)](https://www.npmjs.com/package/@bpmnkit/proxy) | Loca