Yapılandırma

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
• Bir komutu nasıl çalıştıracağınızı ve bir dosyayı nasıl düzenleyeceğinizi öğrenin

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