Choose how to get bpmn-js (currently v18.1.0) based on your use-case. You can try it out via our online demo, too.
Explore numerous bpmn-js usage examples, many ready to use right in your web browser.
Try out bpmn-js in no time via starters, embedding pre-packaged versions of our BPMN toolkit.
The bpmn-js sources. Use it to have a look inside or build tooling around bpmn-js. Requires additional tools.
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 bundling 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 v18.1.0 .
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.