Adding new translations
Learn how to add new translations to your Makerkit project.
Translations are stored at application level and can be found at apps/web/public/locales
. Translations for English (which is the only language provided by default) will be found at apps/web/public/locales/en
.
If you wish to provide a new language, there are two steps.
1. Add the language files
Create a new folder using the correct language code at apps/web/public/locales/[lng]
where [lng]
can be any correct language code, such as de
, it
, es
, ja
, etc.
2. Update settings
Add the language to the settings file at apps/web/lib/i18n/i18n.settings.ts
:
/** * The list of supported languages. * By default, only the default language is supported. * Add more languages here if needed. */export const languages: string[] = [defaultLanguage, 'es'];
In the above, I appended the language es
to the languages
array. You can add as many languages as you need.
3. Add new namespaces
If you want to add a new namespace (for example, chatbots.json
) where you will store translations for chatbots, you can do so by creating a new file in the apps/web/public/locales/[lng]
directory. For example, apps/web/public/locales/en/chatbots.json
.
Then, you register the new namespace in the i18n.settings.ts
file:
export const defaultI18nNamespaces = [ 'common', 'auth', 'account', 'teams', 'billing', 'marketing', 'chatbots',];
In the example above, the chatbots
namespace is added to the defaultI18nNamespaces
array. And that's it! You can now start adding translations to your new namespace.