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

> Variáveis de plataforma e URLs de componentes irmãos injetadas em seu app.

# Ambiente

Kazzle injeta um pequeno conjunto de variáveis de plataforma em processos de app. Suas próprias credenciais vêm do vault através de `kazzle.config.ts`.

## Variáveis de processo

| Variável         | Descrição                                         | Exemplo                  |
| ---------------- | ------------------------------------------------- | ------------------------ |
| `PORT`           | A porta que seu processo deve escutar             | `3000`                   |
| `HOST`           | O host para vincular                              | `0.0.0.0`                |
| `KAZZLE_API_URL` | URL base usada pelos helpers de runtime do Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` e `KAZZLE_API_URL` são definidas para componentes de processo. Kazzle não cria chaves de API automaticamente para processos de app; adicione credenciais explícitas apenas quando seu app realmente precisar delas.

Seu processo deve vincular a `HOST:PORT`. Kazzle gerencia roteamento de preview e domínios de produção acima disso.

## URLs de componentes irmãos

Quando um app tem múltiplos componentes, Kazzle pode injetar URLs que permitem um componente alcançar outro:

| Variável                          | Descrição                               |
| --------------------------------- | --------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL para um componente irmão em runtime |

O nome vem do campo `name` do componente: em maiúsculas, caracteres não-alfanuméricos se tornam underscores. Um componente nomeado `API Server` se torna `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Essas URLs apontam para o componente irmão implantado quando um existe. Caso contrário, apontam para o endereço de desenvolvimento atual daquele componente irmão.

## Credenciais de app

Credenciais de app alcançam um componente através de uma coleção de segredos + ambiente. Armazene o segredo no vault com o nome que você quer como chave de variável de ambiente (por exemplo `KAZZLE_API_KEY`), depois aponte o componente para aquela coleção + ambiente:

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

Use `KAZZLE_API_KEY` para chamadas aos endpoints `/ai/*` do Kazzle a partir de um app gerado. Nunca exponha chaves privadas através de `VITE_*`; esses valores são agrupados em código de navegador.