Git Styler is a CLI tool designed to simplify and standardize commit message styling by providing structured commit commands. It follows the conventional commit format, helping developers maintain clean, consistent, and meaningful commit histories with ease.
Writing commit messages manually often leads to inconsistencies, such as:
- Unclear or unformatted commit messages
- Inconsistent use of emojis or prefixes
- Lack of a standard format for different types of commits
Git Styler solves these issues by offering easy-to-use commands for well-structured commits, ensuring your commit history is clean, readable, and professional.
- ✅ Predefined commit types with appropriate emojis (📦 🐛 ♻️ 📖)
- ✅ Shortcut commands for quick commits (e.g.,
gfeat
,gfix
,grel
, etc.) - ✅ Automatic
git push
after committing changes - ✅ Color-coded logs for better visibility
- ✅ No extra configuration needed – works out of the box!
Install Git Styler globally to make the commands available system-wide:
npm install -g git-styler
npm install git-styler
), as the commands won't be recognized outside the project.
Git Styler introduces easy-to-remember commands for different commit types. Here are some examples:
Command | Emoji | Type |
---|---|---|
gfeat |
📦 | NEW (Feature) |
gimp |
👌 | IMPROVE (Enhancement) |
gfix |
🐛 | FIX (Bug Fix) |
gdoc |
📖 | DOC (Documentation) |
gtest |
🤖 | TEST (Testing) |
gbreak |
BREAKING (Breaking Change) | |
grel |
🦄 | RELEASE (Release) |
gref |
♻️ | REFACTOR (Refactor Code) |
Instead of writing:
git add . && git commit -m "Added a new authentication module" && git push
Simply run:
gfeat "Added a new authentication module"
🔹 This automatically formats the commit as:
git commit -m "📦 NEW: Added a new authentication module"
grel "Version 1.0.0 release"
👉 This runs:
git commit -m "🦄 RELEASE: Version 1.0.0 release" && git push
If you run into any issues, check available commands with:
git-styler --help
- commander (for CLI command handling)
- child_process (for executing git commands)
- path (for script detection)
This project is licensed under the MIT License.
Enjoy committing with style! 🚀