> ## 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 # Masaüstü genel bakış Aynı web uygulamasını saran bir Tauri webview kabuğu — ikinci bir ürün değil, varlık. ## Başlangıç seviyesinde izlenecek yol Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun ve Rust ve işletim sistemi önkoşulları da dahil olmak üzere Masaüstü yerel kurulumunu tamamlayın. Kod bloğu monorepoda hem web uygulamasını hem de Tauri'yi başlatır; Yalnızca masaüstü ödemesinde, filtrelenmiş komutunu yalnızca erişilebilir bir web arka ucunu ayrı olarak başlattıktan sonra kullanın. Tauri bu arka ucu yükler. 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. Masaüstü yerel kurulumunu takip edin, ardından uygulamayı Tauri penceresinde açın ve tarayıcıda kullandığınız web hesabında oturum açın. 2. Bir çalışma alanı sayfasını ziyaret edin, pencereyi tepsiden gizleyin/gösterin ve çağırma kısayolunu deneyin. 3. Tauri yapılandırılmış arka ucu yüklediğinden ekranın web uygulamasıyla eşleşmesi gerekir. Boşsa `SUPASTACK_APP_URL`'nin ulaşılabilir çalışan bir web uygulamasına işaret ettiğini doğrulayın. Özel kod için, sağlanan `prompts/README.md` ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için `prompts/new-app-screen.md` veya genel bir sayfa için `prompts/new-landing-page.md`. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` ve eşleşen `.ai/` aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın. [Başlamadan önce](https://supastack.dev/tr/docs/web/before-you-start.md) [Terminal temelleri](https://supastack.dev/tr/docs/web/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/web/agents.md) ``` # Monorepo: start the web app and desktop shell together corepack pnpm dev:desktop # Desktop-only checkout: start Tauri after a web backend is already reachable corepack pnpm --filter @supastack/desktop dev ``` ## Tek ürün kullanıcı arayüzü, yerel kabuk `apps/desktop`, web uygulamanız üzerinden bir Tauri web görünümüdür. Ürün kullanıcı arayüzünü, kimlik doğrulamasını ve sohbeti web ile paylaşır; yerel pencere/tepsi davranışı `src-tauri/src/lib.rs`'de bulunur. Erişilebilir bir web arka ucuna ihtiyaç duyar ve bağımsız bir ürün arayüzünü bir araya getirmez. ## Yerel kabuk özelliklerini kullanın Kabuk, bir tepsi menüsü, tepsiye yakın, tek örnekli odaklama, küresel çağrı kısayol tuşu, yerel gezinme/görüntüleme menüleri, sistem tarayıcısındaki harici bağlantılar, `supastack://` derin bağlantı çağrısı, hatırlanan pencere durumu ve çevrimdışı Yeniden Deneme katmanı sunar. `SUPASTACK_APP_URL` arka ucu seçer: önce geçerli çalışma zamanı değeri, ardından derleme zamanı değeri, sonra localhost. `SUPASTACK_DESKTOP_HOTKEY`, `CmdOrCtrl+Shift+Space` kısayolunu geçersiz kılar. İmzalı sürüm derlemeleri `SUPASTACK_UPDATER_ENDPOINT` ve `SUPASTACK_UPDATER_PUBKEY` değerlerini enjekte eder; uç nokta yolu `{{channel}}` içerdiğinde uygulama menüsü **Beta Updates** seçeneğini (`stable` veya `beta`, çalışma zamanında `SUPASTACK_UPDATE_CHANNEL` ile geçersiz kılınabilir) etkinleştirir. ## Masaüstü yolunuzu seçin Yerel iş için web ve masaüstünü birlikte çalıştırın, ardından platform önkoşullarıyla birlikte yerel hedefi oluşturun ve doğrulayın. Mağaza imzalama, yükleyiciler ve fiziksel masaüstü davranışı ayrı bir kabul gerektirir. [Tauri masaüstünü 5 dakikada kurun](https://supastack.dev/tr/docs/desktop/ship-in-5-minutes.md) [Pencere, tepsi ve kısayol tuşu davranışı](https://supastack.dev/tr/docs/desktop/run.md) [Masaüstü derlemeleri ve dağıtımı](https://supastack.dev/tr/docs/desktop/release.md) ## İkinci bir uygulama değil, webview kabuğu apps/desktop bir Tauri 2.x kabuğudur. src-tauri içindeki Rust çekirdeği pencereyi, sistem tepsisini ve genel kısayolu yönetirken webview web uygulamasını yükler. Arayüz, kimlik doğrulama, faturalama ve AI aynı Next.js kod tabanından gelir — masaüstü yüzeyi paralel bir ürün değil, varlık ekler. Kabuk, web uygulaması yüklenirken gösterilen apps/desktop/ui altında bir yer tutucu sayfa taşır; böylece soğuk başlatma asla boş pencere göstermez. ## Kabuğu bir dağıtıma yönelt Pencere hedefi sırayla çözülür: çalışma zamanı SUPASTACK_APP_URL, ardından derleme zamanı SUPASTACK_APP_URL, ardından http://localhost:3000. Yalnızca http ve https URL'leri kabul edilir — boş veya web dışı değerler bir sonraki adaya düşer. Geliştirme açısından bu, kabuğun corepack pnpm dev'nin hizmet ettiği şeye bağlandığı anlamına gelir. Üretim için, değişkeni derleme zamanında dağıtılan web uygulamanızda hazırlanacak şekilde ayarlayın. ## Sırlar sunucuda kalır Kabuk sağlayıcı kimlik bilgisi taşımaz. Webview, tarayıcının kullandığı aynı kimlik doğrulamalı API yüzeyiyle konuşur — sağlayıcı anahtarları, oturum sırları ve faturalama yapılandırması sunucuda kalır. com.supastack.desktop paket tanımlayıcısı ve varsayılan yetenek kümesi (core:default) webview'i sandbox'ta tutar; src-tauri/capabilities içindeki izinleri yalnızca yerel bir özellik gerektirdiğinde genişletin. Kuruluma devam etmek için [Kabuğu çalıştırma ve yapılandırma](https://supastack.dev/tr/docs/desktop/run.md) kılavuzunu okuyun. ## Sonraki [Masaüstü uygulamasını 5 dakikada çalıştırın](https://supastack.dev/tr/docs/desktop/ship-in-5-minutes.md)