Nyron

nyron bump

Bump project version and generate changelog

nyron bump

Bump project version and generate changelog automatically.

Usage

npx @nyron/cli bump --type <type> --prefix <prefix>

Required Options

-t, --type <type>

Required. The type of version bump to perform.

Values:

  • major - For breaking changes (e.g., 1.0.0 → 2.0.0)
  • minor - For new features (e.g., 1.0.0 → 1.1.0)
  • patch - For bug fixes (e.g., 1.0.0 → 1.0.1)
npx @nyron/cli bump --type minor --prefix v

-x, --prefix <prefix>

Required. Tag prefix from your configuration file.

For single packages:

npx @nyron/cli bump --type minor --prefix v

For monorepo packages:

npx @nyron/cli bump --type patch --prefix @myapp/api@

What It Does

When you run nyron bump, it performs the following steps:

  1. Increments the version in .nyron/meta.json for the specified package prefix
  2. Records the version in .nyron/versions.json to track version history
  3. Updates package.json version in the project directory to match the new version
  4. Synchronizes version information across all three files to ensure consistency

The command coordinates between the meta version system (.nyron/meta.json) and the versions tracking system (.nyron/versions.json) to ensure consistency across your monorepo, then updates the actual package.json file with the new version.

Examples

Bump a minor version

npx @nyron/cli bump --type minor --prefix v

This will:

  • Change version from 1.0.0 to 1.1.0
  • Update .nyron/meta.json with the new version
  • Add the new version to .nyron/versions.json history
  • Update package.json in the project directory

Bump a patch version for a monorepo package

npx @nyron/cli bump --type patch --prefix @workspace/api@

Bump a major version (breaking changes)

npx @nyron/cli bump --type major --prefix v

Changelog Generation

The changelog is automatically generated based on your commit history. It groups commits into:

  • Features - New features (feat: commits)
  • Bug Fixes - Bug fixes (fix: commits)
  • Chores - Maintenance tasks (chore:, docs:, refactor:, etc.)

Learn more about how Nyron works.

After Bumping

After running bump, you should:

  1. Review the generated changelog
  2. Commit the changes:
    git add .
    git commit -m "chore: bump version to x.y.z"
  3. Create a tag using nyron tag
  4. Push your changes and tags

See the full workflow guide for details.