The tricky part is that you need to keep all those files in sync, so it gets more complicated with the more languages you need to support. Our PointFire Localizer solution helps you localize your SPFx solution, so you do not have to worry about missing translations.

PointFire Localizer is a GitHub Action that helps you translate your localization files for your SPFx solutions. The Azure AI Translator is used to translate your localization files to the desired languages.

The GitHub Action adds the missing translations to your localization files so you can be sure that all key/value pairs are included in all languages. When a human has already translated a key, it will not be overwritten by machine translation. The GitHub Action favors human translations.

Our GitHub Action is designed to be easily integrated into your existing build pipeline. Thus, you can automatically translate your localization files when you build your SPFx solution.

As our builds are already running on GitHub Actions, we created a GitHub Action that can be used in your workflows. This way, you can easily integrate the localization process into your existing build pipeline, and you are sure that on release, all localization files will include all key/value pairs for all languages.

Here you can see an example of a GitHub Actions workflow for packaging a SharePoint Framework solution:

The prerequisite for using PointFire Localizer is that you have an Azure AI Translator service. You can create a new service in the Azure Portal. Once you have created the service, either the free or the paid tier, you can get the API key from the Azure Portal. You can find more information in the get your authentication keys and endpoint article.

You can make use of the free tier from Azure AI Translator.

Follow the next steps to add your Azure AI Translator API key to your GitHub repository:

• Go to your GitHub repository
• Go to the `Settings` tab
• Go to the `Secrets and variables` section and click on `Actions`
• Click on the `New repository secret` button
• Add a new secret with the name `TRANSLATOR_API_KEY` and the value of your Azure AI Translator API key

Once you have added the Azure AI Translator API key to your GitHub repository, you can add the PointFire Localizer GitHub Action to your workflow.

There are two ways how you can use PointFire Localizer in your workflow:

1.  By a predefined list of locales

2.  By automatically detecting the locales

If you want to use a predefined list of locales, you can add the following step to your workflow file right after the `install dependencies` step:

```yaml

- name: PointFire Localizer

 uses: IceFireStudios/pointfire-localizer-action@v1.0.0

 with:

 api-key: ${{ secrets.TRANSLATOR_API_KEY }}

 api-region: "westeurope"

 default-locale: "en-us"

 locales: "nl-nl,fr-fr,de-de"

 summary: true

```

In this example, we use the predefined list of locales `nl-nl,fr-fr,de-de` and the default locale `en-us`.

The GitHub Action will do the following:

· It will first look for all the `en-us.js` files in the SPFx solution

· It will then translate all the missing or empty key/value pairs to the locales `nl-nl`, `fr-fr`, and `de-de`

o If a localization file does not exist, it will create a new one

o If a localization file already exists, it will add the missing key/value pairs

The advantage of this approach is that those localization files can be created during the build process, so you do not have to make them manually if there are no human translations available.

If you want to detect the locales automatically, you can add the following step to your workflow file right after the `install dependencies` step:

```yaml

- name: PointFire Localizer

 uses: IceFireStudios/pointfire-localizer-action@v1.0.0

 with:

 api-key: ${{ secrets.TRANSLATOR_API_KEY }}

 api-region: "westeurope"

 default-locale: "en-us"

 summary: true

```

In this example, we are using the default locale `en-us`. As we did not specify any locales, the GitHub Action will automatically detect them based on the existing localization files.

The GitHub Action will do the following:

· It will first look for all the `en-us.js` files in the SPFx solution

· It will retrieve the linked locales per the default locale

· It will then translate all the missing or empty key/value pairs to the linked locales

In this case, the GitHub Action will only translate the existing locale files in the SPFx solution.