bpmn-io /bpmn-js

A BPMN 2.0 rendering toolkit and web modeler.

★ 9,736⑂ 1,499👁 224⑃ 1,055● 1,442▤ 98
JavaScriptNOASSERTIONCreated 2014-03-10bpmn.io/toolkit/bpmn-js/
下载:v18.31.0bpmn-js-18.31.0 ↓18.31.02026-10-01
+0
日增长
9,736
stars
1,499
forks
224
watchers
1,055
prs
1,442
issues
98
releases

README

bpmn-js - BPMN 2.0 for the web



View and edit BPMN 2.0 diagrams in the browser.



 Installation

Use the library pre-packaged
or include it via npm
into your node-style web-application.

 Usage

To get started, create a bpmn-js instance
and render BPMN 2.0 diagrams in the browser:

javascript
const xml = '...'; // my BPMN 2.0 xml
const viewer = new BpmnJS({
  container: 'body'
});

try {
  const { warnings } = await viewer.importXML(xml);

  console.log('rendered');
} catch (err) {
  console.log('error rendering', err);
}


Checkout our examples for many
more supported usage scenarios.

 Resources

 Demo
 Issues
 Examples
 Forum
 Changelog

 Build and Run

Prepare the project by installing all dependencies:

sh
npm install


Then, depending on your use-case you may run any of the following commands:

sh
 build the library and run all tests
npm run all

 spin up a single local modeler instance
npm start

 run the full development setup
npm run dev


You may need to perform additional project setup when
building the latest development snapshot.

 Related

bpmn-js builds on top of a few powerful tools:

 bpmn-moddle: Read / write support for BPMN 2.0 XML in the browser
 diagram-js: Diagram rendering and editing toolkit

It is an extensible toolkit, complemented by many additional utilities.

 License

Use under the terms of the bpmn.io license.

Top issues

Latest release

v18.31.0 v18.31.0 2026-10-01
Changes

- chore(CHANGELOG): update to v18.31.0  81c1652a
- deps: update to [email protected]  f0371c3d
- chore: update test dependencies  e4c2a77a
- deps: update to [email protected]  71cde543
- deps: update to [email protected]  30840b37
- fix(modeling): remove BPMNLabel with external label  e2c39ea0

---

https://github.com/bpmn-io/bpmn-js/compare/v18.30.1...v18.31.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON