Locadex — AI i18n engineer

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

Locadex is an AI agent built to handle 100% of the internationalization (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 internationalizes and translates as you push new content

Setup Process

Step 1: Sign into 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 authorize 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 give 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 internationalize
2. This connects 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
• App Directory: Specify the directory if you're using a monorepo (e.g., apps/web/)
• Branch Prefix: Customize the prefix for branches Locadex creates (default: locadex/)

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 complete 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 that:
   • Installs our libraries
   • Configures your project for internationalization
   • Sets up the translation infrastructure
3. Review & Merge: Review the PR and merge it to complete your i18n setup

Continuous internationalization

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 commits to the PR, it is safe to merge -- your new code is internationalized
4. Your app stays 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 needed

• 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.

Request support for other frameworks here.