release
Publish a new Sentry JavaScript SDK release. Use when preparing a release, updating the changelog, or creating a release branch.
Source facts
- Repository
- getsentry/sentry-javascript
- Last source activity
- October 19, 2026 at 06:56
- Detected SKILL.md language
- English
- Stars
- 8,769
- Forks
- 1,878
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- release
- description
- Publish a new Sentry JavaScript SDK release. Use when preparing a release, updating the changelog, or creating a release branch.
- argument-hint
- ["VERSION"]
# Release Process
See `docs/publishing-a-release.md` for full details.
## Steps
1. Ensure you're on `develop` with latest changes. Stash any unsaved work with `git stash -u` if needed.
2. Run `pnpm run changelog` (use `pnpm run changelog | pbcopy` to copy output).
3. Decide on a version per [semver](https://semver.org). Check the top of `CHANGELOG.md` for the current version.
4. Create branch `prepare-release/VERSION` off `develop`.
5. Update `CHANGELOG.md` — add the new version entry with the changelog output. See the "Updating the Changelog" section in `docs/publishing-a-release.md` for formatting details. Do not remove existing entries.
6. Commit: `meta(changelog): Update changelog for VERSION`
7. Push the branch and remind the user to open a PR targeting `master`.
8. If you were on a different branch, checkout back and `git stash pop` if needed.
## First-time SDK releases
Follow `docs/new-sdk-release-checklist.md`. If anything doesn't match the checklist, remind the user.
## Key commands
- `pnpm run changelog` — generate changelog entries
- `pnpm run lint` — verify code quality
- `pnpm run test` — run test suite
- `pnpm run build:dev` — verify build
View on GitHub