Home

Awesome

<h1 align="center">bpmn-visualization-addons</h1> <div align="center"> <p align="center"> <a href="https://npmjs.org/package/@process-analytics/bpmn-visualization-addons"> <img alt="npm package" src="https://img.shields.io/npm/v/@process-analytics/bpmn-visualization-addons.svg?color=orange"> </a> <a href="https://github.com/process-analytics/bpmn-visualization-addons/releases"> <img alt="GitHub release (latest by date including pre-releases)" src="https://img.shields.io/github/v/release/process-analytics/bpmn-visualization-addons?label=changelog&include_prereleases"> </a> <a href="https://process-analytics.github.io/bpmn-visualization-addons/"> <img alt="Live Demo" src="https://img.shields.io/badge/demo-online-blueviolet.svg"> </a> <a href="https://github.com/process-analytics/bpmn-visualization-addons/actions"> <img alt="Build" src="https://github.com/process-analytics/bpmn-visualization-addons/workflows/Build/badge.svg"> </a> <a href="https://sonarcloud.io/project/overview?id=process-analytics_bpmn-visualization-addons"> <img alt="Code Smells" src="https://sonarcloud.io/api/project_badges/measure?project=process-analytics_bpmn-visualization-addons&metric=code_smells"> </a> <br> <a href=https://github.com/process-analytics/.github/blob/main/CODE_OF_CONDUCT.md"> <img alt="Contributor Covenant" src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg"> </a> <a href="LICENSE"> <img alt="License" src="https://img.shields.io/github/license/process-analytics/bpmn-visualization-addons?color=blue"> </a> </p> </div> <br>

🔆 Presentation

bpmn-visualization-addons offers new functionalities to bpmn-visualization in the form of addons.

bpmn-visualization-addons is being actively developed. Before the release of version 1.0.0, there may be some breaking changes.

<!-- We avoid these as much as possible, and carefully document them in the release notes. As far as possible, we maintain compatibility for some minor versions. -->

🎨 Features and Usage

See the dedicated README.

A live demo is available at ⏩ https://process-analytics.github.io/bpmn-visualization-addons/. The sources of the demo are available in the demo folder.

⚒️ Development Setup

Use the node version declared in .nvmrc. You can use a Node version manager like nvm: nvm use

This project uses npm workspaces.

Install dependencies: npm install

Develop the lib and live update the demo: run npm run dev:demo. The demo is accessible at http://localhost:5173/

Husky settings when using Node Version Managers

Husky runs the pre-commit hook before each commit to ensure that the code meets the standards.

On commit, if you use a Node Manager, the pre-commit hook may generate an Command not found error. If so, create a startup file and add the following content (this example is given for Linux or macOS when using nvm):

# This loads nvm.sh and sets the correct PATH before running hook
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

For more details, see

📃 License

bpmn-visualization-addons is released under the Apache 2.0 license.
Copyright © 2023-present, Bonitasoft S.A.

🚀 Release how-to

When all updates have been completed, you are ready to publish a new release.

Go to the release workflow in GitHub Actions and run it by choosing the type of release.

This workflow:

Manage Milestone:

The release workflow has initiated a new draft GitHub release, which needs to be updated and published :

⚡ Powered by

<img src="packages/demo/public/assets/github-logo.svg" alt="GitHub logo" title="GitHub Pages" width="110"/>

GitHub Pages (<kbd>demo</kbd> live environment)

<img src="https://surge.sh/images/logos/svg/surge-logo.svg" alt="surge.sh logo" title="surge.sh" width="110"/>

surge.sh (<kbd>demo</kbd> preview environment)