> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Yapılandırma

Uygulama yapılandırmasını açık ve sağlayıcı kimlik bilgilerini sunucuda tutun.

## Bir konfigürasyon değişikliği yapın ve kontrol edin

Çalışan bir Web uygulamasıyla başlayın. Düzenleyicide apps/web/.env.local'yi açın; yoksa Web eğitimini kullanarak .env.example dosyasını buraya kopyalayın. Zararsız bir ilk kontrol için EMAIL_PROVIDER=local'yi bulun ve yerel bırakın. Bu ayar, ürün e-postasını gerçek bir gelen kutusu yerine yerel önizlemeye gönderir. KEY=value hatlarını terminale yapıştırmayın.

Etkinleştirdiğiniz her hizmet için, o sağlayıcının kurulum kılavuzunu izleyin, yalnızca adı geçen değerleri değiştirin, dosyayı kaydedin, Web sunucusunu Ctrl + C ile durdurun ve aşağıdaki komutla yeniden başlatın. Doğrulamada eksik bir anahtar belirtilirse bu dosyayı yeniden açın ve bu anahtarı sağlayıcı kılavuzuyla karşılaştırın. Root .env dosyasını yalnızca veritabanı geçişleri tarafından kullanılan değerler için senkronize tutun; tek başına kopyalamak Next.js'yi yapılandırmaz.

[Bir yapılandırma anahtarı arayın](https://supastack.dev/tr/docs/web/project-structure.md)

[Bir komutu nasıl çalıştıracağınızı ve bir dosyayı nasıl düzenleyeceğinizi öğrenin](https://supastack.dev/tr/docs/web/terminal-basics.md)

```
corepack pnpm --filter @supastack/web dev
```


## Gerçekte ilk düzenleyeceğiniz ayarlar

Depo kökündeki `.env.example`, kitin anladığı ayarların tam envanteridir; o dosyada bulunmayan bir ad mevcut değildir. Başlangıçta yalnızca birkaçına dokunursunuz — geri kalanı, bir sağlayıcı kılavuzu isteyene kadar varsayılanlarında kalır.

Her uygulamanın hangi dosyayı okuduğu: kök `.env` migrasyon komutlarını besler, `apps/web/.env.local` Next.js sunucusunu besler ve `apps/mobile/.env.local` Expo'yu besler. Tek bir dosyayı düzenlemek diğerlerini yapılandırmaz, bu yüzden `DATABASE_URL` hem kök `.env`'de hem de `apps/web/.env.local`'de bulunur.

- `APP_URL` — uygulamanın bulunduğu adres; yerelde `http://localhost:3000`, üretimde alan adınız.
- `DATABASE_URL` — migrasyonların ve sunucunun paylaştığı Postgres bağlantı dizesi.
- `AUTH_SECRET` ve `CREDENTIAL_ENCRYPTION_KEY` — üretilen sırlar; `node scripts/setup-env.mjs` bunları sizin için doldurur (bu yardımcı Web deposu ve Tüm Platformlar monorepo'suyla birlikte gelir).
- Sağlayıcı seçiciler — `EMAIL_PROVIDER`, `AI_PROVIDER`, `BILLING_PROVIDER`, `JOB_PROVIDER`, `CAPTCHA_PROVIDER` — her biri hangi adaptörün çalışacağını seçer; `local`/`fake`/`off` varsayılanları hesap gerektirmez.
- `RESEND_API_KEY` veya `STRIPE_SECRET_KEY` gibi sağlayıcı sırları — yalnızca eşleşen sağlayıcı kılavuzu söylediğinde ekleyin.


## Ortam örneğiyle başlayın

Kök .env.example yapılandırma envanteridir. Paylaşılan doğrulama packages/config'de yaşar. Seçilen uygulama ortamını ve sağlayıcı modlarını birlikte gözden geçirin; yerel bir arayüz, üretim kimlik bilgisi stratejisi değildir.

Kimlik bilgisi gerektirmeyen referans modu, yerel/test uygulama yapılandırması ve sahte/yerel sağlayıcılar gerektirir. Bir üretim sağlayıcısı seçmek çalışma zamanı gereksinimlerini değiştirir.


## Gizli anahtarları API'nin arkasında tutun

Kimlik doğrulama sırları, veritabanı kimlik bilgileri, sağlayıcı anahtarları, Stripe sırları ve Trigger kimlik bilgileri yalnızca sunucudadır. Onlara asla NEXT_PUBLIC_ ya da EXPO_PUBLIC_ öneki eklemeyin. Kurulum sırasında yazdırmayın ya da hata yanıtlarına dahil etmeyin.

Tarayıcı, herkese açık yapılandırmayı ve izin verilen model takma adlarını alır. Çalışma alanı sahipliği, yetkilendirme kararları, bütçeler ve sağlayıcı seçimi sunucuda uygulanır.


## Değişikliği kullanmadan önce kontrol edin

Yapılandırmayı mevcut config paketi üzerinden doğrulayın ve ilgili deterministik testleri çalıştırın. Gerçek entegrasyonları doğrulamaya hazır olduğunuzda ayrıca etkinleştirilen sağlayıcı smoke yolunu kullanın.

```
corepack pnpm test
corepack pnpm check
corepack pnpm build
```


Kuruluma devam etmek için [Veritabanını kurun](https://supastack.dev/tr/docs/web/setup-database.md) kılavuzunu okuyun.


## Sonraki

[İlk özelliğinizi oluşturun](https://supastack.dev/tr/docs/web/first-feature.md)