The Locale API allows setting i18n and l7n options globally for the components. You can import json files in this repo and use them in the locale API in the Prime UI libraries.

• PrimeReact
• PrimeNG
• PrimeVue
• PrimeFaces

Prime UI libraries only provide English translations by default, if you"d like to share translations, please contribute to this repo.

PrimeLocale is available at npm.

# Using npm
npm install primelocale

# Using yarn
yarn add primelocale

# Using pnpm
pnpm add primelocale

• PrimeReact Sandbox

When copying the local file to use, it is advisable to remove the object key in the json. For example, instead of having

{
"en":
    {
    ...
    }
}

Use:

{
...
}

To add a new value to the translation files, follow these steps:

1. Add to en.json: First, add the new key-value pair to the en.json file. This file serves as the source for all translations.

2. Obtain Google Translate API Key: You'll need a Google Translate API key to run the translation script. If you don't have one, follow Google's instructions to obtain an API key.

3. Update script-translate.js: Once you have the API key, update the script-translate.js file. Locate the following line and replace 'REPLACEME' with your actual API key:

   const apiKey = 'REPLACEME'; // Replace with your API key

   Note: Be careful not to commit this change to version control to keep your API key private.

4. Run the Translation Script: After adding your new key to en.json and updating the API key, run the translation script:

   node script-translate.js

   This script will:

   • Read all language JSON files
   • Identify the new key(s) added to en.json
   • Translate the new value(s) to all other languages
   • Update all language files with the new translations

5. Review Translations: After running the script, it's a good practice to review the generated translations for accuracy.

By following these steps, you ensure that new values are consistently added and translated across all language files in your project.

Adjust the version in the package.json if necessary, then

npm login
# This will run npm run build automatically
npm publish --access public

Then upload code to github, create tag & release.

Licensed under the MIT License.