Have ideas to improve npm?Join in the discussion! »

    gitmoji-changelog

    2.2.0 • Public • Published

    gitmoji-changelog

    Generate changelog for repositories using gitmoji commits convention.

    Prerequisites:

    • use gitmoji for commits convention
    • use semver for versions and tags convention

    Quick start

    npm install -g gitmoji-changelog
    
    cd my-project
    
    gitmoji-changelog

    If CHANGELOG.md file doesn't exist, it will generate all previous changelog based on semver tags of your repo.

    If CHANGELOG.md file already exists, this will not overwrite any previous changelog, it will generate a changelog based on commits since the last semver tag that match.

    All available commands and parameters can be listed using: gitmoji-changelog --help

    Here an example output: CHANGELOG.md

    Workflow

    Here the recommended workflow to generate your changelog file using gitmoji-changelog:

    Important: Before generating, be sure to have all tags locally (e.g. git fetch origin)

    1. Make changes and commit: git commit -m ":sparkles: my awesome feature"
    2. Bump version (ex: 1.0.0) in package.json using semver convention
    3. Run gitmoji-changelog, then the file CHANGELOG.md is created or updated with all changes
    4. You can freely edit the new release in the changelog file, it will not be overwrite with the next generation
    5. Commit package.json and CHANGELOG.md file
    6. Tag your release: git tag -a v1.0.0 -m "v1.0.0" (or create a Github release)
    7. Push to the remote git push

    Usage

    gitmoji-changelog --help

    Install

    npm i gitmoji-changelog

    DownloadsWeekly Downloads

    2,635

    Version

    2.2.0

    License

    MIT

    Unpacked Size

    31.5 kB

    Total Files

    14

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar