A GitHub app to check that pull requests follow the Conventional Commits spec
Install the app from the GitHub Marketplace here: https://github.com/apps/semantic-prs
By default, no configuration is necessary. The default behaviour is that only the PR title or at least one commit message needs to follow the Conventional Commits spec
This can be changed by creating a semantic.yml file in your .github directory, with any of the following optional settings:
# Enable/disable creation of status checks
enabled: <boolean> # default: true# Validate the PR title, and ignore all commit messages
titleOnly: <boolean> # default: false# Validate all commit messages, and ignore the PR title
commitsOnly: <boolean> # default: false# Validate the PR title and all commit messages
titleAndCommits: <boolean> # default: false# If commitsOnly or titleAndCommits is set to true, then only a single commit needs to pass validation instead of every commit
# If neither of those options are set to true then this option is ignored
anyCommit: <boolean> # default: false# The values allowed for the "type" part of the PR title/commit message. e.g. for a PR title/commit message of "feat: add some stuff", the type would be "feat"
types: # default: feat | fix | docs | style | refactor | perf | test | build | ci | chore | revert
- <string>
- <string>
- ...# The values allowed for the "scope" part of the PR title/commit message. e.g. for a PR title/commit message of "feat(awesome-feature): add some stuff", the type would be "awesome-feature"
scopes: # default: any value
- <string>
- <string>
- ...# Allow merge commits (e.g. 'Merge branch "master" into fix/delete-all-tests')
# If neither of commitsOnly or titleAndCommits is set to true then this option is ignored
allowMergeCommits: <boolean> # default: false# Allow revert commits (e.g. 'Revert "fix: delete all tests"')
# If neither of commitsOnly or titleAndCommits is set to true then this option is ignored
allowRevertCommits: <boolean> # default: false# Allows a custom URL for the "Details" link (which appears next to the success/failure message from the app) to be specified
targetUrl: <string> # default: https://github.com/Ezard/semantic-prsHeavily based on the Semantic Pull Requests GitHub App created by @zeke