Versioning & Support

Semantic versioning

The SDK follows Semantic Versioning 2.0.0:

Major (X.y.z) -- breaking changes to the public API surface.
Minor (x.Y.z) -- additive, non-breaking changes.
Patch (x.y.Z) -- bug fixes that are backward-compatible.

Breaking changes are always documented in the Migration Guide and announced in the Blog.

Supported React Native versions

Requirement	Minimum supported version
React Native	0.76+
iOS deployment target	15.1+
Android API level	24 (Android 7.0)+

The SDK targets React Native's New Architecture. Older React Native versions (below 0.76) are not supported.

Native SDK version compatibility

Each React Native SDK release is pinned to specific native SDK versions. Using mismatched versions may result in undefined behavior.

React Native SDK	iOS SDK (ZetaCore)	Android SDK (net.zetaglobal.app:core)
1.0.0	1.0.0	1.0.1
0.2.0	0.2.0	0.2.0
0.1.x	0.1.x	0.1.x

For platform-specific version requirements (Xcode, Gradle, JDK), see:

Release cadence

Cadence: Minor and patch releases ship as features land and bugs are fixed. Major releases ship when there is a deliberate API break.
Native SDK alignment: React Native SDK releases follow the native iOS and Android SDK release cycle. A new React Native SDK version is published when either or both native SDKs release an update.

Support channels

Knowledge base -- https://knowledgebase.zetaglobal.com
Account team -- contact your Zeta account manager for SDK issues that require engineering triage.

Documentation versions

This page describes the current SDK version. If you are using an older SDK version, select the matching documentation version from the Version dropdown at the top of the page. Each documentation version is a snapshot of the docs as published at the time of that SDK release.

For the full list of documentation versions and the SDK versions they cover, see the documentation versions table.