Translating your Next.js app into French 🇫🇷, Spanish 🇪🇸, Japanese 🇯🇵 or any other language is tedious and time‑consuming.

Locadex is an AI agent built to handle 100% of the internationalisation (i18n) work for you. It takes 5 minutes to install.

Locadex:

• Configures your project to use the gt-next i18n library
• Modifies your React components and strings to support multilingual content
• Translates your app into as many languages as you need
• Continuously internationalises and translates as you push new content

Setup process

Step 1: Sign in to the General Translation Dashboard

Go to your Dashboard and sign in to your account.

Step 2: Connect GitHub

1. Navigate to the GitHub integration section in your dashboard
2. Click “Connect GitHub” to link your GitHub account
3. You’ll be redirected to GitHub to authorise the connection

Step 3: Install the GitHub App

1. After connecting GitHub, you’ll be redirected to install the Locadex GitHub app
2. Choose which repositories to grant Locadex access to:
   • Install on all repositories, or
   • Select specific repositories
3. Click “Install” to complete the GitHub app installation

Step 4: Link Repository to Project

1. Back in your GT dashboard, select the repository you want to internationalise
2. This links your repo to your translation settings and target languages
3. Only one repository can be linked to a project, but you can create multiple projects, each with a different repository

Step 5: Configure settings

On the configuration screen, set up:

• Target languages: Choose which locales to translate into

Step 6: Complete installation

1. Review your configuration settings
2. Click “Install” to activate Locadex for your repository
3. You’ll be taken to an overview page showing your connected GitHub repository

What happens next

Initial setup

Once you’ve completed the installation:

1. Immediate PR creation: Locadex will create a pull request on your main branch
2. Full setup: This PR runs the complete Locadex setup command, which:
   • Installs the GT libraries
   • Configures your project for internationalisation
   • Sets up the translation infrastructure
3. Review and merge: Review the PR and merge it to complete your i18n setup

Continuous internationalisation

After the initial setup is merged:

1. Locadex monitors your main or specified branch for pull requests
2. When you push new code with translatable content, wait for Locadex to add its commit to the PR
3. Once Locadex has committed to the PR, it’s safe to merge — your new code is internationalised
4. Your app remains translated without manual intervention

Monitoring Your Repository

Dashboard status

In the dashboard, you can monitor:

• Repository status: Active monitoring indicator
• Configuration: Current settings and target languages

GitHub Integration

• Status Checks: Locadex adds status updates to pull requests
• Check Runs: GitHub shows Locadex processing status

Troubleshooting

Common issues

Locadex not creating PRs

• Verify the GitHub app has repository access
• Check that commits contain translatable content

Configuration changes required

• Update branch settings in your GT dashboard
• Changes apply to new commits after the update

Supported frameworks

Currently, Locadex only supports Next.js App Router apps.