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

# Komutlar, dosyalar ve yapılandırma

Komutları nereye yapıştıracağınızı, doğru proje klasörünü nasıl açacağınızı, .env dosyalarını nasıl düzenleyeceğinizi, Expo sunucusunu nasıl durduracağınızı ve gizli bilgileri paylaşmadan bir kurulum hatasını nasıl bildireceğinizi öğrenin.

## Terminale bir komut giriyor

Terminal, bilgisayarınıza ilişkin talimatları yazdığınız penceredir. Visual Studio Code'de, önce Dosya → Klasörü Aç'ı kullanarak supastack klasörünüzü açın, ardından Terminal → Yeni Terminal'i seçin. Yeni terminal bu klasörde başlar. Windows'ta terminalin + düğmesinin yanındaki menüyü kullanarak PowerShell'yi seçin. Bir macOS veya Linux terminalinde macOS/Linux bloklarını kullanın.

Yalnızca komut bloğunun içeriğini, her seferinde bir komut olacak şekilde yapıştırın ve Enter tuşuna basın. Çevredeki Markdown geri işaretlerini, PS C:\... gibi bir istemi veya örnek çıktıyı yapıştırmayın. # ile başlayan satırlar açıklamadır; hiçbir şeyi çalıştırmıyorlar. Bir sonraki komuta girmeden önce her kurulum komutunun bitmesini bekleyin. Bir sunucu komutu çalışmaya devam eder ve siz onu durdurana kadar yeni bir komut istemi döndürmez.


## Terminalin hangi klasörü kullandığını kontrol edin

Depo kökü, package.json, pnpm-workspace.yaml, uygulamalar ve paketleri içeren üst düzey supastack klasörü anlamına gelir. Bir adım aksini söylemediği sürece komutları orada çalıştırın. Aşağıdaki komut geçerli klasörü yazdırır; dosya listesinde package.json gösterilmelidir. Windows'ta PowerShell pwd ve ls de çalışır.

Liste yalnızca apps/mobile'ın içeriğini gösteriyorsa, cd ../.. yazın ve köke dönmek için Enter'a basın. Ev klasörünüzü gösteriyorsa, cd yazın, ardından boşluk ve kopyanın tam yolunu girin — boşluk içeriyorsa tırnak içinde. Genellikle proje klasörünü düzenleyicide açıp yeni bir terminal oluşturmak daha kolaydır.

```
pwd
ls
```


## Yapılandırma terminalde değil, bir dosyada gider

AI_PROVIDER=fake gibi bir blok konfigürasyon metnidir. Adlandırılmış .env dosyasını düzenleyicide açın, AI_PROVIDER= ile başlayan satırı bulun, değerini değiştirin ve Ctrl + S (macOS'ta Command + S) ile kaydedin. Her ayar KEY=value formunda bir satırı kaplar. Markdown geri tıklamalarını eklemeyin. Aynı anahtarın tek bir dosyada kopyalarından kaçının.

Expo için apps/mobile/.env.local'ı ve veritabanı geçiş komutları için kök .env'i kullanın. Expo, kök .env'i otomatik olarak yüklemez. Web arka ucu kendi apps/web/.env.local'ını okur; yalnızca Mobile checkout'ta bu dosya bu depoya değil, ayrı arka uç deposuna aittir. Arka uç adresi değişirse, apps/mobile/.env.local'deki EXPO_PUBLIC_API_URL'yi güncelleyin ve Expo'yu yeniden başlatın. Örnek dosyayı referans için değiştirmeden tutun.

Adları noktayla başlayan dosyalar dosya yöneticinizde gizlenmiş olabilir; editörün Explorer'ı bunları gösterir. Dosya adının .env.local.txt değil, tam olarak .env.local olduğundan emin olun. Bu yerel dosyalar parola içerebilir ve Git'in dışında tutulur; bunları yüklemeyin veya içeriklerini destek mesajlarına yapıştırmayın.

[Her ayarın anlamını bulun](https://supastack.dev/tr/docs/mobile/project-structure.md)


## Sunucuyu çalışır durumda tutun; komutlar için başka bir terminal kullan

Expo geliştirme sunucusu, siz çalışırken ekranlarınızı bir telefona veya simülatöre iletir. Bir öğretici QR kodunu taramanızı istediğinde terminalini açık tutun. Bir sunucu komutu, siz durdurana kadar çalışmaya devam eder ve yeni bir istem döndürmez.

Sunucu etkinken başka bir komut çalıştırmak için düzenleyicide Terminal → Yeni Terminal'i seçin. Yeni terminal aynı projeye açılan ayrı bir penceredir. Sunucuyu durdurmak için terminalini seçin ve Ctrl + C tuşlarına bir kez basın. Windows'ta Toplu işi sonlandır istenirse Y yazın ve Enter tuşuna basın. Tekrar başlatmadan önce normal uyarıyı bekleyin.

Expo ayarlarını düzenledikten sonra Expo'yu Ctrl + C ile durdurun ve ardından aşağıdaki komutu çalıştırarak yeniden başlatın ve önbelleğe alınmış paketi temizleyin. Bir kaynak dosyayı kaydetmek önizlemeyi genellikle otomatik olarak yeniler, ancak ortam değişiklikleri yeniden başlatma gerektirir.

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


## Bir arızayı okuyun ve faydalı yardım isteyin

Bir yükleme kırmızı hata metni verirse o adımda durun. Uygulamayı başlatmaya devam etmek yerine ilk hatayı okuyun. Komut bulunamadı genellikle bir aracın eksik olduğu anlamına gelir; package.json olmaması genellikle yanlış klasör anlamına gelir; ECONNREFUSED genellikle gerekli bir sunucunun veya veritabanının çalışmadığı anlamına gelir; EADDRINUSE, başka bir işlemin zaten bağlantı noktasını kullandığı anlamına gelir.

Yardım isterken işletim sisteminizi, URL kılavuzunu ve adım numarasını, girdiğiniz tam komutu ve ilk hata mesajını ekleyin. Parolaları, API anahtarlarını, belirteçleri ve herhangi bir URL veritabanının parola bölümünü kaldırın. .env dosyalarınızı göndermeyin. Hatanın ekran görüntüsü yardımcı olabilir ancak kopyalanabilir metnin teşhis edilmesi daha kolaydır.

[Belirli bir kurulum hatasıyla ilgili sorunları giderin](https://supastack.dev/tr/docs/mobile/troubleshooting.md)


## Sonraki

[Kurulumu bir ajana yaptırın](https://supastack.dev/tr/docs/mobile/agent-setup.md)