Compatibility
Pinned runtime, media and SDK versions with upgrade gates.
| Component | Pin | Upgrade trigger | Gate |
|---|---|---|---|
| Node.js | 26 (.nvmrc); API image 26.13.1 + digest | LTS patch | CI + staging |
| pnpm | 12.18.0 (packageManager) | Minor | Frozen install + CI |
| LiveKit Server | v1.13.11@sha256:25cd902de7ca… | Security fix / feature | Browser, mobile, reconnect, TURN, load tests |
| livekit-client / @livekit/components-react | Lockfile | Tested release | Product integration tests |
| livekit-server-sdk | Lockfile | Tested release | API integration tests (real LiveKit) |
@lynkoria/* SDKs | semver (Changesets) | Feature/fix | OpenAPI drift check + SDK e2e test |
| socket.io / socket.io-client | 4.8.x pair | Tested release | Reconnect/resync tests |
| PostgreSQL | 18 (postgres:18-alpine locally/CI, managed 18 in SGP1) | Scheduled | Migration + restore rehearsal |
| Redis / Valkey | Redis 8 (redis:8-alpine locally/CI) / managed Valkey 9 | Scheduled | Presence sweeper + rate-limit tests against both |
| TypeScript | 7.0 (native compiler) | Minor | Typecheck |
| Oxlint / Oxfmt | Lockfile | Minor | pnpm lint / pnpm format:check |
| Shared npm versions | catalog: in pnpm-workspace.yaml | Any | Frozen install + CI |
| Android toolchain | Kotlin 2.4.21, AGP 9.5.1, Gradle 9.9.1, compileSdk 37 | Minor | ./gradlew build |
| livekit-android / OkHttp | 2.30.0 / 4.12.0 (OkHttp follows livekit-android) | Tested release | Android build + device checks |
| Swift package | tools 6.0, Swift 5 language mode; LiveKit Swift ≥ 2.19.0 | Tested release | swift build (macOS) + swift:6.4.2 core tests |
| ClamAV | 1.4.6 LTS by digest (Debian image locally, Alpine prod) | Signature engine fix | Scanner real-engine suite |
API and SDK support window
- REST and socket contracts are versioned under
/v1. Additive changes only within v1; breaking changes get/v2with a published support window for older mobile clients (minimum 6 months). @lynkoria/*follow semver; pre-1.0 minors may break and say so in their changeset.- The server returns the LiveKit
urlwith every token, so the media endpoint can move without an app release.
Documentation pins Fumadocs core/UI 16.19.0, MDX 15.6.0 and Next 16.4.6, verified against published peer requirements and official setup. The supported Webpack mode builds a static export with browser-side search.