Identifier

An identifier literal conforms to snake_case. It always starts with a character from a-z and is followed one or more characters from a-z and 0-9. It’s also possible to use _ within the identifier - but only a single consecutive _ is allowed.

You will encounter such identifier when defining targets, environments or extensions.

There are some syntax extensions for specific usages:

• Target reference identifier can start with ^ (for example ^build) - see target configuration.
• Internal extension identifier starts with @ (for example @dotnet) - see project configuration.

Examples

✅ Valid identifiers

• config
• project42
• this_is_a_var
• `version`

❌ Invalid identifiers

• Config: Uppercase letters are not allowed
• project__42: 2 consecutive underscores is not vald
• this_is_a_var_: underscore must be followed by a character
• var%: invalid character %