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

# Середовище

> Змінні платформи та URL-адреси сусідніх компонентів, введені в ваш додаток.

# Середовище

Kazzle вводить невеликий набір змінних платформи в процеси додатків. Ваші власні облікові дані надходять із сховища через `kazzle.config.ts`.

## Змінні процесу

| Змінна           | Опис                                                             | Приклад                  |
| ---------------- | ---------------------------------------------------------------- | ------------------------ |
| `PORT`           | Порт, на якому повинен слухати ваш процес                        | `3000`                   |
| `HOST`           | Хост для прив'язки                                               | `0.0.0.0`                |
| `KAZZLE_API_URL` | Базова URL-адреса, яку використовують помічники виконання Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` та `KAZZLE_API_URL` встановлюються для компонентів процесу. Kazzle не створює ключі API автоматично для процесів додатків; додавайте явні облікові дані лише коли ваш додаток їх дійсно потребує.

Ваш процес повинен прив'язатися до `HOST:PORT`. Kazzle обробляє маршрутизацію попереднього перегляду та виробничі домени поверх цього.

## URL-адреси компонентів-сусідів

Коли додаток має кілька компонентів, Kazzle може вводити URL-адреси, які дозволяють одному компоненту досягти іншого:

| Змінна                            | Опис                                           |
| --------------------------------- | ---------------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL-адреса компонента-сусіда під час виконання |

Назва походить від поля `name` компонента: великі літери, не буквено-цифрові символи стають підкресленнями. Сусід названий `API Server` стає `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

Ці URL-адреси вказують на розгорнутого сусіда, якщо він існує. Інакше вони вказують на поточну адресу розробки для цього компонента-сусіда.

## Облікові дані додатку

Облікові дані додатку досягають компонента через колекцію секретів + середовище. Збережіть секрет у сховищі з назвою, яку ви хочете як ключ змінної середовища (наприклад `KAZZLE_API_KEY`), потім вкажіть компоненту на цю колекцію + середовище:

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

Використовуйте `KAZZLE_API_KEY` для викликів до кінцевих точок `/ai/*` Kazzle з генерованого додатку. Ніколи не розкривайте приватні ключі через `VITE_*`; ці значення вбудовуються в код браузера.