# conventional-recommended-bump

> Get a recommended version bump based on conventional commits.

Latest version **12.1.0** (published 2026-07-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install conventional-recommended-bump
pnpm add conventional-recommended-bump
yarn add conventional-recommended-bump
bun add conventional-recommended-bump
```

Provides the command `conventional-recommended-bump`.

## Health

**Score 63/100 (C)** — status: active.

Positive: has types package; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 12.1.0 |
| Published | 2026-07-09 |
| First published | 2015-06-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/conventional-recommended-bump) |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 5 |
| Unpacked size | 42.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8507 |
| Author | Steve Mao |
| Maintainers | bcoe, oss-bot, dangreen, stevemao, tapppi |
| Keywords | conventional-recommended-bump, recommend, conventional, bump |

## Links

- npm: https://www.npmjs.com/package/conventional-recommended-bump
- Repository: https://github.com/conventional-changelog/conventional-changelog
- Homepage: https://conventional-changelog.js.org/version-bump/
- Issues: https://github.com/conventional-changelog/conventional-changelog/issues
- npm.io page: https://npm.io/package/conventional-recommended-bump

## Dependencies (5)

- [argue-cli](https://npm.io/package/argue-cli.md) ^3.1.0
- [conventional-commits-filter](https://npm.io/package/conventional-commits-filter.md) ^6.0.1
- [conventional-commits-parser](https://npm.io/package/conventional-commits-parser.md) ^7.1.0
- [@conventional-changelog/git-client](https://npm.io/package/@conventional-changelog/git-client.md) ^3.1.0
- [conventional-changelog-preset-loader](https://npm.io/package/conventional-changelog-preset-loader.md) ^6.0.1

## Recent versions

- 12.1.0 (latest) — 2026-07-09
- 6.0.11 (next) — 2020-11-05
- 12.0.1 — 2026-07-04
- 12.0.0 — 2026-06-26
- 11.2.0 — 2025-06-07
- 11.1.0 — 2025-05-19
- 11.0.0 — 2025-02-16
- 10.0.0 — 2024-05-03
- 9.0.0 — 2023-09-08
- 8.0.0 — 2023-08-27
- 7.0.1 — 2023-06-06
- 7.0.0 — 2023-06-06
- 6.1.0 — 2020-12-30
- 6.0.12 — 2020-12-30
- 6.0.10 — 2020-08-12
- … 40 more at https://npm.io/package/conventional-recommended-bump/versions

## README

# conventional-recommended-bump

[![ESM-only package][package]][package-url]
[![NPM version][npm]][npm-url]
[![Node version][node]][node-url]
[![Dependencies status][deps]][deps-url]
[![Install size][size]][size-url]
[![Build status][build]][build-url]
[![Coverage status][coverage]][coverage-url]

[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
[package-url]: https://nodejs.org/api/esm.html

[npm]: https://img.shields.io/npm/v/conventional-recommended-bump.svg
[npm-url]: https://npmjs.com/package/conventional-recommended-bump

[node]: https://img.shields.io/node/v/conventional-recommended-bump.svg
[node-url]: https://nodejs.org

[deps]: https://img.shields.io/librariesio/release/npm/conventional-recommended-bump
[deps-url]: https://libraries.io/npm/conventional-recommended-bump

[size]: https://packagephobia.com/badge?p=conventional-recommended-bump
[size-url]: https://packagephobia.com/result?p=conventional-recommended-bump

[build]: https://img.shields.io/github/actions/workflow/status/conventional-changelog/conventional-changelog/tests.yaml?branch=master
[build-url]: https://github.com/conventional-changelog/conventional-changelog/actions

[coverage]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master

Get a recommended version bump based on conventional commits.

## Install

```bash
# pnpm
pnpm add conventional-recommended-bump
# yarn
yarn add conventional-recommended-bump
# npm
npm i conventional-recommended-bump
```

## Usage

```js
import { Bumper } from 'conventional-recommended-bump'

const bumper = new Bumper().loadPreset('angular')
const recommendation = await bumper.bump()

console.log(recommendation.releaseType) // 'major'
```

CLI is also available:

```sh
conventional-recommended-bump --help
```

## Documentation

For comprehensive guides, CLI options, and API reference, visit the [documentation website](https://conventional-changelog.js.org/version-bump/).

## License

MIT © [Steve Mao](https://github.com/stevemao)

---
_Source: https://npm.io/package/conventional-recommended-bump · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._