release

Publish a new Sentry JavaScript SDK release. Use when preparing a release, updating the changelog, or creating a release branch.

npx skills add https://github.com/getsentry/sentry-javascript --skill release

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 yarn changelog (use yarn changelog | pbcopy to copy output).
  3. Decide on a version per semver. 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

  • yarn changelog — generate changelog entries
  • yarn lint — verify code quality
  • yarn test — run test suite
  • yarn build:dev — verify build

More skills from sentry

generate-frontend-forms
sentry
Guide for creating forms using Sentry's new form system. Use when implementing forms, form fields, validation, or auto-save functionality.
official
sentry-snapshots-cocoa
sentry
Full Sentry Snapshots setup for Apple/Cocoa projects. Use when asked to "setup SnapshotPreviews", "setup Apple snapshot testing", "upload Apple snapshots to…
official
architecture-review
sentry
Staff-level codebase health review. Finds monolithic modules, silent failures, type safety gaps, test coverage holes, and LLM-friendliness issues.
official
linear-type-labeler
sentry
Classifies Linear issues and applies a Type label from the Sentry workspace's label taxonomy based on the content of each issue's title and description.
official
sentry-flutter-sdk
sentry
Full Sentry SDK setup for Flutter and Dart. Use when asked to "add Sentry to Flutter", "install sentry_flutter", "setup Sentry in Dart", or configure error…
official
sentry-svelte-sdk
sentry
Full Sentry SDK setup for Svelte and SvelteKit. Use when asked to "add Sentry to Svelte", "add Sentry to SvelteKit", "install @sentry/sveltekit", or configure…
official
vercel-react-best-practices
sentry
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js…
official
sentry-tanstack-start-sdk
sentry
Full Sentry SDK setup for TanStack Start React. Use when asked to "add Sentry to TanStack Start", "install @sentry/tanstackstart-react", or configure error…
official