# Changelog {#changelog}



## Versioning {#versioning}


Ever Gauzy follows [Semantic Versioning](https://semver.org/):

- **MAJOR** — breaking changes
- **MINOR** — new features (backwards compatible)
- **PATCH** — bug fixes (backwards compatible)


## Release Channels {#release-channels}


| Channel    | Purpose             |  Stability  |
| ---------- | ------------------- | :---------: |
| **Latest** | Production releases |  ✅ Stable  |
| **Next**   | Pre-release / RC    | ⚠️ Testing  |
| **Dev**    | Development builds  | ❌ Unstable |


## Where to Find Changes {#where-to-find-changes}


- **GitHub Releases**: [ever-co/ever-gauzy/releases](https://github.com/ever-co/ever-gauzy/releases)
- **Docker Hub**: [everco/gauzy-api](https://hub.docker.com/r/everco/gauzy-api/tags)
- **npm**: [@gauzy/core](https://www.npmjs.com/package/@gauzy/core)


## Migration Guides {#migration-guides}


When upgrading between major versions, check:

1. [Environment Variables](https://sourcey-gauzy.pages.dev/development/environment-variables/index.md) for new/changed variables
2. [Database Migrations](https://sourcey-gauzy.pages.dev/database/migrations/index.md) for schema changes
3. [GitHub Release Notes](https://github.com/ever-co/ever-gauzy/releases) for breaking changes