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

# Lingkungan

> Variabel platform dan URL sibling yang disuntikkan ke aplikasi Anda.

# Lingkungan

Kazzle menyuntikkan serangkaian kecil variabel platform ke dalam proses aplikasi. Kredensial Anda sendiri berasal dari vault melalui `kazzle.config.ts`.

## Variabel proses

| Variabel         | Deskripsi                                             | Contoh                   |
| ---------------- | ----------------------------------------------------- | ------------------------ |
| `PORT`           | Port yang harus didengarkan oleh proses Anda          | `3000`                   |
| `HOST`           | Host untuk mengikat                                   | `0.0.0.0`                |
| `KAZZLE_API_URL` | URL dasar yang digunakan oleh pembantu runtime Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST`, dan `KAZZLE_API_URL` diatur untuk komponen proses. Kazzle tidak membuat kunci API secara otomatis untuk proses aplikasi; tambahkan kredensial eksplisit hanya ketika aplikasi Anda benar-benar membutuhkannya.

Proses Anda harus mengikat ke `HOST:PORT`. Kazzle menangani perutean pratinjau dan domain produksi di atasnya.

## URL komponen sibling

Ketika aplikasi memiliki beberapa komponen, Kazzle dapat menyuntikkan URL yang memungkinkan satu komponen menjangkau komponen lain:

| Variabel                          | Deskripsi                               |
| --------------------------------- | --------------------------------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | URL untuk komponen sibling saat runtime |

Nama berasal dari bidang `name` komponen: huruf besar, karakter non-alfanumerik menjadi garis bawah. Sibling bernama `API Server` menjadi `KAZZLE_APP_COMPONENT_API_SERVER_URL`.

URL ini menunjuk ke sibling yang diterapkan jika ada. Jika tidak, mereka menunjuk ke alamat pengembangan saat ini untuk komponen sibling tersebut.

## Kredensial aplikasi

Kredensial aplikasi mencapai komponen melalui koleksi rahasia + lingkungan. Simpan rahasia di vault dengan nama yang Anda inginkan sebagai kunci variabel env (misalnya `KAZZLE_API_KEY`), kemudian arahkan komponen ke koleksi + lingkungan tersebut:

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

Gunakan `KAZZLE_API_KEY` untuk panggilan ke endpoint `/ai/*` Kazzle dari aplikasi yang dihasilkan. Jangan pernah mengekspos kunci pribadi melalui `VITE_*`; nilai-nilai tersebut digabungkan ke dalam kode browser.