|
| 1 | +# Echo Roadmap |
| 2 | + |
| 3 | +> **DRAFT** — this is a starting point for maintainers to edit, not a commitment. |
| 4 | +> Dates and priorities are owned by the Echo team. Open a discussion to propose changes. |
| 5 | +
|
| 6 | +This document exists so the community can see where Echo is heading. Echo is |
| 7 | +**actively maintained**. We publish releases regularly across two supported |
| 8 | +lines — see [README](./README.md) badges for the latest version and most recent commit. |
| 9 | + |
| 10 | +## Version policy |
| 11 | + |
| 12 | +| Line | Status | Support | |
| 13 | +|------|--------|---------| |
| 14 | +| `v5` | **Current** (since 2026-01-18) | New features, fixes, and improvements. | |
| 15 | +| `v4` | Maintenance / LTS | **Security and bug fixes until 2026-12-31.** No new features. | |
| 16 | + |
| 17 | +Upgrading from v4? See [API_CHANGES_V5.md](./API_CHANGES_V5.md). |
| 18 | + |
| 19 | +Echo supports the **latest four Go major releases** and may work with older versions. |
| 20 | + |
| 21 | +## Now (in progress) |
| 22 | + |
| 23 | +- Stabilizing the `v5` API surface through point releases. |
| 24 | +- Documentation catch-up for v5 behavior changes (e.g. CORS / `RouteNotFound` |
| 25 | + behavior on groups — see #2950). |
| 26 | +- Triaging and reducing the open issue / PR backlog. |
| 27 | + |
| 28 | +## Next (under consideration) |
| 29 | + |
| 30 | +These are frequently-requested items being discussed. Inclusion here is **not** a |
| 31 | +commitment — each still needs design agreement before implementation: |
| 32 | + |
| 33 | +- **Automatic `HEAD` for `GET` routes** (#2944, #2937) — opt-in, likely via an |
| 34 | + `OnAddRoute` hook so users keep control. |
| 35 | +- **Rate limiter response metadata** — expose `Retry-After` / remaining quota |
| 36 | + through the store interface (#2961). |
| 37 | +- **Real-IP / `Forwarded` header handling** improvements (#2744). |
| 38 | +- **Proxy middleware** authorization-header handling (#2787). |
| 39 | + |
| 40 | +## Later / exploratory |
| 41 | + |
| 42 | +- Continued alignment with the Go standard library (`net/http`, `slog`). |
| 43 | +- Reducing third-party surface where the stdlib now covers the need. |
| 44 | + |
| 45 | +## How to influence the roadmap |
| 46 | + |
| 47 | +- **Discuss before large PRs** — open a [Discussion](https://github.com/labstack/echo/discussions) |
| 48 | + or issue so we can agree on the design first. |
| 49 | +- 👍 reactions on issues help us gauge demand. |
| 50 | +- See [README → Contribute](./README.md#contribute) for contribution guidelines. |
0 commit comments