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

# Proje yapısı

Rust kabuğunu, önyükleme sayfasını, sürüm betiklerini ve web uygulamasıyla sınırı bulun.

## Kurulum ve yapılandırma

Herhangi bir adımdan önce [Başlamadan önce](https://supastack.dev/tr/docs/desktop/before-you-start.md) ve [Terminal temelleri](https://supastack.dev/tr/docs/desktop/terminal-basics.md)'ni okuyun. supastack klasörünü kökünde açın — package.json içeren klasör. Bir Desktop checkout, apps/desktop'ı ve sürüm betiklerini içerir; All Platforms monorepo'su Web arka ucunu ve mobil uygulamayı ekler. Ortam değişkeni, yerel bir .env dosyasında veya barındırma panelinizde saklanan adlandırılmış bir ayardır; kabuk, SUPASTACK_APP_URL'yi bir dosyadan değil, bir terminal ayarı olarak okur.

1. `apps/desktop/src-tauri/src/lib.rs`'i açın — tüm yerel davranış bu tek dosyada yaşar.

2. `apps/desktop/src-tauri/`'yi gözden geçirin — yapılandırma, capabilities ve simgeler.

3. Depo kökünden `corepack pnpm --filter @supastack/desktop dev` çalıştırın, erişilebilir bir arka uçla.

Checkout yalnızca Tauri kabuğunu içerir: Rust kaynağı, yapılandırması, önyükleme sayfası ve sürüm betikleri. Ürün ekranları, pencerenin yüklediği web uygulamasında yaşar — yalnızca Desktop checkout'un kendi uygulama ekranları yoktur. Davranışı değiştirmeden önce AGENTS.md ve .ai/PROJECT_CONTEXT.md'yi okuyun; `.ai/` yansıma belgeleri tek bir dosyadan görünmeyen kararları kaydeder.

```
apps/desktop/src-tauri/src/    Rust — window, tray, menus, deep links, updater
apps/desktop/src-tauri/        tauri.conf.json, capabilities/, Cargo.toml, icons
apps/desktop/ui/               Boot page (index.html + boot.js) shown while loading
apps/desktop/scripts/          Release preflight + update manifest
docs/                          Runbooks incl. desktop updates
.agents/skills/                Task guides for coding agents
```


## Değişikliğin ait olduğu yer

Düzenlemeden önce değişikliğin hangi tarafa ait olduğuna karar verin: bir kullanıcının ürün UI'si olarak gördüğü her şey web uygulamasına aittir; yalnızca işletim sistemi düzeyindeki davranış Rust'a aittir.

[İlk masaüstü özelliğinizi oluşturun](https://supastack.dev/tr/docs/desktop/first-feature.md)

- Pencere, tepsi, menü, kısayol veya tek örnek davranışı → `apps/desktop/src-tauri/src/lib.rs`.
- Yeni bir webview izni → `apps/desktop/src-tauri/capabilities/default.json` — yalnızca bir yerel özellik ihtiyaç duyduğunda genişletin.
- Paket tanımlayıcısı, sürüm, güncelleyici uç noktası veya eklenti seçenekleri → `apps/desktop/src-tauri/tauri.conf.json`.
- Yer tutucu ürün simgeleri → `placeholder-icon.png`'yi değiştirin ve simge betiğini çalıştırın.
- Önyükleme, yükleme veya çevrimdışı kaplama davranışı → `apps/desktop/ui/`.
- Herhangi bir ürün ekranı, ayar veya veri → web uygulaması deposu — kabuk asla ürün UI'sini çatallamaz.


## Uygulama iş akışı

Yerel bir değişiklik için `lib.rs`'i düzenleyin, `cargo check` ve Rust testlerini çalıştırın, ardından pencereyi her hedef işletim sisteminde egzersiz edin — tepsi, kısayol ve derin bağlantı davranışı platforma göre değişir. `.agents/skills/`'deki `add-a-desktop-capability` becerisi aynı sırayı izler.


## Doğrulama ve sorun giderme

`cargo check` derleme hatalarını yakalar ve `cargo test` saf mantığı kapsar. Gerçek doğrulama, Windows, macOS ve Linux'ta çalışan penceredir — tepsi, kısayol ve derin bağlantılar yalnızca testlerle kanıtlanamaz.

```
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop typecheck
```


## Sonraki

[İlk özelliğinizi oluşturun](https://supastack.dev/tr/docs/desktop/first-feature.md)