For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).

Masaüstü uygulamasını 5 dakikada çalıştırın

Rust'u ve işletim sisteminizin derleme araçlarını hazırlayın, ulaşılabilir bir Web arka ucu başlatın, Tauri penceresini başlatın ve tepsiyi, kısayolu ve yerel görev davranışını doğrulayın.

Bu kılavuz hakkında sor

1. Genel ve yerel araçları yükleyin

Tamamla Başlamadan önce Masaüstü deponuzu veya Tüm Platformlar monorepo'nuzu kopyalayın ve düzenleyicide açın. Masaüstü, aynı Web uygulamasının etrafındaki yerel bir penceredir. Hesapların veya sohbetin ikinci bir uygulamasını içermez. Beş dakikalık başlatma, bağımlılıklar ve yerel araçlar yüklendikten sonra başlar; ilk kurulum ve Rust derlemesi genellikle daha uzun sürer.

Windows'ta aşağıdaki Tauri önkoşulları bağlantısını kullanarak Microsoft C++ Derleme Araçlarını yükleyin. Yükleyicide C++ ile Masaüstü geliştirme seçeneğini seçin, Windows SDK seçeneğini seçili tutun ve kurulumu tamamlayın. Microsoft Edge WebView2 Çalışma Zamanının kurulu olduğundan emin olun. Rust-init.exe'yi kullanarak Rust'u Rustup.rs'den yükleyin; varsayılan MSVC araç zincirini koruyun. Kurulumdan sonra terminalinizi tekrar açın.

MacOS'ta Terminal'de xcode-select --install komutunu çalıştırın ve yüklü değilse komut satırı araçları iletişim kutusunu tamamlayın. Rust'u, Rustup.rs adresinden macOS komutunu kullanarak yükleyin. Linux'ta, dağıtımınızın WebKitGTK, derleyici, tepsi ve sistem kitaplığı paketlerini tam olarak öğrenmek için Tauri önkoşul sayfasını takip edin ve ardından Rust'u yükleyin. Linux paket adları değişiklik gösterir; başka bir dağıtımın komutlarını çalıştırmayın.

Depo kökünde bir terminal açın ve aşağıdaki sürüm kontrollerini çalıştırın. Hem rustc hem de cargo sürümleri yazdırmalıdır; cargo, Rust'un oluşturma aracıdır. Bunlardan herhangi biri eksikse kurulumu tamamlayın ve devam etmeden önce terminali yeniden açın.

rustc --version
cargo --version
corepack pnpm install

2. Web arka ucunu başlatın veya seçin

Ödemeniz apps/web içeriyorsa Web eğitimini izleyin, apps/web/.env.local oluşturun, aşağıdaki komutu kullanarak Web sunucusunu ayrı bir terminalde çalıştırın ve çalışır durumda bırakın. Öncelikle tarayıcınızda http://localhost:3000'yi kontrol edin. /dashboard gösterimini veritabanı olmadan kullanabilirsiniz; /auth adresindeki gerçek oturum açma işleminin Postgres'ye taşınması gerekiyor.

Yalnızca masaüstü ödemesi apps/web. içermez. Ürününüz için sağlanan ayrı olarak çalışan Web arka ucunu kullanın ve çalıştığını doğrulamak için tarayıcınızda URL'yi açın. Masaüstü kabuğu sizin için arka ucu oluşturamaz. Bu klasör yoksa aşağıdaki Web komutunu denemeyin. 3. Adım, sağlanan bir arka uç adresinin nasıl seçileceğini gösterir.

# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev

3. Masaüstü penceresini başlatın

Arka uç çalışmaya devam ederken depo kökünde ikinci bir terminal açın. http://localhost:3000,'deki varsayılan yerel arka uç için aşağıdaki ilk komutu çalıştırın. Cargo kitaplıkları indirebilir ve kabuğu derleyebilir; Supastack penceresinin açılmasını bekleyin. İlk derleme sırasında derleyici mesajları bekleniyor.

