Keys and namespaces

Flat keys

StringPush stores keys in a flat catalog. Use dot notation for grouping:

common.greeting
common.welcome
checkout.pay
items.count

There is no separate namespace fetch in v1 — all keys for a locale ship in one bundle.

Default messages

When creating a key in admin, set a default message (usually in your source language). Other locales can start empty and be filled by translators.

Missing keys

Configure SDK behavior when a key is absent:

• Return the key path (default)
• Return the default message from init({ defaultMessages })
• Return empty string

Overlay resolution

In staging edit mode, mark DOM nodes with data-i18n-key="common.greeting" or register a custom resolver. The overlay uses the same key paths as t().