📝

Conventional Commit Builder

Tạo commit message chuẩn Conventional Commits v1.0.0. Chọn type (feat/fix/...), scope, breaking change, footer. Preview SemVer impact (major/minor/patch). Copy git command sẵn dùng.

Tất cả công cụ Browser-only

Type

Scope (tùy chọn)

Subject (tóm tắt)

Body (tùy chọn)

Breaking change !

Footer (Closes #1, Reviewed-by, BREAKING CHANGE…)

Commit message

SemVer impact

Theo chuẩn Conventional Commits v1.0.0. Commit message dạng này giúp tự sinh changelog (standard-version, semantic-release) và tính SemVer bump tự động.

Khi nào dùng?

Team dùng semantic-release / standard-version: commit message chuẩn quyết định SemVer bump tự động — sai format = sai version release.
Tự sinh CHANGELOG.md: tool đọc git log → output changelog phân nhóm "Features / Bug Fixes / Performance".
Code review nhanh: reviewer chỉ cần nhìn feat(auth) hay fix(api) là biết PR ảnh hưởng đâu.

Cấu trúc message chuẩn

<type>(<scope>)<!>: <subject>

<body>

<footer>

11 type chuẩn (Angular convention)

Type	Khi nào dùng	SemVer
`feat`	Tính năng mới	MINOR
`fix`	Sửa bug	PATCH
`docs`	Chỉ docs/comment, không động code	none
`style`	Format (space, dấu phẩy), không đổi logic	none
`refactor`	Đổi code không thêm tính năng/sửa bug	PATCH
`perf`	Tối ưu hiệu năng	PATCH
`test`	Thêm/sửa test	none
`build`	npm/webpack/dep update	PATCH
`ci`	GitHub Actions, CircleCI…	none
`chore`	Việc lặt vặt (config, .gitignore)	none
`revert`	Revert commit trước	PATCH

Breaking change

2 cách đánh dấu breaking change (cả 2 đều bump MAJOR):

Thêm ! sau type/scope: feat(api)!: rename /users → /accounts
Có footer BREAKING CHANGE: ở cuối message

Subject viết sao cho tốt

Imperative mood (như mệnh lệnh): "add login" thay vì "added login" hay "adds login"
Chữ thường đầu, KHÔNG chấm cuối
Tối đa 72 ký tự — gitlog đọc đẹp
Trả lời được câu: "Nếu áp dụng commit này, nó sẽ …"

Phù hợp với ai

Lập trình viên fullstack/backend/devops — debug JWT, format JSON/SQL, parse cURL, tính subnet CIDR, vẽ diagram Mermaid, viết commit chuẩn… Toolkit dùng hằng ngày trong terminal & code editor.

Câu hỏi thường gặp

Code/token tôi paste có gửi đi đâu không?

Không. Tất cả công cụ dev của TopDev chạy 100% client-side — JWT, SQL, JSON, cURL, regex… đều xử lý trong trình duyệt. Bạn có thể tắt mạng để kiểm chứng. Phù hợp để paste token nội bộ, query database production, key API.

Có hỗ trợ offline / cài thành PWA không?

Tool đã chạy được offline sau lần load đầu tiên. PWA installable đang nằm trong roadmap — hiện tại bạn có thể bookmark trang và dùng khi mất mạng.