23. Versioning and Releases

Use semantic versioning where applicable.

MAJOR.MINOR.PATCH

Patch

Bug fix without intended API break.

2.4.1 -> 2.4.2

Minor

Backward-compatible feature.

2.4.2 -> 2.5.0

Major

Breaking change.

2.5.0 -> 3.0.0

Release flow

flowchart LR
    A[Change]
    B[Changeset]
    C[PR]
    D[CI]
    E[Merge]
    F[Release PR]
    G[Package Publish]
    H[Changelog]
    I[Migration Docs]

    A --> B --> C --> D --> E --> F --> G
    G --> H
    G --> I

Tools such as Changesets can automate package versioning in monorepos.

Deprecation strategy

Never remove widely used APIs immediately.

Suggested lifecycle:

Supported
   ↓
Deprecated
   ↓
Migration warning
   ↓
Replacement available
   ↓
Removed in major release