# bpmn-js

A BPMN 2.0 rendering toolkit and web modeler.

Repository: https://github.com/bpmn-io/bpmn-js
Canonical: https://ross.abutalabs.com/products/bpmn-js
Homepage: https://bpmn.io/toolkit/bpmn-js/
Language: JavaScript
License: NOASSERTION
License Family: other
Topics: bpmn, javascript, modeler, toolkit, browser, bpmn-js, hacktoberfest
Last push: 2026-08-26T23:38:47+00:00
Link (homepage): https://bpmn.io/toolkit/bpmn-js/
Link (site_page): https://bpmn.io/about

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 4559, "days_push": 7, "days_rel": 14, "gap_med": 9.0, "n_releases_24m": 47}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9636, forks 1484 (observed 2026-08-28T04:10:36.472266+00:00)

## What it is
bpmn-js is a JavaScript toolkit and web modeler for viewing, creating, and editing BPMN 2.0 diagrams directly in the browser. It can be embedded into applications as a viewer or editor and extended with custom elements, styling, and modeling rules.

## Use cases
- embed a BPMN 2.0 diagram viewer in a web application
- build a browser-based BPMN process modeler
- render BPMN XML diagrams in the browser
- edit and annotate business process diagrams online
- extend BPMN modeling with custom elements and token simulation
- integrate a process design component into a workflow application

## When to choose
- you need to display or edit BPMN 2.0 diagrams in a web app
- you want an embeddable, extensible JavaScript diagraming toolkit
- you need standards-compliant BPMN XML import and export
- you are building workflow or process automation tooling in the browser

## When to avoid
- you need server-side or desktop-only diagram rendering
- you need a full BPM suite or process execution engine rather than a modeling component
- you need diagram types other than BPMN 2.0
- you require a permissive license - bpmn-js uses the custom bpmn.io license

## Facets
- artifact type: library
- maturity: active
- function: ui-components, graphics, parser, web-framework
- domain: web-development, frontend, developer-tools, documentation
- platform: browser
- tags: bpmn, bpmn-2-0, diagram-editor, process-modeling, web-modeler, diagram-viewer, workflow, extensible-toolkit, automation, javascript, nodejs, web-server

## Member repositories
- bpmn-io/bpmn-js (main) score 99
- bpmn-io/bpmn-js-examples (examples) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:36.472266+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:20.880541+00:00, confidence not recorded.
  - readme: https://github.com/bpmn-io/bpmn-js (fetched 2026-08-28T04:10:36.472266+00:00, sha b26bdd210025)
  - homepage: https://bpmn.io/toolkit/bpmn-js/ (fetched 2026-08-29T08:22:00.431219+00:00, sha 86545bc93458)
  - site_page: https://bpmn.io/about (fetched 2026-08-29T08:22:00.440888+00:00, sha bb5c63ac7e46)
- Data as of 2026-08-30T08:39:29.467469+00:00.