changesets-changelog-github-local

A changelog generator for changesets that adds GitHub repository links to commits and pull requests, improving the readability of your changelogs. This package works without network requests to the GitHub API (instead it uses git).

!NPM Version !NPM Downloads

Installation

``bash


npm


npm install --save-dev changesets-changelog-github-local
`

`bash


yarn


yarn add --dev changesets-changelog-github-local
`

`bash


pnpm


pnpm add --save-dev changesets-changelog-github-local
`

Usage

Add the changelog generator to your .changeset/config.json file:

`json
{
"changelog": ["changesets-changelog-github-local", { "repo": "owner/repo" }]
}
`

Replace "owner/repo" with your GitHub repository identifier (for example, "LekoArts/changesets-changelog-github-local").

> [!IMPORTANT]
> Best practice: Use squash merging for your pull requests. This ensures PR numbers are consistently included in commit messages, which helps this changelog generator create better links to your pull requests.
> Alternatively you need to make sure that PR numbers (in the format (#123)) are at the end of the first line of your commit message.

$3

- Links to commits and pull requests in your changelogs
- Works without requiring GitHub API requests
- Extracts PR numbers from commit messages
- Shortens commit hashes for better readability

$3

`markdown


1.2.0

$3

- Added new feature (#123)

$3

- Fixed bug in API handling (a1b2c3d)
- Updated dependencies [e7f8g9h]:
- dependency-package@2.0.0
`

Development

- Install dependencies:

`bash
pnpm install
`

- Run the unit tests:

`bash
pnpm test
`

- Build the library:

`bash
pnpm build
`

License

MIT

Acknowledgements

- changelog-github
- changelog-github-compact`