# 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-workflows
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/viewing-workflow-history

---

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 PRs for every generated change. Three workflows keep all of your translations up to date:

- **Codegen** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
- **Translation** translates source content into every target language and updates translation files.
- **Update Locales** updates Project files when languages are added or removed.

Each workflow can run manually, on pull requests, or on Commits. 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) and go to **Locadex > Agent** in your sidebar. Connect your GitHub account and authorize the connection. Follow the flow, which will guide you through permissions for the repositories you want Locadex to access (all repositories, or a specific selection).
2. **Link your repository.** Back in the Dashboard, select the repository to internationalize. Each Project links to one repository; create additional Projects for additional repositories.
3. **Configure the Project.**
  - **Set app root directory** (for monorepos). Use `.` or leave the field empty when the app is at the repository root.
  - **Optional:** set **package manager** so Locadex can install dependencies in the sandbox and set **linter** so Locadex can preserve code style after changes.
  - **Choose your language(s)**: your source (default) locale and the target languages your application will be translated into. Target languages can be selected from all 120 General Translation supported locales.
4. **Review and merge.** Locadex automatically runs its setup workflow to install the i18n library, configure your Project, and add the translation infrastructure. This may take a few minutes to complete. Open the PR (use **View on GitHub**), review the changes, and merge to complete your setup.

That's it! After the setup PR is merged, Locadex monitors your main branch for commits and updates translations as needed. Review new PRs or **enable [auto-merge](/docs/platform/locadex/guides/auto-merging-prs)** and your app stays translated without manual work. 

You can trigger a run yourself at any time with **Run Agent**.


## Next steps

- /docs/platform/locadex/guides/configuring-workflows
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/viewing-workflow-history