> ## 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.

# Entorno

> Variables de plataforma y URLs de componentes hermanos inyectadas en tu app.

# Entorno

Kazzle inyecta un conjunto pequeño de variables de plataforma en los procesos de la app. Tus propias credenciales provienen del vault a través de `kazzle.config.ts`.

## Variables de proceso

| Variable         | Descripción                                             | Ejemplo                  |
| ---------------- | ------------------------------------------------------- | ------------------------ |
| `PORT`           | El puerto en el que debe escuchar tu proceso            | `3000`                   |
| `HOST`           | El host al que vincularse                               | `0.0.0.0`                |
| `KAZZLE_API_URL` | URL base utilizada por los helpers de runtime de Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` y `KAZZLE_API_URL` se establecen para componentes de proceso. Kazzle no crea claves API automáticamente para procesos de app; añade credenciales explícitas solo cuando tu app realmente las necesite.

Tu proceso debe vincularse a `HOST:PORT`. Kazzle maneja el enrutamiento de vista previa y dominios de producción sobre eso.

## URLs de componentes hermanos

Cuando una app tiene múltiples componentes, Kazzle puede inyectar URLs que permiten que un componente alcance otro:

| Variable                          | Descripción                               |
| --------------------------------- | ----------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL para un componente hermano en runtime |

El nombre proviene del campo `name` del componente: en mayúsculas, los caracteres no alfanuméricos se convierten en guiones bajos. Un componente llamado `API Server` se convierte en `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Estas URLs apuntan al componente hermano desplegado cuando existe uno. De lo contrario, apuntan a la dirección de desarrollo actual para ese componente hermano.

## Credenciales de app

Las credenciales de app llegan a un componente a través de una colección de secretos + entorno. Almacena el secreto en el vault con el nombre que desees como clave de variable de entorno (por ejemplo `KAZZLE_API_KEY`), luego apunta el componente a esa colección + entorno:

```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` para llamadas a los endpoints `/ai/*` de Kazzle desde una app generada. Nunca expongas claves privadas a través de `VITE_*`; esos valores se incluyen en el código del navegador.