Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nexus.westyx.cloud/llms.txt

Use this file to discover all available pages before exploring further.

What are configs?

Configs are typed key-value settings for your service - database hosts, API base URLs, timeout values, and anything else that should vary per environment without requiring a code change. Unlike secrets, configs are:
  • Not encrypted - suitable for non-sensitive values
  • Available to both backend and frontend services
  • Typed: string, number, boolean, json
  • Capable of referencing secrets and feature flags by key

Key names

Config keys follow the same pattern as secrets: ^[a-zA-Z]([a-zA-Z0-9_.:-]*[a-zA-Z0-9])?$ Examples: database.host, api.timeout_ms, feature.max_retries

Template references

Configs can embed the resolved values of secrets and flags using {{...}} syntax:
SyntaxResolves to
{{secret:KEY}}Current value of the named secret
{{flag:KEY}}true or false - current state of the named flag
Example:
database.url = postgresql://app:{{secret:DB_PASSWORD}}@{{config:DB_HOST}}:5432/mydb
The resolution happens server-side at sync time. SDKs receive the resolved string - the raw secret is never exposed to the client.

Reading configs

host, ok := client.GetConfig("database.host")
port, ok := client.GetConfigAs[int]("database.port")
cfg,  ok := client.GetConfigJSON("service.options") // any JSON value

Umbrella inheritance

If a service is linked to an umbrella service, it inherits all configs defined on the umbrella. A service-level key with the same name overrides the umbrella value.
Umbrella: database.host = db.internal
  └── Service: database.host = replica.db.internal  ← overrides
               api.timeout_ms = 3000                 ← inherited from umbrella

Live updates

All SDKs support SSE-based push: when a config is updated in the console, connected SDK instances receive the new value within milliseconds - no restart required. See Quickstart → Enable live updates for setup.