Skip to content

Please use new major version for Echo v5 support (semver) #142

Description

@akaroot

Hi, and thank you for maintaining this project.

The latest release v0.50.0 of echo-contrib appears to target Echo v5, while the previous release v0.17.4 is for Echo v4. Echo v5 is a new major version of the framework with significant breaking changes in the API and Context type.

To make the dependency relationship clearer and safer, would you consider aligning the major version of echo-contrib with the Echo major version it targets? For example:

  • echo-contrib v4.x.y for Echo v4
  • echo-contrib v5.x.y for Echo v5

This approach is already used by related Echo ecosystem projects (for example, echo-jwt uses v4.x.y for Echo v4 and v5.x.y for Echo v5). It would:
​

Clearly communicate which Echo major version a given echo-contrib release supports.

Prevent projects on Echo v4 from accidentally upgrading to an Echo v5-only echo-contrib release through loose constraints.

Make it easier for tools like Renovate and dependabot to manage upgrades across Echo major versions.

Even if you prefer to keep v0.x style versions, introducing a v5.x.y line for Echo v5 support (and documenting that v0.17.x is the latest Echo v4-compatible line) would greatly improve clarity for downstream users.

Thanks again for your work on Echo and echo-contrib.

Activity

  1. aldas commented on Jan 28, 2026

    @aldas
    Contributor

    @akaroot , thanks for reporting this. I will start v5 version serie for latest release (it will be following Echo 5) and let v0 be for Echo 4 until we stop supporting it (2026.12.31) and retract v0.50.0

  2. aldas commented on Jan 29, 2026

    @aldas
    Contributor

    just a note: I plan to finish it this weekend

  3. akaroot commented on Jan 29, 2026

    @akaroot
    Author

    @aldas thanks for quick reply

  4. aldas commented on Jan 31, 2026

    @aldas
    Contributor

    @akaroot and others. I retracted v0.50.0 in v0 and created v5 for Echo 5.

    Echo 5 support

    go get -u github.com/labstack/echo-contrib/v5
  5. akaroot commented on Feb 4, 2026

    @akaroot
    Author

    @aldas Thanks again for separating v5. However, for the v0 series, Go still lists v0.50.0 as the latest version on pkg.go.dev (see https://pkg.go.dev/github.com/labstack/echo-contrib?tab=versions
    ), even though v0.18.0 was released later.

  6. aldas commented on Feb 14, 2026

    @aldas
    Contributor

    I created v0.50.1 that retracts v5 things and is based on v4

    https://github.com/labstack/echo-contrib/releases/tag/v0.50.1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions