git conventional-commits changelog release-automation

Subhro Kar

Published on April 2, 2023

Introduction

Keeping a clean and organized Git workflow is super important for any software project, especially as it becomes more complex.

I've written a detailed post on essential GitHub resources that every developer should know. Check out the full article on Essential GitHub Resources to enhance your GitHub skills.

This blog post will explore setting up a robust system that leverages Conventional Commits, Changelog generation, and Release automation to streamline your development process.

Conventional Commits

Visit the official specification for more details.

Conventional Commits are a standardized way of writing commit messages that provide structure and consistency to your project's commit history.

It helps you create more readable and meaningful commit messages, which in turn improves the overall quality of your project's commit history.

The Conventional Commits specification outlines a set of rules for creating commit messages, including:

• A type field that describes the nature of the change (e.g., feat for a new feature, fix for a bug fix)
• A scope field that identifies the area of the codebase affected by the change (optional)
• A description field that briefly explains the change
• Additional fields for breaking changes and references to related issues or pull requests

Types of Commits

Conventional Commits defines several types of commits, each with its purpose and meaning. Here are the main types:

Setting up Conventional Commits

Create a commitlint.config.js file in your project root with the following content:

Install and initialize Husky, a tool that helps manage Git hooks:

Create a .husky/commit-msg file with the following content:

Update your package.json file to include the prepare script:

Run the prepare script to ensure Husky is set up:

Now, the commitlint hook will validate your commit message against the Conventional Commits specification whenever you try to make a commit.

Commitizen

Commitizen is a tool that helps you write Conventional Commit messages. It provides a command-line interface that guides you through the process of creating a commit message, ensuring that it adheres to the Conventional Commits specification.

Using Commitizen can help you avoid common mistakes and ensure that your commit messages are consistent across your project.

When you run npm run commit using Commitizen, it typically provides an interactive menu that looks something like this:

Setting up Commitizen

1. Install the necessary dependencies:

   1npm install --save-dev cz-conventional-changelog 2

2. Initialize Commitizen:

   1npx commitizen init cz-conventional-changelog --save-dev --save-exact 2

   This will add the necessary configuration to your package.json file.

3. Add a commit script to your package.json:

   1"scripts": { 2 "prepare": "husky", 3 "commit": "cz" 4} 5

Now, whenever you need to make a commit, you can runnpm run committo use the Commitizen CLI, which will guide you through writing a Conventional Commit message.

Generating a Changelog

To automatically generate a changelog based on your Conventional Commits, we'll use the release-it plugin:

1. Install the necessary dependencies:

   1npm install --save-dev @release-it/conventional-changelog release-it 2

2. Create a .release-it.json file in your project root with the following configuration:

   1{ 2 "git": { 3 "commitMessage": "chore: release v${version}" 4 }, 5 "github": { 6 "release": true 7 }, 8 "npm": { 9 "publish": false 10 }, 11 "plugins": { 12 "@release-it/conventional-changelog": { 13 "preset": "angular", 14 "infile": "CHANGELOG.md" 15 } 16 } 17} 18

3. Add a release script to your package.json:

   1"scripts": { 2 "prepare": "husky", 3 "commit": "cz", 4 "release": "release-it" 5} 6

Now, when you run npm run release, the tool will automatically generate a changelog based on your Conventional Commits and create a new GitHub release.

Automating Releases

To further streamline your release process, you can use thestandard-versiontool, which automates version bumping and changelog generation:

1. Install the necessary dependencies:

   1npm install --save-dev standard-version 2

2. Add a release script to your package.json:

   1"scripts": { 2 "release": "standard-version" 3} 4

3. Run the release script:

   1npm run release 2

   This will:

   • Bump the version in your package.json file
   • Generate a changelog based on your Conventional Commits
   • Commit the changes
   • Create a new Git tag

I have created an npm package called conventional-setup-cli that brings together Conventional Commits, Changelog generation, and Release automation for your projects! 🎉

By integrating Conventional Commits, Changelog generation, and Release automation into your Git workflow, you can significantly enhance the organization and efficiency of your development process.

These practices not only ensure that your commit history is clear and meaningful but also automate tedious tasks, allowing you to focus more on writing quality code.