# General Translation Integrations: Quickstart
URL: https://generaltranslation.com/en-US/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

---

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 internationalization (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 at 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 on 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 **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 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 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