This page is for piece authors deciding what version number to publish. For how flows adopt new piece versions, see Piece syncing & versioning.
Semantic versioning
The version number isMAJOR.MINOR.PATCH:
- MAJOR: bump when you make a breaking change.
- MINOR: bump when you add functionality without breaking existing flows.
- PATCH: bump for bug fixes that don’t change behavior.
Classifying changes
Use this checklist when deciding which segment to bump.Breaking changes (MAJOR)
- Remove an existing action or trigger.
- Add a required prop to an existing action or trigger.
- Remove an existing prop, whether required or optional.
- Rename an existing prop, or change its type/shape.
- Remove an attribute from an action output.
- Change the existing behavior of an action or trigger.
Non-breaking changes (MINOR or PATCH)
- Add a new action or trigger.
- Add an optional prop.
- Add an attribute to an action output.
- Fix a bug without changing the public surface (PATCH).