i18n-sync

Use this skill when you need to keep i18n keys in sync across frontend, backend, iOS, and Android.

Contract

• Function pattern: customFn("key", { count: 0, name: userName })
• Function name is configurable (functionNames)
• Second argument must be an object/map literal
• Translation storage is always flat JSON: { "key": "value with {param}" }

Commands

• node skill-i18n-sync/index.js extract --config skill-i18n-sync/i18n-sync.config.json
• node skill-i18n-sync/index.js validate --config skill-i18n-sync/i18n-sync.config.json
• node skill-i18n-sync/index.js sync --config skill-i18n-sync/i18n-sync.config.json

What it does

1. Extract keys and params from source code.
2. Pull all project translation JSON from API once.
3. Filter translations by extracted keys.
4. Validate placeholders (translation side vs code side).
5. Emit locale JSON into each platform output directory.
6. Generate optional runtime formatter helpers for JS/Swift/Kotlin.

Default backend endpoint in this repository: POST /api/i18n/translations.

Artifacts

• skill-i18n-sync/.artifacts/keys.json
• skill-i18n-sync/.artifacts/report.json