Skip to content

i18n

snug i18n <COMMAND>

Localization and translation management.

Subcommands

CommandWhat it does
projectProject administration
localeLocale administration
uploadUpload a locale strings file
approveApprove draft/pending translations for a locale
publishPublish approved translations into an active version
rollbackRoll back a locale to a prior active version
resolveResolve a single key
resolve-batchResolve many keys in one request
bundleExport an active locale bundle
reportMissing-key report
telemetryReport a missing-key telemetry event
experimentExperiment administration

Run snug i18n <command> --help for that command's own options. The global options apply everywhere.

Examples

snug i18n project create --name lore-studio --base-locale en-US
snug i18n project list
snug i18n project get --project-id <id>
snug i18n locale add --project-id <id> --locale es-ES --display-name "Spanish (Spain)" --fallback en-US
snug i18n locale list --project-id <id>
snug i18n upload --project-id <id> --locale es-ES --file strings.json --mode replace
snug i18n approve --project-id <id> --locale es-ES
snug i18n publish --project-id <id> --locale es-ES
snug i18n resolve --project-id <id> --locale fr-CA --key checkout.title
snug i18n resolve-batch --project-id <id> --locale es-ES --key checkout.title --key inventory.item_count
snug i18n bundle --project-id <id> --locale es-ES --output bundle.json
snug i18n report --project-id <id> --missing
snug i18n telemetry --project-id <id> --locale es-ES --key quest.reward --caller web
snug i18n experiment create --project-id <id> --file variants.json
snug i18n rollback --project-id <id> --locale es-ES --version 6

Project access

Projects start private. project create accepts --workspace-id and --visibility private|workspace. A service account creates under workspace custody.

snug access grant --target i18n-projects --id <project-id> \
  --subject-kind user --subject-id <user-id> --role editor
snug access revoke --target i18n-projects --id <project-id> \
  --subject-kind user --subject-id <user-id> --role editor

Readers can resolve published copy. Editors prepare drafts; managers approve, publish, roll back and share. See Project permissions.

Next