Need help with beachball?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

310 Stars 50 Forks MIT License 730 Commits 85 Opened issues


The Sunniest Semantic Version Bumper

Services available


Need anything else?

Contributors list


the sunniest version bumping tool


git and a remote named "origin"


beachball [command] [options]


change (default)

a tool to help create change files in the change/ folder


checks whether a change file is needed for this branch


based on change files, create changelogs and then unlinks the change files


bumps versions as well as generating changelogs


bumps, publishes to npm registry (optionally does dist-tags), and pushes changelogs back into master


synchronizes published versions of packages from a registry, makes local package.json changes to match what is published


Some of the most common options are summarized below. For details, see the pages for CLI options and config file options.

--config, -c

Explicit configuration file to use instead of the configuration automatically detected by cosmicconfig.

--registry, -r

registry, defaults to

--tag, -t

  • for the publish command: dist-tag for npm publishes
  • for the sync command: will use specified tag to set the version

--branch, -b

target branch from origin (default: master)

--message, -m

custom message for the checkin (default: applying package updates)


skip pushing changes back to git remote origin


skip publishing to the npm registry

--help, -?, -h

show help message

--yes, -y

skips the prompts for publish


  $ beachball

$ beachball check

$ beachball publish -r http://localhost:4873 -t beta

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.