---
title: "Writing Better Commits with Conventional Commits"
url: "https://ridwaanhall.com/blog/nail-your-git-game-with-conventional-commits"
markdown: "https://ridwaanhall.com/blog/nail-your-git-game-with-conventional-commits.md"
summary: "Clear commit messages tell your code’s story. How Conventional Commits give them a consistent shape."
---

# Writing Better Commits with Conventional Commits

> Clear commit messages tell your code’s story. How Conventional Commits give them a consistent shape.

- By Ridwan Halim, Apr 3, 2025
- Developer Practices; 1 min read
- Tags: Conventional Commits, Commit Style, Developer Experience, Team Collaboration

Version control is the backbone of modern software development, and well-structured commit messages are essential for maintaining clean, understandable project histories. Conventional Commits provide a standardized format that enhances collaboration, automates versioning, and makes codebases more maintainable for teams of all sizes.

## Understanding Conventional Commits

Commits aren't just logs, they're your code's epic saga. Conventional Commits keep it clean and fun. Here's the playbook to slay it:

### Core Commit Types and Their Usage

- **✨ feat:** Drop something new and shiny! Like: `feat: add user login flow`
- **🛠️ fix:** Squash bugs like a boss. Like: `fix: patch login glitch`
- **📝 docs:** Make your docs sparkle. Like: `docs: beef up API guide`
- **🎨 style:** Keep it pretty, no logic changes. Like: `style: tidy up CSS`
- **🔄 refactor:** Revamp code for max vibes. Like: `refactor: streamline DB calls`
- **🧪 test:** Lock in those tests. Like: `test: add auth unit tests`
- **⚡ perf:** Speed things up, wow factor! Like: `perf: optimize image load`
- **🤖 ci:** Keep CI humming. Like: `ci: tweak GitHub Actions`
- **🛠️ build:** Solidify your setup. Like: `build: update webpack`
- **🚧 chore:** Handle the grunt work. Like: `chore: bump dependencies`
- **⏪ revert:** Hit rewind when needed. Like: `revert: undo buggy commit`

## Benefits of Conventional Commits

Adopting Conventional Commits offers numerous advantages for development teams. The standardized format enables automatic changelog generation, simplifies semantic versioning decisions, and provides clear context for code changes. This approach makes repository histories more navigable and helps new team members understand project evolution more quickly.

## Elsewhere

- This page for people: https://ridwaanhall.com/blog/nail-your-git-game-with-conventional-commits
- Index of every page as Markdown: [llms.txt](https://ridwaanhall.com/llms.txt)
