# General Translation Platform: Quickstart
URL: https://generaltranslation.com/en-US/docs/platform/locadex/quickstart.mdx
---

title: Quickstart
description: Learn how to use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
related:
  links:
    - /docs/platform/locadex/guides/configuring-automations
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/viewing-automation-activity

---

Locadex is the General Translation AI agent which connects your codebase, translations, and content sources. 

It takes **5 minutes** to set up, after which your Project will be configured and translated into any language you choose **automatically**. Locadex is built to handle 100% of internationalization (i18n) and translation work for you.

Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** Projects, along with other React frameworks including Vite, Gatsby, React, Redwood, React Router, and TanStack Start.

## How Locadex works [#locadex-works]

Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:

- **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
- **Generate translations and push** translates source content into every target language and updates translation files.
- **Keep locales in sync** updates Project files when languages are added or removed.

Each automation can run manually, when a pull request changes, or when a commit is pushed. You choose the trigger settings.

## Quickstart [#quickstart]

Setting up Locadex takes just 5 minutes. You will need a [General Translation](https://dash.generaltranslation.com) Project and a GitHub repository containing a project built with one of Locadex's supported frameworks. 

1. **Connect GitHub.** Open your Project from the [Dashboard](https://dash.generaltranslation.com), go to **Project > Integrations > Catalog**, and connect GitHub. Choose the repository Locadex should use for this Project.
2. **Create an automation.** Open **Project > Automations**. Under **Start with a template**, choose **Generate code**, **Generate translations and push**, or **Keep locales in sync**.
3. **Choose the target.** Select the linked repository, target directory, and detected framework. Use `.` when the app is at the repository root.
4. **Review the automation.** Choose the target branch, trigger, created branch prefix, auto-merge behavior, changed-file filtering, and whether to preserve local edits. Click **Create automation**.
5. **Run setup.** Open the automation and click **Run setup**. Choose the source locale and target languages. Locadex prepares the repository and opens a setup pull request.
6. **Review and merge.** Open the setup pull request from the automation page, review the changes, and merge it before running the automation.

After the setup PR is merged, each automation follows its configured trigger. For an automatic run, Locadex reuses the open pull request for the same source branch and automation, then opens a new one after that pull request is merged or closed. Review PRs or **enable [auto-merge](/docs/platform/locadex/guides/auto-merging-prs)** and your app stays translated without manual work.

Open an automation and click **Run now** to trigger it manually.


## Next steps

- /docs/platform/locadex/guides/configuring-automations
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/viewing-automation-activity