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

# İlk özelliğinizi oluşturun

Bir yerel kabuk değişikliğinden doğrulanmış bir pencereye uçtan uca bir yürüyüş.

## Başlangıç seviyesinde izlenecek yol

Ön koşullar: aşağıdaki iki başlangıç kılavuzunu okuyun, Desktop yerel kurulumunu tamamlayın ve bu depoyu kökünde düzenleyicinizde açın. Kabuk, SUPASTACK_APP_URL'yi başlatırken bir terminal ayarı olarak okur — kaydedilmiş bir .env dosyasından değil.

Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır.

1. `.agents/skills/add-a-desktop-capability/SKILL.md`'yi açın — veya kodlama aracınızdan takip etmesini isteyin — ve küçük bir yerel değişiklik yapın, örneğin yeni bir Görünüm menü öğesi veya farklı bir çağrı kısayolu.

2. `cargo check` çalıştırın, kabuğu başlatın ve açık pencerede değişikliği egzersiz edin.

3. Göndermeyi planladığınız her işletim sisteminde tekrarlayın — tepsi, kısayol ve menü davranışı platforma göre değişir.

Özel kod için, davranışı, etkilediği menü veya kısayolu ve her işletim sisteminde ne olması gerektiğini adlandırın. Bu görevi kodlama aracınıza verin ve `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` ve dokunacağı dosyaların `.ai/` yansımalarını okumasını isteyin; düzenlemeden önce dosyaları ve kontrolleri listelesin; ve farkı size göstersin. Örnek değerler kullanın; asla gerçek bir gizli bilgi yapıştırmayın.

[Başlamadan önce](https://supastack.dev/tr/docs/desktop/before-you-start.md)

[Terminal temelleri](https://supastack.dev/tr/docs/desktop/terminal-basics.md)

[Masaüstü yerel kurulumu](https://supastack.dev/tr/docs/desktop/ship-in-5-minutes.md)

[Aracı istemleri ve proje belleği](https://supastack.dev/tr/docs/desktop/agents.md)


## Önce yerel mi yoksa ürün mü olduğuna karar verin

Bir kullanıcının ürün UI'si olarak deneyimlediği her şey — ekranlar, veriler, ayarlar — web uygulamasına aittir ve otomatik olarak pencereye gelir. Yalnızca işletim sistemi düzeyindeki davranış Rust'a aittir: pencereler, tepsi, menüler, genel kısayollar, oturum açmada başlatma ve güncelleme kontrolleri.

```
apps/desktop/src-tauri/src/lib.rs
apps/desktop/src-tauri/tauri.conf.json
apps/desktop/src-tauri/capabilities/default.json
```


## Webview kum kutusunu sıkı tutun

Webview yalnızca `capabilities/default.json`'ın listelediklerini çağırabilir. Yeni bir eklenti gerektiren bir değişiklik, `Cargo.toml`'a crate'i ekler, `lib.rs`'de kaydeder ve capabilities'de minimum izni verir — asla joker karakter değil.

Kalıcı kabuk durumu — pencere konumu, yakınlaştırma, güncelleme kanalı, pencere tercihleri — dahil edilen yardımcı dosyalar aracılığıyla uygulamanın veri dizininde yaşar, elle yönettiğiniz dosyalarda değil.


## Her hedef işletim sisteminde doğrulayın

cargo test çalıştırın, ardından Windows, macOS ve Linux'ta gerçek bir pencere açın: pencere durumu geri yükleme, tepsiye kapatma, tek örnek odak ve değişikliğiniz etkinken çağrı kısayolu. Bir işletim sisteminin geçmesi diğer ikisini kanıtlamaz.

[Yerel menüler ve pencere tercihleri](https://supastack.dev/tr/docs/desktop/menus.md)

[Desktop test kontrol listesi](https://supastack.dev/tr/docs/desktop/testing.md)


## Sonraki

[Bir kodlama ajanıyla geliştirin](https://supastack.dev/tr/docs/desktop/agents.md)