# General Translation Integrations: Quickstart
URL: https://generaltranslation.com/en-GB/docs/integrations/mintlify/quickstart.mdx
---

title: Quickstart 
description: Quickstart to translate a Mintlify documentation site with General Translation.
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content
    - /docs/integrations/mintlify/guides/configuring-mintlify

---

# Quickstart

Use the Mintlify integration to translate your Mintlify documentation into every language you need, automatically.

The integration is powered by [Locadex](/docs/platform/locadex/quickstart), the General Translation AI agent. You connect the GitHub repository that holds your Mintlify docs, choose your languages, and Locadex opens a pull request that adds internationalisation (i18n) routing and translated content. There is no package to install and no config file to write by hand.

## Before you start [#before-start]

You need:

* A General Translation [Project](/docs/platform/dashboard/get-started) on a plan that includes the `locadex_workflows` feature.
* A GitHub repository containing a valid Mintlify project: a `docs.json` whose `$schema` points to Mintlify (`mintlify.com/docs.json`), with no legacy `mint.json`.
* Permission to install a GitHub App on that repository.

*Note: if the* `locadex_workflows` *feature is not included in your plan, the Dashboard shows an upgrade prompt instead of the Locadex setup, so you cannot connect a repository.*

## Quickstart [#quickstart]

Setup takes just five minutes. Locadex does the configuration for you — you only pick the repository and the languages.

### 1. Connect GitHub

In the General Translation Dashboard, open your Project and go to **Locadex > Agent**. Click **Connect GitHub** and authorise the connection. Follow the prompts to install the General Translation GitHub App on the repositories you want Locadex to access (all repositories or a specific selection).

### 2. Link your repository

Back in the Dashboard, select the repository that contains your Mintlify docs. Each Project links to one repository; create additional Projects for additional repositories.

*If your docs live in a subdirectory of a monorepo, set the app root directory to that path. See [Monorepos](/docs/platform/locadex/guides/using-in-monorepos).*

### 3. Choose your languages

Set your **default locale** (the language your docs are written in) and the **target languages** to translate into. Optionally toggle **Hide default locale in URL paths** to control whether your source language is served without a locale prefix. See [Locales](/docs/integrations/mintlify/reference/locales).

### 4. Review and merge the pull request

Locadex runs its setup workflow, then opens a pull request on your repository. It may take a few minutes. The PR adds the General Translation configuration, restructures `docs.json` navigation for multiple languages, and includes the translated Markdown and MDX files. Review the changes and merge to publish your translated docs.

### 5. Keep translations up to date

After the setup PR is merged, Locadex watches your default branch. When you push new or changed content, it translates the updates automatically. See [Managing translations](/docs/integrations/mintlify/guides/managing-translations).
## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content
- /docs/integrations/mintlify/guides/configuring-mintlify