{"id":26881861,"url":"https://github.com/process-analytics/bpmn-visualization-addons","last_synced_at":"2025-10-28T00:02:06.411Z","repository":{"id":182087498,"uuid":"667261588","full_name":"process-analytics/bpmn-visualization-addons","owner":"process-analytics","description":"Add-ons for `bpmn-visualization`.","archived":false,"fork":false,"pushed_at":"2025-05-07T05:00:39.000Z","size":2186,"stargazers_count":4,"open_issues_count":35,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-07T06:18:54.245Z","etag":null,"topics":["addons","bpmn","extensions","hacktoberfest","plugins","typescript","visualization"],"latest_commit_sha":null,"homepage":"https://process-analytics.github.io/bpmn-visualization-addons/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/process-analytics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-17T05:41:53.000Z","updated_at":"2025-05-07T05:00:42.000Z","dependencies_parsed_at":"2024-01-24T08:31:09.331Z","dependency_job_id":"e44d3fc1-8261-4e5d-bedd-eaf325248a85","html_url":"https://github.com/process-analytics/bpmn-visualization-addons","commit_stats":null,"previous_names":["process-analytics/bv-experimental-add-ons","process-analytics/bpmn-visualization-addons"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/process-analytics%2Fbpmn-visualization-addons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/process-analytics%2Fbpmn-visualization-addons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/process-analytics%2Fbpmn-visualization-addons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/process-analytics%2Fbpmn-visualization-addons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/process-analytics","download_url":"https://codeload.github.com/process-analytics/bpmn-visualization-addons/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252824320,"owners_count":21809748,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["addons","bpmn","extensions","hacktoberfest","plugins","typescript","visualization"],"created_at":"2025-03-31T15:58:47.950Z","updated_at":"2025-10-28T00:02:01.370Z","avatar_url":"https://github.com/process-analytics.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ebpmn-visualization-addons\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cp align=\"center\"\u003e \n        \u003ca href=\"https://npmjs.org/package/@process-analytics/bpmn-visualization-addons\"\u003e\n          \u003cimg alt=\"npm package\" src=\"https://img.shields.io/npm/v/@process-analytics/bpmn-visualization-addons.svg?color=orange\"\u003e \n        \u003c/a\u003e \n        \u003ca href=\"https://github.com/process-analytics/bpmn-visualization-addons/releases\"\u003e\n          \u003cimg alt=\"GitHub release (latest by date including pre-releases)\" src=\"https://img.shields.io/github/v/release/process-analytics/bpmn-visualization-addons?label=changelog\u0026include_prereleases\"\u003e \n        \u003c/a\u003e \n        \u003ca href=\"https://process-analytics.github.io/bpmn-visualization-addons/\"\u003e\n          \u003cimg alt=\"Live Demo\" src=\"https://img.shields.io/badge/demo-online-blueviolet.svg\"\u003e \n        \u003c/a\u003e \n        \u003ca href=\"https://github.com/process-analytics/bpmn-visualization-addons/actions\"\u003e\n          \u003cimg alt=\"Build\" src=\"https://github.com/process-analytics/bpmn-visualization-addons/workflows/Build/badge.svg\"\u003e \n        \u003c/a\u003e\n        \u003ca href=\"https://sonarcloud.io/project/overview?id=process-analytics_bpmn-visualization-addons\"\u003e\n          \u003cimg alt=\"Code Smells\" src=\"https://sonarcloud.io/api/project_badges/measure?project=process-analytics_bpmn-visualization-addons\u0026metric=code_smells\"\u003e\n        \u003c/a\u003e\n        \u003cbr\u003e\n        \u003ca href=\"https://github.com/process-analytics/.github/blob/main/CODE_OF_CONDUCT.md\"\u003e\n          \u003cimg alt=\"Contributor Covenant\" src=\"https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg\"\u003e \n        \u003c/a\u003e \n        \u003ca href=\"LICENSE\"\u003e\n          \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/process-analytics/bpmn-visualization-addons?color=blue\"\u003e \n        \u003c/a\u003e\n    \u003c/p\u003e\n\u003c/div\u003e  \n\u003cbr\u003e\n\n\n## 🔆 Presentation\n\n`bpmn-visualization-addons` offers new functionalities to [bpmn-visualization](https://github.com/process-analytics/bpmn-visualization-js) in the form of addons.\n\n`bpmn-visualization-addons` is being actively developed.\nBefore the release of version `1.0.0`, there may be some breaking changes.\n\n\u003c!--\nWe avoid these as much as possible, and carefully document them in the release notes.\nAs far as possible, we maintain compatibility for some minor versions.\n--\u003e\n\n\n## 🎨 Features and Usage\n\nSee the dedicated [README](packages/addons/README.md).\n\nA live demo is available at ⏩ https://process-analytics.github.io/bpmn-visualization-addons/.\nThe sources of the demo are available in the [demo](./packages/demo) folder.\n\n\n## ⚒️ Development Setup\n\nUse the node version declared in [.nvmrc](.nvmrc). You can use a Node version manager like [nvm](https://github.com/nvm-sh/nvm): `nvm use`\n\nThis project uses [npm workspaces](https://docs.npmjs.com/cli/v9/using-npm/workspaces).\n\nInstall dependencies: `npm install`\n\nDevelop the lib and live update the demo: run `npm run dev:demo`. The demo is accessible at http://localhost:5173/\n\n### Husky settings when using Node Version Managers\n\nHusky runs the pre-commit hook before each commit to ensure that the code meets the standards.\n\nOn commit, if you use a Node Manager, the pre-commit hook may generate an `Command not found` error.\nIf so, create a [startup file](https://typicode.github.io/husky/how-to.html#startup-files) and add the following content (this example is given for Linux or macOS when using nvm):\n```bash\n# This loads nvm.sh and sets the correct PATH before running hook\nexport NVM_DIR=\"$HOME/.nvm\"\n[ -s \"$NVM_DIR/nvm.sh\" ] \u0026\u0026 \\. \"$NVM_DIR/nvm.sh\"\n```\n\nFor more details, see\n- https://typicode.github.io/husky/how-to.html#node-version-managers-and-guis\n- https://github.com/typicode/husky/issues/912\n\n\n\n## 📃 License\n\n`bpmn-visualization-addons` is released under the [Apache 2.0](LICENSE) license.  \nCopyright \u0026copy; 2023-present, Bonitasoft S.A.\n\n\n## 🚀 Release how-to\n\nWhen all updates have been completed, you are ready to publish a new release.\n\n### Release preparation\n\nDecide on the new version depending on the type of changes:\n- Follow [semver](https://semver.org/)\n- Check the new commits since the latest release to determine the type of changes included in the new version. This can be done by:\n  - running locally `git log --oneline \u003clatest-release-tag\u003e..HEAD`\n  - going the [latest GitHub release page](https://github.com/process-analytics/bpmn-visualization-addons/releases/latest) and checking the commits since this release (a link is available just above the release title).\n- Until we release the first major version, bump the minor version if the release contains new features or breaking changes.\n\nA GitHub release is published as part of the release process, and it includes an auto-generated release notes which is based on the labels of the merged Pull Requests:\n- Label all merged PRs in the release. Check [unlabeled PRs](https://github.com/process-analytics/bpmn-visualization-addons/pulls?q=is%3Apr+sort%3Aupdated-desc+no%3Alabel+is%3Amerged) to add missing labels.\n  - Ensure that all PRs related to bump production dependencies (e.g., `bpmn-visualization`) do not have the `skip-changelog` label. Otherwise, they are not included in the changelog.\n    Find such PRs here: [bump prod dependency PR with skip-changelog label](https://github.com/process-analytics/bpmn-visualization-addons/pulls?q=is%3Apr+is%3Amerged+%22chore%28deps%29%22+in%3Atitle+NOT+%22chore%28deps-dev%29%22+in%3Atitle+label%3Askip-changelog+).\n\n**Note**: Currently, dependabot can't apply different labels to production and development dependency update PRs, so labels must be checked manually.\nFor more details, see the [dependabot labels documentation](https://docs.github.com/en/code-security/dependabot/working-with-dependabot/dependabot-options-reference#labels--).\n\n### Perform the Release\n\nGo to the [release workflow](https://github.com/process-analytics/bpmn-visualization-addons/actions/workflows/release.yml) in GitHub Actions and run it by choosing the type of release.\n\nThis workflow:\n- Creates a Git tag\n- Triggers the publishing of the npm package\n- Creates a draft GitHub release\n\nManage Milestone:\n- **Note:** we always put issues related to a version in a Milestone whose name matches the version.\n- Ensure the name of the milestone used for the new release version matches the name of the tag/version that has just been pushed. Renamed it if needed.\n- Verify that all issues related to the upcoming release are attached to the milestone. In particular, check the issues that [do not have a milestone](https://github.com/process-analytics/bpmn-visualization-addons/issues?q=is%3Aissue+is%3Aclosed+no%3Amilestone).\n- Clean this opened milestone if some issues are still opened (move them to a new one or discard milestone from them)\n- Close the milestone\n\nThe release workflow has initiated a new draft GitHub release, which needs to be updated and published :\n- For more details about GitHub release, follow the [GitHub help](https://help.github.com/en/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release):\n- The release notes has been [automatically generated](https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes). Review and adjust it if necessary.\n- Publish the GitHub release\n\n\n## ⚡ Powered by\n\n\u003cimg src=\"packages/demo/public/assets/github-logo.svg\" alt=\"GitHub logo\" title=\"GitHub Pages\" width=\"110\"/\u003e\n\n**[GitHub Pages](https://pages.github.com/)** (\u003ckbd\u003edemo\u003c/kbd\u003e live environment)\n\n\u003cimg src=\"https://surge.sh/images/logos/svg/surge-logo.svg\" alt=\"surge.sh logo\" title=\"surge.sh\" width=\"110\"/\u003e\n\n**[surge.sh](https://surge.sh)** (\u003ckbd\u003edemo\u003c/kbd\u003e preview environment)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprocess-analytics%2Fbpmn-visualization-addons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprocess-analytics%2Fbpmn-visualization-addons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprocess-analytics%2Fbpmn-visualization-addons/lists"}