Manifest and bundles

Manifest

A small JSON document listing, per locale:

• Bundle version (integer)
• URL to fetch the bundle

The SDK polls the manifest on init and when realtime signals a newer publish.

Bundles

Each bundle is an immutable JSON file: flat key → string for one locale and environment.

Example:

{
  "common.greeting": "Hello",
  "common.welcome": "Hello, {name}!",
  "items.count": "{count, plural, one {# item} other {# items}}"
}

Bundles are served from the CDN with long cache headers. Publishing creates a new version — clients pick it up via manifest refresh.

Why this model

• Scale — no database read per page view
• Cache-friendly — edge caches bundle bytes
• Safe rollback — previous bundle versions remain addressable by version number

Your API key never ships to the CDN origin for cross-origin bundle fetches; the manifest request is authenticated against allowed domains.