Skip to content

Instantly share code, notes, and snippets.

@chabala
Created August 20, 2026 02:17
Show Gist options
  • Select an option

  • Save chabala/1b9d795f08c950e838eea2100808d8a7 to your computer and use it in GitHub Desktop.

Select an option

Save chabala/1b9d795f08c950e838eea2100808d8a7 to your computer and use it in GitHub Desktop.
code-repository-naming.md

Code Repository Naming

Your repository should always be kebab-case: no capital letters, no underscores, no periods, nothing weird.

If it's a Java project, the repository name should also match the Maven artifactId. The only exceptions, you are forking a project and want to make it clear your fork is not the source repo, or you have multiple forks of repos that would otherwise have a name collision. In those cases, prefixing with another word to indicate the upstream source is advised.

If the repository is explicitly for a website, you can have periods if you're naming the repo with the domain name. But don't just name a repo with domain name and then use it as the main code repo for a project that happens to also have a website at that domain, if it's holding anything more than just a website, kebab-case rule wins.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment