# General Translation Platform: Guida rapida
URL: https://generaltranslation.com/it/docs/platform/locadex/quickstart.mdx
---

title: Guida rapida
description: Scopri come usare Locadex, l'AI Agent che collega la tua base di codice, le traduzioni e le sorgenti di contenuto. È il modo più rapido per usare la full-stack localization di General Translation.
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 è l'AI Agent di General Translation che collega la tua base di codice, le traduzioni e le sorgenti di contenuto.

Si configura in **5 minuti**, dopodiché il tuo Progetto verrà configurato e tradotto automaticamente in qualsiasi lingua tu scelga. Locadex è progettato per gestire per te il 100% del lavoro di internazionalizzazione (i18n) e traduzione.

Al momento, Locadex supporta i Progetti **Next.js**, **Mintlify**, **Fern** e **Docusaurus**, oltre ad altri framework React come Vite, Gatsby, React, Redwood, React Router e TanStack Start.

## Come funziona Locadex [#locadex-works]

Locadex opera all'interno del tuo repository GitHub e apre automaticamente PR per ogni modifica generata. Tre flussi di lavoro mantengono aggiornate tutte le tue traduzioni:

* **Codegen** avvolge il codice sorgente con le corrette chiamate alla libreria di internazionalizzazione (i18n), come `t()` e il componente `T`.
* **Translation** traduce i contenuti sorgente in ogni lingua di destinazione e aggiorna i file di traduzione.
* **Update Locales** aggiorna i file del progetto quando vengono aggiunte o rimosse lingue.

Ogni flusso di lavoro può essere eseguito manualmente, sulle pull request o sui commit. Sei tu a scegliere le impostazioni di attivazione.

## Guida rapida [#quickstart]

Configurare Locadex richiede solo 5 minuti. Ti serviranno un Progetto [General Translation](https://dash.generaltranslation.com) e un repository GitHub contenente un progetto sviluppato con uno dei framework supportati da Locadex.

1. **Collega GitHub.** Apri il tuo Progetto dalla [Dashboard](https://dash.generaltranslation.com) e vai a **Locadex > Agent** nella barra laterale. Collega il tuo account GitHub e autorizza la connessione. Segui la procedura guidata, che ti accompagnerà nella configurazione delle autorizzazioni per i repository a cui vuoi che Locadex acceda (tutti i repository oppure una selezione specifica).
2. **Collega il tuo repository.** Torna nella Dashboard e seleziona il repository da internazionalizzare. Ogni Progetto è collegato a un repository; crea Progetti aggiuntivi per altri repository.
3. **Configura il Progetto.**

* **Imposta la directory radice dell'app** (per i monorepo). Usa `.` oppure lascia il campo vuoto se l'app si trova nella radice del repository.
  * **Facoltativo:** imposta il **package manager** in modo che Locadex possa installare le dipendenze nell'ambiente sandbox e il **linter** in modo che possa mantenere lo stile del codice dopo le modifiche.
  * **Scegli le tue lingue**: la tua impostazione regionale sorgente (predefinita) e le lingue di destinazione in cui verrà tradotta la tua applicazione. Le lingue di destinazione possono essere selezionate tra tutte le 120 impostazioni regionali supportate da General Translation.

4. **Rivedi ed esegui il merge.** Locadex esegue automaticamente il suo workflow di setup per installare la libreria i18n, configurare il tuo Progetto e aggiungere l'infrastruttura di traduzione. Il completamento potrebbe richiedere alcuni minuti. Apri la PR (usa **View on GitHub**), rivedi le modifiche ed esegui il merge per completare il setup.

Tutto qui! Dopo il merge della PR di setup, Locadex monitora il tuo main branch per i commit e aggiorna le traduzioni quando necessario. Rivedi le nuove PR oppure **abilita [auto-merge](/docs/platform/locadex/guides/auto-merging-prs)** e la tua app rimarrà tradotta senza interventi manuali.

Puoi avviare un'esecuzione manualmente in qualsiasi momento con **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