Need help with
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

2.8K Stars 256 Forks MIT License 207 Commits 48 Opened issues


The conventional commits specification

Services available


Need anything else?

Contributors list

Conventional Commits

This repo is the home of the Conventional Commits specification.

Repo Layout

We use HUGO as static site generator, so we use the directory structure HUGO proposes.

Our implementation

  • ./content
    : contains all the versions of the specification.
  • ./content/next/
    : contains the version of the specification (where all the changes SHOULD be made).
  • ./content/**/index.[lang].md
    : contains the content of the specification, if a language is specified it's a translation.


We'd love your help refining the language of this specification, fixing typos, or adding more translations. Please don't hesitate to send a pull request.

Adding a translation

  1. Create a new file in
    using the hugo command
    hugo new [version]/index.[lang].md
  2. Ensure all files have the appropriate fields required (see others as an example)..
  3. Add the language to the
    file (see others as an example).

Running project locally

There's a docker-compose.yml file ready that will help you to check if the website looks good! To run it make sure you have docker-compose installed on your machine and just use the command

docker-compose up
to make it run locally.

Once the website will be compiled, you can see the website visiting



Tell your users that you use the Conventional Commits specification:

[![Conventional Commits](](

Thank you

To Lorenzo D'Ianni for the great effort creating the CSS and the HTML for the new UI.

To Netlify to host our project, giving us a lot of amazing built in functionality for free.

To we used as a blueprint for the structure of this specification and the first version of the website.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.