Cara menggunakan Pembuat Conventional Commit
- Pilih tipe perubahan:
featuntuk fitur baru,fixuntuk perbaikan bug, atau docs, refactor, perf, test, build, ci, chore, style, dan revert. - Tambahkan scope opsional (bagian kode yang disentuh) dan deskripsi singkat dengan kalimat perintah: “tambah”, bukan “menambahkan”.
- Jelaskan apa dan kenapa di bagian isi. Centang Breaking change dan jelaskan cara migrasinya jika pengguna perlu mengubah sesuatu.
- Tambahkan footer seperti
Closes #123, perbaiki hal yang ditandai pemeriksaan, lalu salin pesan atau perintahgit commit.
Format Conventional Commits
<type>[optional scope][!]: <description>
[optional body]
[optional footer(s)]| Tipe | Dipakai untuk | Kenaikan versi |
|---|---|---|
feat | Fitur baru | Minor (1.4.0 → 1.5.0) |
fix | Perbaikan bug | Patch (1.4.0 → 1.4.1) |
! atau BREAKING CHANGE: | Perubahan yang harus disesuaikan pengguna | Major (1.4.0 → 2.0.0) |
| docs, style, refactor, perf, test, build, ci, chore, revert | Selain itu | Tidak ada (kecuali breaking) |
Alat seperti semantic-release, release-please, dan standard-version membaca pesan ini untuk menentukan versi berikutnya dan menulis changelog secara otomatis. commitlint menerapkan aturan ini di CI atau git hook. Jaga header tetap di bawah 72 karakter, tulis deskripsi dengan huruf kecil dan kata kerja perintah, serta jangan akhiri dengan titik. Buat changelog dengan Changelog Generator dan perintah git lainnya dengan Git Command Generator.
Juga dicari sebagai: conventional commits, generator conventional commit, pembuat pesan commit, format pesan commit git, semantic commit messages, commitlint, feat fix commit, breaking change commit.
Tool yang cocok dipakai bersama Pembuat Conventional Commit
- Kalkulator Semver — Semua tentang semantic version dalam satu tempat: bandingkan dua versi, hitung major/minor/patch/prerelease berikutnya, dan lihat versi mana saja yang diizinkan oleh range npm seperti ^1.2.0 atau ~2.3 — dijelaskan dengan bahasa sederhana.
- Git Cheat Sheet — Setiap perintah Git yang kamu pakai sehari-hari, dan yang kamu butuhkan saat ada yang salah, dijelaskan dalam satu baris.
- Generator Workflow GitHub Actions — Pilih stack, pemicu, dan langkahnya, lalu dapatkan .github/workflows/ci.yml yang sudah diberi komentar — install, cache, lint, test, build, matrix versi, dan deploy opsional ke GitHub Pages, Vercel, atau container registry.
- Generator LICENSE — Tambahkan lisensi open-source yang tepat ke proyekmu dalam hitungan detik.
Pertanyaan yang sering diajukan
Apa itu conventional commit?
Pesan commit dengan format tipe(scope): deskripsi, misalnya fix(auth): handle expired tokens, yang bisa dibaca alat untuk menentukan nomor versi dan membuat changelog.
Bagaimana cara menandai breaking change?
Tambahkan ! setelah tipe atau scope (feat(api)!: …) dan footer BREAKING CHANGE: yang menjelaskan apa yang berubah. Centang Breaking change di sini untuk mendapatkan keduanya.
Apa bedanya chore dan refactor?
refactor mengubah struktur kode tanpa mengubah perilaku; chore mencakup perawatan yang tidak menyentuh perilaku kode sumber, misalnya memperbarui dependensi atau konfigurasi tooling.
Bagaimana cara menulis pesan commit banyak baris dari command line?
Gunakan satu -m untuk setiap paragraf: git commit -m "header" -m "body" -m "footer". Perintah git di sini melakukannya untukmu, lengkap dengan tanda kutip yang sudah di-escape.
Bisakah saya memasang Pembuat Conventional Commit sebagai aplikasi web dan memakainya offline?
Bisa. Pembuat Conventional Commit adalah aplikasi web (PWA) yang bisa dipasang. Pemasangannya lewat browser kamu, bukan diunduh dari toko aplikasi. Klik Pasang aplikasi di bagian atas halaman ini di Chrome atau Edge (Windows, macOS, Linux, ChromeOS) atau di Android. Di iPhone dan iPad, gunakan Bagikan → Tambahkan ke Layar Utama, dan di Safari 17+ pada Mac, gunakan File → Tambahkan ke Dock. Setelah itu, aplikasi akan terbuka di jendelanya sendiri dengan ikonnya sendiri. Karena berjalan sepenuhnya di browser kamu, aplikasi ini tetap bisa dipakai offline. Firefox di desktop tidak bisa memasang aplikasi web. Cara memasang aplikasi.