i18n
User-facing strings and react-i18next locale keys, namespaces, interpolation
by lobehubFree
Description
i18n is an agent skill from the LobeHub repository that sets the rules for user-facing text and its translations. The app uses react-i18next, with English (en-US) as the default language, and the skill covers locale keys, namespaces, interpolation and translations. Its main rule is about where text is edited: only the files in packages/locales/src/default/ are changed by hand. The JSON files in the locales folders are generated, so translations should not be written there, apart from the en-US and zh-CN previews, and generated locales change through the lobe-i18n tool and a daily auto-i18n workflow. The guide asks you to run bun run i18n yourself only when the generated locales are needed immediately. Keys use a flat dot notation, such as sync.status.ready, rather than nested objects, and the guide gives correct and incorrect examples. It also covers how to change the English text of an existing key, which involves deleting keys in the generated files. The skill is for contributors adding or changing any text the user sees in the app. It passes Gen Agent Trust Hub, Socket and Snyk on skills.sh. Install it with npx skills add https://github.com/lobehub/lobehub --skill i18n.…
Highlights
- Covers react-i18next keys, namespaces, interpolation and translations
- Edits only packages/locales/src/default/ by hand
- Explains the generated locales and the daily translation workflow
- Uses flat dot-notation keys such as sync.status.ready
Ratings & Reviews
No ratings yet
Be the first to rate i18n.
People also visit
vscode-ext-localization
Localize VS Code extensions across configurations, walkthrough content
i18n FAQ
What is the default language?
English (en-US). The app uses react-i18next for its translations.
Where do I add new text?
In the files under packages/locales/src/default/. Generated locale JSON files should not be hand-written, apart from the en-US and zh-CN previews.
Do I have to run the translation script?
Not usually. The daily auto-i18n workflow generates the locales. Run bun run i18n only when you need them right away.
What key format is used?
Flat keys with dot notation, not nested objects.
How do I install it?
Run npx skills add https://github.com/lobehub/lobehub --skill i18n.
Which security audits does it have?
On skills.sh, Gen Agent Trust Hub, Socket and Snyk all pass.
What are the best i18n alternatives?
Popular alternatives to i18n include vscode-ext-localization, add-provider-doc and add-setting-env. See all i18n alternatives