Sağlanan bir arka uç için, aşağıdaki uygun işletim sistemi bloğundaki https://app.example.com'yi gerçek URL ile değiştirin. Yalnızca platformunuzun bloğunu çalıştırın. SUPASTACK_APP_URL, yerel işlem başladığında okunan bir terminal ortamı ayarıdır. Bunu yalnızca root .env dizinine koymak kabuğu yapılandırmayacaktır. Arka uç URL'yi yerleşik kullanıcı adlarından veya parolalardan uzak tutun.

Tüm Platformlar monorepo'sunda, pnpm, Başlamadan önce bölümünde açıklandığı gibi PATH üzerinde olduğunda, corepack pnpm dev:desktop Web ve Tauri'yi birlikte başlatabilir. Aşağıdaki filtrelenmiş komut, arka uç ayrı olarak çalışarak yalnızca Masaüstü ödemelerinde de çalışır.

# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev

4. Pencereyi, tepsiyi ve kısayolu kontrol edin

Başarı, pencerenin tarayıcıdaki arka ucunuzla aynı ana sayfayı görüntülediği anlamına gelir. Masaüstü penceresinde tarayıcı adres çubuğu yoktur. Kimlik bilgisi içermeyen gösterimi açmak için, tepsinin Quit eylemini kullanarak kabuktan çıkın, ardından Web sunucusu çalışmaya devam ederken işletim sisteminizin aşağıdaki bloğunu masaüstü terminalinde çalıştırın. Bu doğrudan / kontrol panelini yükler; Oradaki Web eğitiminin yerel görev adımlarını izleyin. Gerçek hesapta oturum açma, tıpkı tarayıcıda olduğu gibi arka uç veritabanını kullanır.

Kapat düğmesini kullanarak pencereyi kapatın: uygulama çıkmak yerine tepsiye gizlenmelidir. Tekrar göstermek için Supastack tepsi simgesine tıklayın veya Windows/Linux'ta Ctrl + Shift + Space veya macOS'ta Command + Shift + Space tuşlarına basın. Çıkmak için tepsinin Çıkış eylemini kullanın. Geliştirmeyi tamamen sonlandırmak için masaüstü terminalinde Ctrl + C tuşlarına basın ve ardından arka uç terminalini durdurun.

Pencere boşsa veya bir bağlantı sorunu gösteriyorsa öncelikle yapılandırılmış URL'yi bir tarayıcıda açın. Arka ucu başlatın veya URL'yi düzeltin, ardından Tauri'yi yeniden başlatın. Rust, linker.exe'nin bulunamadığını bildirirse Windows C++ iş yükünü yükleyin ve terminali yeniden açın. Linux bir sistem kitaplığının eksik olduğunu bildirirse dağıtıma özgü önkoşulları izleyin. Kısayol tuşu zaten alınmışsa tepsiyi kullanın ve değiştirmek için Yerel davranışı izleyin.

Bu, yerel bir geliştirme penceresi başlatır; imzalı bir yükleyici oluşturmaz veya bir uygulamayı yayınlamaz. Yükleyici derlemeleri, platform imzalama ve başka bir makinede test etme için Masaüstü dağıtımını takip edin. Windows derlemesi macOS veya Linux davranışını doğrulamaz.

# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev

Yerel uygulama URL'sini kullanın

Bir geçersiz kılma ayarı yoksa Tauri http://localhost:3000 adresini yükler. SUPASTACK_APP_URL değerini yalnızca yerel Next.js uygulamanız erişilebilir başka bir HTTP(S) kaynağı kullanıyorsa ayarlayın. Kimlik bilgisi içeren veya web dışı URL'ler reddedilir.

Geliştirme paket tanımlayıcısı ve sürüm yapılandırması üretim için hazır ayarlar değildir. Sürüm ön kontrolü ve platform imzalama için ayrı sürüm kılavuzuna bakın.