# General Translation Integrations: Quickstart
URL: https://generaltranslation.com/en-US/docs/integrations/mintlify/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Translate a Mintlify documentation site with General Translation.

The integration is powered by [Locadex](/docs/platform/locadex/quickstart), an AI agent: connect the GitHub repository that holds your docs, choose your languages, and Locadex opens a pull request with internationalization (i18n) routing and translated content. There is nothing to install and no config to write by hand.

## Before you start [#before-start]

You need:

- A [project](/docs/platform/dashboard/get-started).
- A GitHub repository containing a valid Mintlify project: a `docs.json` whose `$schema` points at Mintlify (`mintlify.com/docs.json`), with no legacy `mint.json`.
- Permission to install a GitHub App on that 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 **Project > Integrations > Catalog** and connect GitHub. Authorize the General Translation GitHub App for the repository that contains your Mintlify docs.

### 2. Create an automation

Open **Project > Automations** and choose **Generate translations and push**. Select the linked repository, the directory that contains `docs.json`, and **Mintlify** as the framework. Review the target branch and trigger, then click **Create automation**.

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

### 3. Run setup

Open the automation and click **Run setup**. Set the **source locale** and **target languages**, then confirm. (See [Locales](/docs/integrations/mintlify/reference/locales)).

### 4. Review and merge the pull request

Locadex runs setup, 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 follows the automation's configured trigger. New translation automations default to running when a pull request changes. To translate changes after they reach the target branch, set **Run when** to **A commit is pushed**. (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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.