> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambiente

> Variabili di piattaforma e URL di componenti fratelli iniettati nella tua app.

# Ambiente

Kazzle inietta un piccolo set di variabili di piattaforma nei processi dell'app. Le tue credenziali provengono dal vault attraverso `kazzle.config.ts`.

## Variabili di processo

| Variabile        | Descrizione                                         | Esempio                  |
| ---------------- | --------------------------------------------------- | ------------------------ |
| `PORT`           | La porta su cui il tuo processo deve ascoltare      | `3000`                   |
| `HOST`           | L'host a cui associarsi                             | `0.0.0.0`                |
| `KAZZLE_API_URL` | URL di base utilizzato dai runtime helper di Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` e `KAZZLE_API_URL` sono impostati per i componenti di processo. Kazzle non crea chiavi API automaticamente per i processi dell'app; aggiungi credenziali esplicite solo quando la tua app ne ha effettivamente bisogno.

Il tuo processo deve associarsi a `HOST:PORT`. Kazzle gestisce il routing dell'anteprima e i domini di produzione sopra questo.

## URL dei componenti fratelli

Quando un'app ha più componenti, Kazzle può iniettare URL che permettono a un componente di raggiungere un altro:

| Variabile                         | Descrizione                              |
| --------------------------------- | ---------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL per un componente fratello a runtime |

Il nome proviene dal campo `name` del componente: maiuscolo, i caratteri non alfanumerici diventano underscore. Un componente denominato `API Server` diventa `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Questi URL puntano al componente fratello distribuito quando esiste. Altrimenti puntano all'indirizzo di sviluppo corrente per quel componente fratello.

## Credenziali dell'app

Le credenziali dell'app raggiungono un componente attraverso una raccolta di segreti + ambiente. Archivia il segreto nel vault con il nome che desideri come chiave della variabile d'ambiente (ad esempio `KAZZLE_API_KEY`), quindi punta il componente a quella raccolta + ambiente:

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

Usa `KAZZLE_API_KEY` per le chiamate agli endpoint `/ai/*` di Kazzle da un'app generata. Non esporre mai chiavi private attraverso `VITE_*`; questi valori sono raggruppati nel codice del browser.