version bump

Update project version and create tag easily

Overview

A lightweight Node.js utility to bump semantic versions in manifest files (package.json, jsr.json,deno.json) and optionally create Git tags for releases.

Installation

# via npm
npm install @tenedev/version-bump

# via yarn
yarn add @tenedev/version-bump

# via pnpm
pnpm add @tenedev/version-bump

# via bun
bun add @tenedev/version-bump

# via Deno (using JSR)
deno add jsr:@tene/version-bump

# via JSR
npx jsr add @tene/version-bump

Usage

CLI

Add a script in your package.json:

"scripts": {
    "release": "npx @tene/version-bump"
}

Then run:

npm run release --type minor --tag --fullTag

Options

| Flag | Type | Default | Description | | -------------- | ------- | ------------------------------- | ----------------------------------------------------------------------------------------- | | --type | string | "patch" | Release type: major, minor, patch, premajor, preminor, prepatch, prerelease | | --preRelease | string | null | Pre-release identifier: alpha, beta, rc, next, etc. | | -m | string | "chore: release v\${version}" | Commit message template (\${version}, \${major}, \${minor}, etc. supported) | | --tag | boolean | false | Create Git tag(s) after bumping | | --fullTag | boolean | true | Create full version tag (v1.2.3) | | --major | boolean | false | Create v1 tag | | --minor | boolean | false | Create v1.2 tag | | --dry-run | boolean | false | Print what would happen without changing files or running Git commands |

Examples

1. Bump a patch version (default)

npm run release
# from 1.2.3 → 1.2.4

2. Bump a minor version and create tags

npm run release --type minor --tag --major --minor
# from 1.2.3 → 1.3.0
# creates tags: v1, v1.3, v1.3.0

3. Create a beta prerelease

npm run release --type prerelease --preRelease beta --tag
# from 1.2.3 → 1.2.4-beta.0
# creates tag: v1.2.4-beta.0

4. Dry run (no changes, just logs)

npm run release --type minor --dry-run

Programmatic API

You can also use it directly in your Node.js scripts:

import { run, versionBump, formatCommitMessage } from 'version-bump-tool';

// bump only
const next = versionBump('1.2.3', 'minor');
// → "1.3.0"

// format commit messages
const msg = formatCommitMessage('release: v${version}', '1.3.0');
// → "release: v1.3.0"

// full run (bump + git tags)
const bumped = run('minor', undefined, true, {
  commitMessage: 'release: v${version}',
  fullTag: true,
  major: true,
  minor: true,
});
// updates files + creates Git tags

Supported Files

• package.json (npm)
• jsr.json (JSR packages)
• deno.json (Deno)

License

Released under the Apache-2.0 License.