Locadex is an AI agent built to handle 100% of internationalisation (i18n) and translation work for you.

It takes five minutes to install, after which your Mintlify docs will be configured and translated into all the languages you choose automatically.

Locadex:

• Sets up i18n routing and redirects in your docs
• Translates Markdown files, code blocks, and snippets in context
• Continuously translates as you push new content

Step 1: Sign in to the General Translation Dashboard

Sign in to the General Translation Dashboard.

Step 2: Connect GitHub

Go to the Locadex section in your dashboard and click “Connect GitHub”.

You’ll be redirected to GitHub to authorise the connection.

Step 3: Install the GitHub App

Choose which repositories to grant Locadex access to:

Click Install to complete the GitHub app installation.

Step 4: Link Repository to Project

You’ll be taken back to your General Translation project, where you can select the repository containing your Mintlify docs.

Step 5: Configure settings

On the configuration screen, set up:

• Which languages do you need?: The languages you want the docs to be available in

• Default locale: The language you originally wrote the docs in

Step 6: Complete installation

Click “Install” to activate Locadex for your repository:

Step 7: Review the PR

Locadex will create a pull request on your main branch. This may take a few minutes to complete.

Review the PR and merge it to complete your i18n setup.

Step 8: Continuous internationalisation

Once the initial setup PR is merged, Locadex monitors your main branch for commits and updates translations as needed.

Supported frameworks

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

Troubleshooting

If you have Locadex installed across multiple GitHub accounts or organisations, the dashboard will display a list of all those accounts and organisations. Connecting to an account or organisation will link it to your current GT org.