Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Beachball

microsoft.github.io

  • Free plan

What Beachball is

Beachball is a free, MIT-licensed tool for JavaScript package versioning, changelog generation and npm publishing. It supports single-package repositories and monorepos and can start without extra configuration. The workflow uses `beachball change` to create change files, `beachball check` to validate them in pull requests and `beachball publish` to release packages. Change files record a change type and description for review. Publishing generates changelogs unless disabled, updates versions in the Git repository and npm registry, and can push those changes to the Git remote. Packages can be published to public or private npm registries. Documentation covers GitHub Actions, Azure Pipelines and other CI platforms. Token guidance recommends minimum permissions and release-only secrets. An included helper creates and revokes repository-scoped GitHub App installation tokens; it requires Node 22.18 or later. Installation uses npm or Yarn, or npx. If publishing partially fails, `beachball sync` aligns versions before committing. Azure DevOps lacks npm trusted publishing support, so token authentication is required there.

Who it suits

JavaScript maintainers working in single-package repositories or monorepos who want structured releases through npm and CI.

Good to know, and what to watch

  • Supports monorepos and single packages
  • No extra configuration required initially
  • Validates changes in pull requests
  • Publishes to public or private registries
  • MIT licensed and free
  • Auth helper requires Node 22.18 or later
  • Azure DevOps needs token authentication
  • Partial publish failures require sync
  • Token permissions must be managed carefully

Beachball

Free

Open source

The verdict

Beachball organizes version bumps, reviewable change files, changelogs and npm releases around a small command workflow. It fits teams using Git-based CI that can manage release credentials.

What the maker publishes

AI support
Beachball provides a change-file skill that can be installed for compatible AI agents, including GitHub Copilot and Claude Code. source
Authentication
The CI guidance recommends limiting token permissions and restricting release secrets to release builds or branches. source
Authentication utility
The package includes an auth helper that can create and revoke repository scoped GitHub App installation tokens. source
Changelogs
Beachball generates changelog files during publishing, unless changelog generation is disabled. source
Changelogs
Beachball generates changelogs when it bumps package versions. source
Change tracking
Change files record the change type and description for package updates, and reviewers can inspect them in the pull request diff. source
Configuration
Beachball works without extra configuration by default, and its homepage describes versioning as requiring no configuration to get started. source
Configuration
Beachball can be used without extra configuration by default, and supports repository and package configuration. source
Founded
2019 source
Installation
The installation guide shows npm and Yarn commands and says Beachball can also be run with npx. source
Integrations
The CI documentation describes GitHub Actions and Azure Pipelines workflows, alongside general guidance for other CI platforms. source
Integrations
The CI documentation describes using Beachball with GitHub Actions and Azure Pipelines. source
License
Beachball is MIT licensed. source
Maker
The official site identifies Microsoft as the copyright holder; it does not state headquarters or founding year on the pages reviewed. source
Notable limitation
The documentation says Azure DevOps is not supported for npm trusted publishing, so token-based authentication is needed in that case. source
Publishing
Beachball can publish packages to public or private npm registries and push version and changelog updates to the Git remote. source
Publishing limitation
If a publish fails after some package versions have reached the registry, the documentation says to run `beachball sync` and commit the changes. source
Purpose
Beachball automates semantic version bumping, changelog generation, and npm publishing for JavaScript packages. source
Purpose
Beachball automates semantic version bumps, changelog generation, and npm publishing for JavaScript packages. source
Registries
Beachball can publish packages to public or private npm registries. source
Repository support
Beachball supports single-package repositories and monorepos. source
Repository support
Beachball works with single-package repositories and monorepos. source
Runtime requirement
The auth helper requires Node 22.18 or later. source
Security guidance
For token based authentication, the CI guidance recommends minimum necessary permissions and storing tokens as secrets available only to release builds. source

Checked against the maker's pages on 11 Oct 2026.