Localization management with Crowdin

Once you've set up your app with next-intl, you'll have multiple translation bundles that contain your messages (e.g. en.json). To streamline the workflow of managing these and to allow other team members to contribute translations, it's a good idea to use a localization management platform.

next-intl recommends Crowdin (opens in a new tab) for managing your translations.

Collaborate with translators

The Crowdin Editor provides an easy-to-use environment for translating messages. Apart from guiding translators through your messages, the workflow is improved with advanced features like machine translation suggestions, glossaries and contextual screenshots.

(opens in a new tab)

Decouple localization from development

As a developer-focused localization service, Crowdin helps you to decouple the localization process from development and integrates with your existing workflows.

Integration options:

1. Git integration e.g. via the GitHub app (opens in a new tab) or the Crowdin CLI (opens in a new tab) (recommended)
2. Automatic workflows triggered from webhooks (opens in a new tab)
3. Over-the-air delivery via the JS SDK (opens in a new tab)
4. Manual up- and download of messages (useful to get started)

(opens in a new tab)

You can further simplify the process for translators by setting up Crowdin In-Context (opens in a new tab), allowing for the translation of messages directly from your app.

Example workflow with the GitHub integration

For this example, we're going to use an example that is publicly available on GitHub: Street Photography Viewer (opens in a new tab). It's a Next.js 13 app that displays street photography pictures from Unsplash and uses next-intl for all internationalization needs.

Once you have a GitHub repository with your app, you can follow these steps:

1. Install the GitHub app from the Crowdin store (opens in a new tab)
2. Follow the setup guide for the GitHub integration (opens in a new tab)

After this procedure, Crowdin will commit a configuration file to your repository based on your settings.

files:
  - source: /messages/en.json
    translation: /messages/%locale%.json

This file provides the local translations in your repository to Crowdin.

Now, as soon as a translation gets updated in Crowdin, the next sync will create a pull request in your repository with the updates.

→ Head over to Crowdin (opens in a new tab) to learn more.