3 minute read

This preset can be used by setting the preset global configuration option value to simple and brings standard configurations well suited to get started with common items, as follows.

Commit message conventions

The Conventional Commits convention comes with this preset. This corresponds to the following configuration options:

Name Value
commitMessageConventions/enabled [“conventionalCommits”]
commitMessageConventions/conventionalCommits/expression (?m)^(?<type>[a-zA-Z0-9_]+)(\((?<scope>[a-z ]+)\))?(!)?:( (?<title>.+))$(?s).*
commitMessageConventions/conventionalCommits/bumpExpressions major” = “(?s)(?m)^[a-zA-Z0-9_]+(!: .*|.*^(BREAKING( |-)CHANGE: )).*”, “minor” = “(?s)(?m)^feat(!{0})(\([a-z ]+\))?: (?!.*^(BREAKING( |-)CHANGE: )).*”, “patch” = “(?s)(?m)^fix(!{0})(\([a-z ]+\))?: (?!.*^(BREAKING( |-)CHANGE: )).*

Release types

This preset comes with a few release types, suitable for a mainline only branching model. An additional release type called internal is configured as a fallback when the mainline isn’t matched.

Please note that even if a release type has its publish flag enabled, publication to remote services doesn’t happen because no service is configured and none is listed in the publicationServices list. If you want to publish releases using this preset as a starting point you need to configure some services and override the releaseTypes/publicationServices.

This corresponds to the following configuration options:

Name Value
releaseTypes/enabled [“mainline”, “internal”]
releaseTypes/publicationServices Empty
releaseTypes/mainline/collapseVersions false
releaseTypes/mainline/collapsedVersionQualifier Empty
releaseTypes/mainline/description Empty
releaseTypes/mainline/filterTags "^({{configuration.releasePrefix}})?([0-9]\d*)\.([0-9]\d*)\.([0-9]\d*)$"
releaseTypes/mainline/gitCommit "false"
releaseTypes/mainline/gitCommitMessage Empty (use default)
releaseTypes/mainline/gitPush "true"
releaseTypes/mainline/gitTag "true"
releaseTypes/mainline/gitTagMessage Empty (use default)
releaseTypes/mainline/identifiers Empty
releaseTypes/mainline/matchBranches "^(master|main)$"
releaseTypes/mainline/matchEnvironmentVariables Empty
releaseTypes/mainline/matchWorkspaceStatus "CLEAN"
releaseTypes/mainline/publish "true"
releaseTypes/mainline/versionRange Empty
releaseTypes/mainline/versionRangeFromBranchName false
releaseTypes/internal/collapseVersions true
releaseTypes/internal/collapsedVersionQualifier "internal"
releaseTypes/internal/description Empty
releaseTypes/internal/filterTags Empty
releaseTypes/internal/gitCommit "false"
releaseTypes/internal/gitCommitMessage Empty (use default)
releaseTypes/internal/gitPush "false"
releaseTypes/internal/gitTag "false"
releaseTypes/internal/gitTagMessage Empty (use default)
releaseTypes/internal/identifiers/0/position "BUILD"
releaseTypes/internal/identifiers/0/qualifier timestamp
releaseTypes/internal/identifiers/0/value "{{#timestampYYYYMMDDHHMMSS}}{{timestamp}}{{/timestampYYYYMMDDHHMMSS}}"
releaseTypes/internal/matchBranches Empty
releaseTypes/internal/matchEnvironmentVariables Empty
releaseTypes/internal/matchWorkspaceStatus Empty
releaseTypes/internal/publish "false"
releaseTypes/internal/versionRange Empty
releaseTypes/internal/versionRangeFromBranchName false