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/mobile/local-setup.md (or send Accept: text/markdown).

Mobil uygulamayı çalıştırın

Expo'yu ulaşılabilir bir geliştirme API'sine bağlayın.

Bu kılavuz hakkında sor

1. Bilgisayarı, telefonu ve arka ucu hazırlayın

Mobil depoyu veya Tüm Platformlar monorepo'yu başlatıp açmadan önce düzenleyicinizde tamamlayın. Depo kökündeki Terminal → Yeni Terminal'de aşağıdaki kurulum komutunu çalıştırın. Bitmesini bekleyin. Aşağıda bağlantısı verilen resmi Expo sayfasını kullanarak Expo Go'yi telefonunuza yükleyin; sürümü apps/mobile/package.json.'de kayıtlı Expo SDK sürümünü desteklemelidir

Arka uç, oturum açmayı, çalışma alanı verilerini ve AI isteklerini işleyen Web sunucusudur. Ödemeniz apps/web içeriyorsa, önce Web kurulumunu başka bir terminalde çalıştırın ve o sunucuyu çalışır durumda bırakın. Yerel kaydolmayı veya oturum açmayı denemeden önce Postgres kurulumunu tamamlayın. Yalnızca Mobil cihazlar için ödeme apps/web içermez: bunun yerine onu ayrı olarak sağlanan, çalışan arka ucunuza bağlayın. Expo'nin başlatılması arka ucu değil ekran önizleme sunucusunu başlatır.

Telefonunuzu ve bilgisayarınızı aynı Wi-Fi'ye bağlayın. Yerel bağlantıları engelliyorsa VPN'nin bağlantısını geçici olarak kesin. Bir telefonun localhost'si telefonun kendisi anlamına gelir. Fiziksel bir telefon veya Android cihaz için bilgisayarınızın özel ağ adresini kullanın; Aynı Mac'teki iOS Simulator http://localhost:3000,'yi kullanabilir ve Android Emulator genellikle http://10.0.2.2:3000.'yi kullanır

corepack pnpm install

2. Arka uç adresini bulun ve test edin

Windows'ta yeni bir PowerShell terminalinde ipconfig'i çalıştırın, aktif Wi-Fi adaptörünüzü bulun ve IPv4 Adresini okuyun. MacOS'ta Sistem Ayarları → Wi-Fi → Ayrıntılar → TCP/IP'yi açın ve IP adresini okuyun. Linux'ta ağ ayarlarınızı açın ve IPv4 Adresini okuyun. Bir adres 192.168.1.25 gibi görünebilir; sizinki genellikle farklı olacaktır.

Bilgisayarınızın adresi 192.168.1.25 ise, Web sunucusu çalışırken telefonun tarayıcısında http://192.168.1.25:3000'yi açın. Gerçek adresinizi değiştirin. Devam etmeden önce ana sayfanın yüklenmesi gerekir. Windows Güvenlik Duvarı isterse Node uygulamasına özel ağlarda izin verin. Yüklenmezse adresi, Wi-Fi'yi, güvenlik duvarını ve çalışan Web sunucusunu kontrol edin; Expo tüneli yalnızca önizleme paketini taşır ve ayrı API'nize erişilmesini sağlamaz.

# Windows PowerShell only:
ipconfig

3. Mobil uygulamanın yapılandırma dosyasını oluşturun

Düzenleyicinin Gezgini'nde uygulamalar → mobil'i genişletin, .env.local adında yeni bir dosya oluşturun ve aşağıdaki yapılandırmayı bu dosyaya yapıştırın. 192.168.1.25'i az önce test ettiğiniz adresle değiştirin veya sağladığınız HTTPS arka uç adresini kullanın. Dosyayı kaydedin. Tam yolu apps/mobile/.env.local'dir; root .env, Expo tarafından otomatik olarak okunmaz.

İlk önizleme için telefonun satın alma ayarını kapalı tutun. EXPO_PUBLIC_, bir ayarın telefon uygulamasına dahil edildiği anlamına gelir; dolayısıyla bu değerler yalnızca genel URL'leri, şemaları ve genel istemci ayarlarını içermelidir. Yapay zeka sağlayıcısını, veritabanını veya faturalandırma sırlarını buraya yapıştırmayın. Web sunucusunun kendi apps/web/.env.local'si vardır; Mobil dosyayı değiştirmek sunucuyu değiştirmez.

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4. Expo'yi başlatın ve önizlemeyi açın

Depo kökünden aşağıdaki komutu çalıştırın. QR kodunu ve Metro bekleme mesajını bekleyin. Bu terminali ve arka uç terminalini açık tutun. Android'de Expo Go'yi açın ve QR kodunu tarayın; iPhone'da Kamera'yı kullanın, kodu tarayın ve Expo Go'de açın. QR kodu, arka uç ana sayfanızı değil, geliştirme uygulamasını açar.

Başarı, uygulamanın oturum açma ekranının cihazınızda açılması anlamına gelir. Satın alma işlemleri kapalıyken bu bir kullanıcı arayüzü önizlemesidir; Oturum açmayı, kayıtlı çalışma alanlarını veya sohbeti test etmeden önce veritabanı destekli Web kimlik doğrulama kurulumunu tamamlayın. Hedefiniz kurulu bir simülatörse, Android için Expo terminalinde a tuşuna veya iOS için i tuşuna basın. iOS Simulator, macOS ve Xcode gerektirir; Windows'ta çalışamaz.

corepack pnpm --filter @supastack/mobile start

5. Önizleme hatalarından kurtulun ve gerçek akışları test edin

Expo Go uyumsuz bir proje bildirirse desteklenen SDK'yi apps/mobile/package.json ile karşılaştırın ve resmi Expo sayfasından uyumlu sürümü kullanın. Sadece mesajı kapatmak için kitin bağımlılık sürümlerini yükseltmeyin. Gerekli bir yerel modül mevcut değilse, söz konusu modülü içeren bir geliştirme yapısı için Mobil yapıları izleyin.

Oturum açma bir ağ hatası nedeniyle başarısız olursa, önce telefonun tarayıcısında URL arka ucunu yeniden deneyin. URL çalışıyor ancak oturum açma işlemi başarısız oluyorsa arka uç terminalini inceleyin ve Postgres ile geçişleri doğrulayın. Yerel /dashboard demo oturumu telefonda oturum açmanıza neden olmaz. Yapılandırma eski görünüyorsa Expo terminalinde Ctrl + C tuşlarına basın, ardından aşağıdaki yeniden başlatma komutunu çalıştırın ve önizlemeyi yeniden açın.

Expo Go, gerçek StoreKit veya Play Faturalandırma satın alma/geri yükleme davranışını kanıtlayamaz. EAS geliştirme derlemesi ve mağaza test hesapları için Uygulama içi satın almaları ve Mobil yapıları takip edin. İlk kez yerel derlemeler ve hesap kaydı beş dakikadan uzun sürebilir. Bu önizlemeyi durdurmak için Expo terminalinde Ctrl + C tuşlarına basın; işiniz bittiğinde arka ucu ayrı olarak durdurun.

corepack pnpm --filter @supastack/mobile start --clear