Choose how to download bpmn-js (currently v0.22.1) based on your use-case. You can try it out via our online demo, too.

Quick Start

A bundle that embeds viewer and modeler in a simple project. Use it to try out or library in your web browser.

Download Seed

Pre-Built

Get a pre-built version of bpmn-js from the bower-bpmn-js repository or let Bower download it for you.

Download Pre-Built

Source Code

Source code of bpmn-js. Use it to have a look inside or build tooling around bpmn-js. Requires additional tools.

Download Source

Get bpmn-js via NPM for full access to individual project components and easy customizability.

Choose this setup if you would like to extend and customize the library to your needs.
npm install bpmn-js

Note: This requires additional build steps such as bundling for the browser with Browserify or Webpack.

Checkout the simple-commonjs example to learn more.

Clone and hack the project sources yourself.

If you have not downloaded the projects source code already, create an empty folder an clone the project using git via

git clone https://github.com/bpmn-io/bpmn-js.git -b v0.22.1 .

Ensure you have Node.js / NPM installed. Execute the following command to install all required project dependencies

npm install

Build / test the project via

npm run all

Refer to the projects GitHub page for more information.

Have a look at our example projects to learn more about different usage scenarios for bpmn-js.