Versioning
Flagify is composed of independent components — each with its own release cycle and version number. This page explains how versioning works across the project.
Components
| Component | Package | Current version | Changelog |
|---|---|---|---|
| CLI | @flagify/cli | v1.1.0 | GitHub |
| Node SDK | @flagify/node | v1.0.7 | GitHub |
| React SDK | @flagify/react | v1.0.7 | GitHub |
| NestJS SDK | @flagify/nestjs | v1.0.7 | GitHub |
| Astro SDK | @flagify/astro | v1.0.7 | GitHub |
Independent versioning
The CLI and JavaScript SDKs live in separate repositories and follow their own release cadence:
- CLI (
flagifyhq/cli) — Released when CLI features, commands, or bug fixes ship. - JavaScript SDKs (
flagifyhq/javascript) — Released when SDK packages change. All four SDK packages (node,react,nestjs,astro) share the same version number within a release.
A version bump in one component does not require a bump in the other — the CLI and SDKs advance independently whenever one of them has changes to ship.
Compatibility
All Flagify components communicate through the Flagify API. As long as you are using a v1.x.x version of any component, they are compatible with each other.
| CLI | SDKs | API | Compatible |
|---|---|---|---|
| v1.x.x | v1.x.x | v1 | Yes |
Semantic versioning
All Flagify packages follow Semantic Versioning:
- Patch (1.0.x) — Bug fixes, no breaking changes.
- Minor (1.x.0) — New features, backwards compatible.
- Major (x.0.0) — Breaking changes. Migration guide provided.
Checking your versions
CLI:
flagify version
Node SDK:
npm list @flagify/node
React SDK:
npm list @flagify/react
Staying up to date
CLI:
npm update -g @flagify/cli
brew upgrade flagify
SDKs:
npm update @flagify/node @flagify/react