---
title: "Commit Message Style Guide"
url: "https://ridwaanhall.com/blog/commit-message-style-guide"
markdown: "https://ridwaanhall.com/blog/commit-message-style-guide.md"
summary: "A practical guide to writing expressive and consistent commit messages using emojis, types, scopes, and summaries. This format improves readability, collaboration, and branding across projects."
---

# Commit Message Style Guide

> A practical guide to writing expressive and consistent commit messages using emojis, types, scopes, and summaries. This format improves readability, collaboration, and branding across projects.

- By Ridwan Halim, Jan 23, 2026
- Technology & Community; 1 min read
- Tags: Commit Style, Conventional Commits, Developer Experience, Team Collaboration

Commit messages are more than just notes, they are a communication tool. By using emojis and a consistent format, teams can quickly understand the purpose of each commit while keeping the history fun and easy to scan.

We follow this pattern for commit messages:

`[emoji][type](scope): summary`

EmojiTypeTaglineExample✨featDrop something new and shiny✨feat(contact-form): Add auto-reply with HTML + text templates🐛fixSquash bugs like a boss🐛fix(auth): Resolve token expiration issue causing login failures📝docsMake your docs sparkle📝docs(api): Add usage examples for public endpoints🎨styleKeep it pretty, no logic changes🎨style(ui): Adjust button spacing and update color palette🔄refactorRevamp code for max vibes🔄refactor(database): Streamline query logic for better readability🧪testLock in those tests🧪test(user): Add unit tests for profile update flow⚡perfSpeed things up, wow factor⚡perf(images): Optimize image loading for faster rendering🤖ciKeep CI humming🤖ci(github-actions): Tweak workflow for parallel jobs🛠️buildSolidify your setup🛠️build(config): Update webpack settings for production🚧choreHandle the grunt work🚧chore(deps): Bump dependencies to latest stable versions⏪revertHit rewind when needed⏪revert(auth): Undo faulty commit causing login errors
This style guide ensures that commit history remains structured and expressive. Each emoji provides instant context, while the type and scope clarify the exact purpose.

## Elsewhere

- This page for people: https://ridwaanhall.com/blog/commit-message-style-guide
- Index of every page as Markdown: [llms.txt](https://ridwaanhall.com/llms.txt)