A BPMN 2.0 rendering toolkit and web modeler. https://bpmn.io/toolkit/bpmn-js/
Go to file
pedesen 02af025a2e fix(auto-resize): allow concurrent top/bottom or left/right expanding 2015-09-25 11:44:07 +02:00
assets/bpmn-font feat(assets): update bpmn-font 2015-08-12 09:50:20 +02:00
docs docs(project): fix broken link in SETUP.md 2015-07-23 16:02:57 +02:00
lib fix(auto-resize): allow concurrent top/bottom or left/right expanding 2015-09-25 11:44:07 +02:00
resources feat(context-pad): use font to render symbols 2014-11-17 11:02:25 +01:00
tasks chore(bower): hide bpmn-js internals in bundle 2015-02-06 09:56:18 +01:00
test fix(auto-resize): allow concurrent top/bottom or left/right expanding 2015-09-25 11:44:07 +02:00
.gitignore chore(gitignore): add .DS_Store 2015-05-19 09:18:55 +02:00
.jshintrc test(project): replace jasmine with mocha 2015-07-15 17:42:37 +02:00
.travis.yml chore(project): only hint + test during travis builds 2015-02-19 15:03:53 +01:00
.wiredeps chore(wiredeps): add inherits dep 2015-03-25 10:56:10 +01:00
CONTRIBUTING.md feat(space-tool): add create/remove space behaviour 2015-04-16 10:00:18 +02:00
Gruntfile.js chore(project): migrate to modularized lodash@3 2015-02-02 14:46:21 +01:00
LICENSE feat(project): add license 2014-05-06 14:33:12 +02:00
README.md docs(README): add travis status badge 2015-02-19 14:59:57 +01:00
index.js chore(project): add index.js entry point 2014-06-11 14:36:26 +02:00
package.json chore(deps): update karma deps 2015-09-09 16:44:17 +02:00

README.md

bpmn-js - BPMN 2.0 for the web

Build Status

bpmn-js is the BPMN 2.0 diagram modeling and rendering toolkit that powers bpmn.io.

the project is still in an early stage. Documentation may be missing and examples may be broken.

Usage

Get the library via npm or bower and use it in your web applications to display BPMN 2.0 diagrams.

var BpmnViewer = require('bpmn-js');

var xml; // my BPMN 2.0 xml
var viewer = new BpmnViewer({ container: 'body' });

viewer.importXML(xml, function(err) {

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

Install bpmn-js

via bower

bower install bpmn-js

Make sure to include the library + all dependencies into the website.

Checkout an example project that shows how to use the library in web applications.

via npm

npm install --save bpmn-js

Make sure you use browserify or the like to bundle your project and bpmn-js for the browser.

Checkout an example project that shows how to use bpmn-js in node-style web applications.

Resources

Tools

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

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

Building the Project

As long as the project is in alpha stage, you must make sure you setup the whole development environment, including a number of project dependencies according to our development setup.

License

Use under the terms of the bpmn-js license.