Skip to main content
The official Kotlin/JVM SDK for Westyx Nexus - the platform for managing configs, secrets, and feature flags across your services. The SDK gives your JVM application a local in-memory cache of all config entries, secrets, and feature flags for its service. Reads never wait for the network; a background refresh and a live stream keep the cache current within milliseconds of a change.

Highlights

  • JVM 17+, tested on 17, 21 and 25; one suspend API built on Ktor and coroutines
  • Type-safe getters - getString, getBoolean, getInt, getLong (exact above 2^53), getDouble, getJson
  • Secrets - in memory with getSecret, as an owner-only file with getSecretFilePath
  • Feature flags - getFlag with a safe default, findFlag when “absent” and “off” must be told apart, and server-side evaluateAB
  • SSE live updates - a change in the console reaches the cache within milliseconds; the stream recovers on its own after any failure
  • Your HTTP engine - ktor-client-core only, so the application picks the engine
  • Typed exceptions - NexusException and its subclasses; an API error carries its status and code
  • Logging through SLF4J - and a startup summary naming what the first sync delivered
  • Ktor server plugin - install(Nexus) { … } ties the client to the application lifecycle
  • Workload identity federation - Kubernetes, AWS IRSA, GCP, Azure, the developer session, and AWS IAM for ECS, Fargate, Lambda and EC2
  • An OpenFeature provider with per-user targeting

Package

Hosted on the GitLab Maven Package Registry - register it first, as Installation shows. Three artifacts, released together at the same version: Latest release: v0.18.1 (2026-11-19) - see the version history.

Pages