build(hooks): add conventional commits git hook and make target

Author: le4ker

Makefile

@@ -97,12 +97,21 @@ install-windows:
 		echo "- Hack Nerd Font"; \
 	fi
 
+# Install git hooks
+.PHONY: hooks
+hooks:
+	@echo "Installing git hooks..."
+	@cp scripts/commit-msg .git/hooks/commit-msg
+	@chmod +x .git/hooks/commit-msg
+	@echo "Git hooks installed successfully."
+
 # Help target
 .PHONY: help
 help:
 	@echo "Available targets:"
-	@echo "  install     - Install dependencies for the detected OS"
+	@echo "  install         - Install dependencies for the detected OS"
 	@echo "  install-macos   - Install dependencies for macOS (requires Homebrew)"
 	@echo "  install-linux   - Install dependencies for Linux (apt/yum/pacman)"
 	@echo "  install-windows - Install dependencies for Windows (Chocolatey/Scoop)"
-	@echo "  help        - Show this help message"
+	@echo "  hooks           - Install git hooks for conventional commits"
+	@echo "  help            - Show this help message"

README.md

@@ -118,6 +118,30 @@ NVIM_APPNAME=le4ker/NvMegaChad nvim
 | Vimscript             | [vim-language-server](https://github.com/iamcco/vim-language-server)                                                                     | —                                                                                | —                                                          | —                                               |
 | SQL                   | —                                                                                                                                        | [sql-formatter](https://github.com/sql-formatter-org/sql-formatter)              | —                                                          | —                                               |
 
+## 🛠️ Development
+
+### Git Hooks Setup
+
+This repository uses [Conventional Commits](https://www.conventionalcommits.org/). To enforce this on your local clone, run:
+
+```sh
+make hooks
+```
+
+This installs a commit-msg hook that validates your commit messages follow the format:
+
+```
+<type>(<scope>): <description>
+```
+
+**Allowed types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
+
+**Examples:**
+
+- `feat(mappings): add new keybinding for terminal`
+- `fix(lsp): resolve null reference error`
+- `docs: update README`
+
 ## 📄 License
 
 See [LICENSE](LICENSE) for details.

scripts/commit-msg

@@ -0,0 +1,16 @@
+#!/bin/sh
+commit_regex='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .{1,}'
+
+if ! grep -qE "$commit_regex" "$1"; then
+  echo "ERROR: Commit message does not follow Conventional Commits format."
+  echo ""
+  echo "Format: <type>(<scope>): <description>"
+  echo ""
+  echo "Types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert"
+  echo ""
+  echo "Examples:"
+  echo "  feat(mappings): add new keybinding for terminal"
+  echo "  fix(lsp): resolve null reference error"
+  echo "  docs: update README"
+  exit 1
+fi