Comparison
ReleaseJet vs the alternatives.
Most release-notes tools — release-please, semantic-release, changie— assume the same workflow: Conventional Commits or commit-derived fragments, monorepo packages, GitHub-only. Here's how ReleaseJet differs — and when one of them is the better pick.
Feature comparison
| Capability | ReleaseJet | release-please | semantic-release |
|---|---|---|---|
| Multi-customer tag tracks in one repo | Yes — first-class ({prefix}-v{version}) | No — monorepo packages, path-based | No — single-package model |
| Works without Conventional Commits | Yes — label-driven | No — Conventional Commits required | No — Conventional Commits required |
| GitLab support | Yes — first-class | Limited — GitHub-first | Yes — official GitLab plugin |
| PR-based release flow | No — tag-based | Yes — release PRs are the signature | No — commit-triggered on push |
| Version bumping in package.json | No — does not touch version files | Yes — manifest-driven | Yes — bumps and publishes |
| Config complexity | Low — 1 YAML file | Manifest + per-package config | One .releaserc + plugins |
| Source of truth | Labeled issues (or merged PRs) | Commit history (Conventional Commits) | Commit history (Conventional Commits) |
When ReleaseJet is the better choice
Pick ReleaseJet when:
- You have one repo serving multiple customers and need per-customer release notes. Most alternatives have no primitive for this.
- Your team doesn't write Conventional Commits and you don't want to start. We use labels on issues as the source of truth.
- You're on GitLab— not every tool treats both providers as first-class; we do.
- You want polished release notes, not developer changelogs — categorized, readable, customer-facing.
How to migrate
- Remove your current release-automation config files from the repo.
- Install ReleaseJet:
npm install -g @makispps/releasejet. - Run
releasejet initto generate.releasejet.yml. - Make sure your issues are labeled (categories like
feature,bug,improvementper your config). - Add a GitHub Action step:
- uses: makisp/releasejet@v1 with: tag: ${{ github.ref_name }} token: ${{ secrets.GITHUB_TOKEN }} - Push a tag. Done.
Need more detail on any step?Read the full setup guide
Quick Install