Tutti gli strumenti

Conventional Commits Builder

Genera messaggi di commit formattati secondo la specifica conventionalcommits.org. Nel browser, senza registrazione.

Configurazione
Tipo *
Il modulo o contesto interessato dal commit.
0 / 72
Output generato
← Compila il modulo per generare il commit...
0 car.
Anteprima testo
← Compila il modulo...
Tipi di commit
Tipo Emoji Quando usarlo SemVer
feat ✨ Aggiunge una nuova funzionalità visibile all'utente o all'API pubblica. MINOR
fix 🐛 Corregge un bug nel codice esistente. PATCH
docs 📝 Modifiche esclusivamente alla documentazione (README, commenti, wiki). —
style 💄 Formattazione, spaziatura, virgole — nessun cambiamento logico. —
refactor ♻️ Ristruttura il codice senza aggiungere feature né correggere bug. —
perf ⚡ Ottimizzazione che migliora le performance senza cambiare il comportamento. PATCH
test ✅ Aggiunge o corregge test esistenti (unit, integration, e2e). —
build 📦 Modifica il sistema di build, dipendenze esterne (npm, gradle, webpack...). —
ci 🔧 Modifiche ai file di CI/CD (GitHub Actions, GitLab CI, CircleCI...). —
chore 🔨 Attività di manutenzione ordinaria che non modificano src né test. —
revert ⏪ Annulla un commit precedente. Il body dovrebbe riportare l'SHA del commit annullato. —
Un commit con BREAKING CHANGE nel footer o con ! dopo il tipo/scope fa scattare un bump MAJOR del semantic versioning, indipendentemente dal tipo.
FAQ

Domande frequenti

Conventional Commits è una convenzione leggera che si sovrappone ai messaggi di commit di Git. Definisce un insieme di regole per creare una cronologia dei commit esplicita, leggibile sia dalle macchine che dagli esseri umani. Il formato di base è tipo(scope): descrizione. Questa struttura consente a strumenti come semantic-release o standard-version di generare automaticamente changelog e calcolare il prossimo numero di versione SemVer.

Attiva il flag Breaking Change quando il tuo commit introduce una modifica incompatibile con la versione precedente dell'API pubblica — ad esempio la rimozione o la rinomina di un endpoint, la modifica della firma di una funzione, o una dipendenza che non funziona più con versioni precedenti. Questa segnalazione aggiunge il suffisso ! al tipo (es. feat!) e inserisce la riga BREAKING CHANGE: ... nel footer, provocando un bump MAJOR nel SemVer.

La lunghezza di 72 caratteri è una convenzione consolidata nella community Git: garantisce che la prima riga del commit (il "subject") sia leggibile senza troncamenti nella maggior parte dei terminali, dei client Git (GitHub, GitLab, Bitbucket) e nei log a riga singola (git log --oneline). Molti linter come commitlint impostano questo valore come limite massimo. Informazioni più verbose vanno nel body del commit, separato da una riga vuota.