For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/local-setup.md (or send Accept: text/markdown).
Yerel kurulum
Web gösterimini bilgisayarınızda tam Windows ve macOS komutlarıyla, ücretli sağlayıcı kimlik bilgileri olmadan ve gerçek veritabanı destekli hesaplara giden açık bir yolla çalıştırın.
1. Bilgisayarınızı hazırlayın ve projeyi açın
İlk tamamlama Başlamadan önce: GitHub davetini kabul edin, Node.js 22 veya daha yenisini, Git'i, bir düzenleyiciyi ve Corepack'yi yükleyin, ardından Web deponuzu veya Tüm Platformlar monorepo'sunu kopyalayın. Düzenleyicide supastack klasörünü açın ve Terminal → Yeni Terminal'i seçin. Düzenleyicinin üst düzey dosya listesinde package.json dosyasını görmelisiniz. Aşağıdaki tüm komutlar bu depo kökünden çalıştırılır.
Bu, yerel gösterimi yapay zeka, faturalandırma veya e-posta sağlayıcılarındaki hesaplar ve Docker olmadan başlatır. İlk kez bağımlı indirmeler için ekstra süre tanıyın. Sonraki adımlarda yalnızca Windows bloğunu veya yalnızca macOS/Linux bloğunu takip edin; ikisini de çalıştırmayın.
2. Yapılandırma dosyaları oluşturun — macOS / Linux
Terminalinizde aşağıdaki her satırı çalıştırın. İlk kopya, daha sonraki geçiş komutları için .env dosyasını oluşturur. İkincisi, Web sunucusunun gerçekten okuduğu apps/web/.env.local'yi oluşturur. Her ikisi de örneğin yerel ayarlarını içerir. Hedef dosyalardan herhangi biri zaten mevcutsa, onu saklayın ve kopyalama komutunu atlayın; kayıtlı ayarların üzerine yazmayın. Windows kullanıcıları bunun yerine bir sonraki bölümü kullanır.
corepack pnpm install, uygulamanın ihtiyaç duyduğu kitaplıkları indirir. Corepack, pnpm'yi indirmeyi isterse, y yanıtını verin. Bitinceye ve terminal istemi geri dönene kadar bekleyin. Hatasız son Done mesajı devam edebileceğiniz anlamına gelir.
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install2. Yapılandırma dosyaları oluşturun — Windows PowerShell
Bu komutları package.json'u içeren klasördeki PowerShell'de kullanın. .env veya apps/web/.env.local zaten mevcutsa kopyalama satırını atlayın ve ayarlarınızı koruyun. Sunucuyu başlatmadan önce kurulumun bitmesini bekleyin. Komut dosyasının yürütülmesi engellenirse, Başlamadan önce bölümünde açıklandığı gibi corepack yerine corepack.cmd'yi kullanın.
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install3. Web sunucusunu başlatın — bu terminali açık bırakın
Aşağıdaki komutu depo kökünden çalıştırın. Yalnızca Web uygulamasını başlatır, dolayısıyla hem Yalnızca Web deposunda hem de Tüm Platformlar monorepo'sunda çalışır. Terminalin Local: http://localhost:3000 ve Ready'yi göstermesini bekleyin. İlk sayfanın derlenmesi biraz uzun sürebilir. Terminal çalışmaya devam etmelidir; bu bekleniyor.
Tüm Platformlar monorepo'sunda, corepack pnpm dev, mevcut geliştirme çalışma alanlarını birlikte başlatır. apps/docs mevcutsa, bu ayrı dokümanlar uygulaması http://localhost:3001.'yi kullanır. Okuduğunuz genel kılavuzlar http://localhost:3000/docs. adresindeki Web uygulamasının bir parçasıdır. Bu öğreticiyi takip etmek için 3001 numaralı bağlantı noktasına ihtiyacınız yoktur.
corepack pnpm --filter @supastack/web dev4. Uygulamayı açın ve bir yerel görevi tamamlayın
Ana sayfayı görmek için tarayıcınızın adres çubuğunda http://localhost:3000'yi açın. Ardından http://localhost:3000/dashboard.'yi açın Önceden doldurulmuş adı ve e-postayı saklayın veya kendi test değerlerinizi girin ve Start local reference flow'ye tıklayın. Bu, bellek içi bir gösterim çalışma alanı oluşturur; kalıcı bir hesap oluşturmaz veya gerçek bir e-posta göndermez.
Gösterimde kenar çubuğundan AI task'yi açın, Yerel kabul kriterlerini özetleyin gibi kısa bir istek girin ve Queue local task'ye tıklayın. Durumu kuyruğa alındığında Run local task'ye ve ardından View result'ye tıklayın. Tamamlanmış çıktıyı ve Email queued durumunu görmelisiniz. Yapay zekanın tepkisi kasıtlı olarak sahte ve tekrarlanabilir; sıraya alınan e-posta yereldir. Sunucunun yeniden başlatılması bu gösterim verilerini temizler.
Gerçek kayıt için /auth'u kullanmak için önce Postgres'yi başlatın ve Veritabanı ve geçişler kılavuzunu kullanarak geçişleri uygulayın. Bundan sonra, EMAIL_PROVIDER=local'den gelen kaydolma veya OTP mesajları http://localhost:3000/mail-preview;'de incelenebilir, harici bir gelen kutusuna ulaşmazlar. Mobil oturum açma, gösteri oturumu yerine bu veritabanı destekli kimlik doğrulamayı da kullanır.
5. İlk çalıştırmada sık karşılaşılan sorunları durdurun, yeniden başlatın ve düzeltin
Başarı, ana sayfanın yüklenmesi, yerel çalışma alanının açılması ve sıradaki görevin tamamlanması anlamına gelir. Bitirdiğinizde sunucu terminaline tıklayın ve Ctrl + C tuşlarına basın. Daha sonra devam etmek için, depo kökündeki bir terminali yeniden açın ve sunucu komutunu 3. adımdan itibaren tekrarlayın; bağımlılıkları her zaman yeniden yüklemezsiniz.
localhost:3000 açılmazsa, sunucu terminalinin hala çalıştığını ve Ready'yi gösterdiğini kontrol edin. Eğer port 3000 kullanılıyorsa diğer geliştirme sunucusunu Ctrl + C ile durdurup tekrar deneyin. /auth'u açtıktan sonra bir veritabanı hatası görürseniz, tanıtım için /dashboard'a dönün veya veritabanı kılavuzunu tamamlayın. Yerel tanıtım eksikse apps/web/.env.local'de APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local ve JOB_PROVIDER=local'yi kontrol edin ve ardından yeniden başlatın.
Adı ve pazarlama metnini özelleştirmek için düzenleyicide apps/web/src/marketing/site-config.ts'yi açın. Tam alanlar ve doğrulama adımları için Markalama'yı takip edin. Gerçek hesabın görünüm ayarları için önce veritabanı kurulumunu tamamlayın, ardından /settings/appearance dosyasını açın. Otomatik kabul komutları bu ilk çalıştırma kılavuzundan daha uzun sürer; bunları Çalışma Alanı komutları altında bulabilirsiniz.
Kuruluma devam etmek için Veritabanını kurun kılavuzunu okuyun.