Zero Config
Works out of the box. Just add the workflow file and you're done.
@sylphx/bumpModern Release Automation
Conventional commits in, semantic versions out. Zero config.
Skip to content
Conventional Commits
feat: = minor, fix: = patch, feat!: = major. That's it.
Automatic Release PRs
Preview changes before publishing. Merge when ready.
Monorepo Native
File-based detection, independent versioning, cascade bumps.
Workspace Protocol
Auto-resolves workspace:* dependencies at publish time.
Pre-releases
Alpha, beta, RC support via bump files.
Quick Start
1. Add the workflow
Create .github/workflows/release.yml:
yaml
name: Release
on:
push:
branches: [main]
permissions:
contents: write
pull-requests: write
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: SylphxAI/bump@v1
with:
github-token: $\{{ secrets.GITHUB_TOKEN }}
npm-token: $\{{ secrets.NPM_TOKEN }}2. Add NPM_TOKEN secret
- Go to npmjs.com → Access Tokens → Generate New Token
- Go to your repo → Settings → Secrets → Actions → New repository secret
- Name:
NPM_TOKEN, Value: your token
3. Done!
Push a commit and watch the magic happen.
Why bump?
| bump | changesets | |
|---|---|---|
| Setup | 1 workflow file | Multiple config files + bot |
| Workflow | Just commit | Create changeset file per change |
| Version control | Automatic from commits | Manual per-changeset |
| Learning curve | Know conventional commits? Done | New syntax + tooling |
| Workspace protocol | Auto-resolved | Manual handling required |