# gt-node: General Translation Node.js SDK: Quickstart
URL: https://generaltranslation.com/it/docs/node/quickstart.mdx
---
title: Quickstart
description: Installa la libreria `gt-node` di General Translation e traduci il tuo primo servizio Node.js.
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/configuring
    - /docs/node/guides/storing-translations

---

`gt-node` traduce le stringhe nei server e nei servizi Node.js. Lo inizializzi una sola volta, associ l'impostazione regionale a ogni richiesta in arrivo e traduci le stringhe nei tuoi handler.

Usa `gt-node` per servizi backend come le API Express o Fastify. Per le app React usa [`gt-react`](/docs/react/react-quickstart); per Next.js usa [`gt-next`](/docs/react/nextjs-quickstart).

*Nota: `gt-node` richiede Node.js 18 o versioni successive. L'associazione dell'impostazione regionale per richiesta usa `AsyncLocalStorage` di `node:async_hooks`.*

## Cosa fa gt-node [#what-it-does]

`gt-node` ti offre:

* **Traduzione delle stringhe** con [`getGT`](/docs/node/reference/functions/get-gt), per stringhe locali all'handler.
* **Messaggi registrati** con [`msg`](/docs/node/reference/functions/msg) e [`getMessages`](/docs/node/reference/functions/get-messages), per costanti ed errori condivisi.
* **Traduzione a runtime** con [`tx`](/docs/node/reference/functions/tx), per contenuto dinamico.
* **Associazione dell'impostazione regionale per richiesta** con [`withGT`](/docs/node/reference/functions/with-gt), oltre ad helper per rilevare l'impostazione regionale della richiesta.

## Quickstart [#quickstart]

Installa la libreria, inizializzala, associa un'impostazione regionale a ogni richiesta e traduci una stringa.

### 1. Installa `gt-node`

Installa `gt-node` come dipendenza e la [CLI `gt`](/docs/cli/quickstart) come dipendenza di sviluppo.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt-node && npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add gt-node && yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add gt-node && bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add gt-node && pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Inizializza la libreria

Chiama [`initializeGT`](/docs/node/reference/functions/initialize-gt) una volta all&#39;avvio, prima di gestire le richieste. Passa le impostazioni regionali e le credenziali: `gt-node` non legge automaticamente `gt.config.json` né le variabili d&#39;ambiente.

```ts title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
});
```

### 3. Associa l’impostazione regionale della richiesta

Racchiudi ogni richiesta in `withGT` in modo che le funzioni di traduzione conoscano l’impostazione regionale di destinazione. Usa [`getRequestLocale`](/docs/node/reference/functions/get-request-locale) per rilevarla dall’header `Accept-Language`.

```ts title="server.js"
import express from 'express';
import { withGT, getRequestLocale } from 'gt-node';

const app = express();
app.use((req, res, next) => withGT(getRequestLocale(req), () => next()));
```

### 4. Traduci una stringa

All&#39;interno di un handler, usa `await getGT` per ottenere una funzione di traduzione per l&#39;impostazione regionale della richiesta, quindi traduci le stringhe. Interpola i valori con i segnaposto ICU.

```ts title="server.js"
import { getGT } from 'gt-node';

app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({ message: gt('Hello, {name}!', { name: 'Alice' }) });
});
```

### 5. Genera le traduzioni

Esegui la CLI prima di distribuire in produzione, così le traduzioni saranno disponibili a runtime.

```bash
npx gt translate
```

Consulta [Traduzione delle stringhe](/docs/node/guides/translating-strings) per capire quando usare `getGT`, `msg` e `tx`, e [Configurare gt-node](/docs/node/guides/configuring) per credenziali e consegna.
## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/detecting-locale
- /docs/node/guides/configuring
- /docs/node/guides/storing-translations