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
Plans
Every plan and priceBeachball
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.