# standard-changelog

> Generate a changelog from git metadata with Angular commit convention.

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

## Install

```sh
npm install standard-changelog
pnpm add standard-changelog
yarn add standard-changelog
bun add standard-changelog
```

Provides the command `standard-changelog`.

## Health

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

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

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 8.1.0 |
| Published | 2026-07-09 |
| First published | 2016-01-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 3 |
| Unpacked size | 9.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8511 |
| Author | Steve Mao |
| Maintainers | bcoe, oss-bot, dangreen, stevemao |
| Keywords | conventional-changelog, angular, conventional, changelog, log |

## Links

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

## Dependencies (3)

- [conventional-changelog](https://npm.io/package/conventional-changelog.md) ^8.1.0
- [conventional-changelog-angular](https://npm.io/package/conventional-changelog-angular.md) ^9.2.1
- [@conventional-changelog/git-client](https://npm.io/package/@conventional-changelog/git-client.md) ^3.1.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 8.1.0 (latest) — 2026-07-09
- 2.0.27 (next) — 2020-11-05
- 8.0.1 — 2026-07-04
- 8.0.0 — 2026-06-26
- 7.0.1 — 2025-05-19
- 7.0.0 — 2025-05-19
- 6.0.0 — 2024-05-03
- 5.0.0 — 2023-09-08
- 4.0.0 — 2023-08-27
- 3.0.0 — 2023-06-06
- 2.0.26 — 2020-08-12
- 2.0.25 — 2020-06-20
- 2.0.24 — 2020-05-08
- 2.0.23 — 2020-05-08
- 2.0.22 — 2019-12-24
- … 41 more at https://npm.io/package/standard-changelog/versions

## README

# standard-changelog

[![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/standard-changelog.svg
[npm-url]: https://npmjs.com/package/standard-changelog

[node]: https://img.shields.io/node/v/standard-changelog.svg
[node-url]: https://nodejs.org

[deps]: https://img.shields.io/librariesio/release/npm/standard-changelog
[deps-url]: https://libraries.io/npm/standard-changelog

[size]: https://packagephobia.com/badge?p=standard-changelog
[size-url]: https://packagephobia.com/result?p=standard-changelog

[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

An opinionated approach to CHANGELOG generation using angular commit conventions.

## Install

```bash
# pnpm
pnpm add standard-changelog
# yarn
yarn add standard-changelog
# npm
npm i standard-changelog
```

## Usage

```sh
standard-changelog
```

The above generates a changelog based on commits since the last semver tag that match the pattern of a "Feature", "Fix", "Performance Improvement" or "Breaking Changes".

All available command line parameters can be listed using CLI: `standard-changelog --help`.

JS API is also available:

```js
import { StandardChangelog } from 'standard-changelog'

const generator = new StandardChangelog()
  .readPackage()

generator
  .writeStream()
  .pipe(process.stdout)
```

## Documentation

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

## License

MIT

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