Operations guides

Localization workflow

Maintain app and web copy in one four-language catalog so new content cannot ship in only one language.

Steps

Put every new user-facing string in the shared catalog with English, Simplified Chinese, French, and Spanish values.

Use L10n helpers in iOS and the i18n store in web. Do not edit generated strings or messages files directly.

Sync generated files, run hardcoded-copy detection, and test language switching before accepting a feature.

All four locales are present for every key.

Placeholder names match across languages.

Hardcoded user-facing copy baseline stays at zero.

Check whether the text has a catalog key and whether the page is using the current locale store.

Run the sync script, review placeholder mismatches, and commit generated resources with the catalog change.