> ## 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, masaüstü geliştirme komutunu 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/desktop'ı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.

Veritabanı geçiş komutları için kök .env'i ve Web arka ucu için apps/web/.env.local'ı kullanın — yalnızca Desktop checkout'ta bu dosya ayrı arka uç deposuna aittir. Masaüstü kabuğu .env dosyalarını okumaz: SUPASTACK_APP_URL, başlatırken komut satırında geçtiğiniz bir terminal ortam ayarıdır, bir dosyada saklanan yapılandırma değildir. Ö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/desktop/project-structure.md)


## Geliştirme komutunu çalışır durumda tutun; komutlar için başka bir terminal kullanın

Masaüstü geliştirme komutu, Rust kabuğunu derler ve çalışırken pencereyi açar. Pencereyi test ederken 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.

Kabuk ayarlarını değiştirdikten sonra masaüstü komutunu Ctrl + C ile durdurun ve tekrar çalıştırın. Rust çekirdeği her başlangıçta yeniden derlenir; SUPASTACK_APP_URL'yi değiştirmek, kaydedilmiş bir dosyayı düzenlemek değil, bir sonraki çalıştırmada yeni değeri geçmek anlamına gelir.

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


## 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/desktop/troubleshooting.md)


## Sonraki

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