RELEASE_PROCESS.md

Release Process

1. Prepare Release

1. Go to: https://github.com/serverlessworkflow/editor/actions/workflows/prepare-release.yaml
2. Click "Run workflow"
3. Select the branch to release from:
   • main - for normal releases (1.0.0, 1.1.0, 2.0.0)
   • 1.0.x - for patch releases on a previous release 1.x
4. Click "Run workflow"
5. A release PR with title "chore: version packages" with a version bump will be created by the CI

2. Review and Merge

1. Review the "chore: version packages" PR
2. Check version bumps and CHANGELOGs are correct
3. Merge the PR to start publishing the new release

3. Publish (no action needed)

On merge, the publish workflow automatically (no manual action needed):

• Builds and tests packages
• Publishes to npm
• Creates git tags and GitHub releases

Check CI run at: https://github.com/serverlessworkflow/editor/actions/workflows/publish-release.yaml
GH Releases: https://github.com/serverlessworkflow/editor/releases
NPM publishing at: https://www.npmjs.com/package/@serverlessworkflow/diagram-editor?activeTab=versions

---

Branching Model

Normal Development (main branch):

• Development happens on main
• Run "Prepare Release" workflow from main branch

Maintenance Releases (X.Y.x branches):

Created only when you need to patch an old version while main has moved forward.