Foundations

Learn the concepts, constraints, and mental models that make semantic-release work.

How it Works Start with the high-level release lifecycle and how the system fits together.

Release Steps Learn what happens at each release step and why order and execution matter.

Considerations Understand the constraints and tradeoffs that shape how semantic-release works.

Supported Branching Models Understand which branching strategies are aligned with semantic-release expectations.

Release Workflow Explore how branch types, channels, and version progression shape release behavior.

Plugins Understand plugin responsibilities and how extension points drive each release step.

Shareable Configurations See how teams standardize semantic-release behavior across multiple repositories.