beachball
Home
Getting started
GitHub
Home
Getting started
GitHub
  • Overview

    • Getting started
    • Installation
    • Configuration
  • Concepts

    • Bump algorithm
    • Change files
    • CI integration
    • Groups
  • CLI commands

    • Common options
    • bump
    • change
    • check
    • publish
    • sync

check

It's recommended to enforce that change files are included with each PR. This way, all changes are captured and affect semver appropriately.

To ensure that all changes are captured in change files, simply run:

$ beachball check

This command also checks for misconfigurations that would result in problems when attempting to publish.

Options

Options

General options also apply for this command.

OptionDefaultDescription
--changehint'Run "beachball change" to create a change file'Hint message if the developer forgot to add a change file.
--disallow-deleted-change-filesfalseverifies that no change files were deleted between head and target branch

Where should check be run?

As a step in the PR review gate

See the change files page for how to set this up.

Not recommended: as a git hook

While running beachball check as a pre-push hook may seem appealing, it has some downsides: it will substantially slow down running git push and could be annoying when pushing work-in-progress changes to remote branches. Our experience with repos enabling this hook is that it will quickly be removed due to developer feedback.

If you want to try this, take a look at this documentation about git hooks.

Last Updated:: 6/4/25, 1:22 AM
Contributors: dependabot[bot]
Prev
change
Next
publish