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

# Başlamadan önce

Node.js, Git, bir düzenleyici, Rust ve yerel derleme araçlarını yükleyin, depo davetinizi kabul edin, kiti indirin ve bilgisayarınızın ilk masaüstü çalıştırmaya hazır olduğunu doğrulayın.

## 1. Neyi çalıştırmak istediğinizi seçin

İnternet bağlantısı olan bir Windows, macOS veya Linux bilgisayar kullanın. Desktop uygulaması bu aynı bilgisayara kurulan yerel bir penceredir — telefon dahil değildir. Aşağıdaki adımlar araçları yükler ve projeyi indirir.

Bir depo, GitHub üzerinden aldığınız dosya klasörüdür. Bir Desktop satın alımı Desktop kit deposunu verir; All Platforms paketi monorepo'yu verir — üç uygulamayı da içeren bir klasör. Satın aldığınız deponun davetini kabul edin. Desktop deposu, Tauri kabuğunu — web uygulamanızı çevreleyen yerel pencereyi — içerir ancak Web arka ucu içermez, bu nedenle pencere ayrı çalışan bir arka uç adresine bağlanır.

Bu araçları bir kez hazırlayın. Araçların ve ilk yerel derlemenin indirilmesi beş dakikadan çok daha uzun sürebilir. Bu hazırlıkların ardından beş dakikalık rehberler başlıyor; yerel olarak çalıştırmak uygulamanızı internette yayınlamaz.


## 2. Node.js'yi yükleyin

Aşağıdaki resmi Node.js indirme sayfasını açın. 22 veya üzeri numaralı LTS sürümünü ve bilgisayarınız için yükleyiciyi seçin: Windows'ta .msi veya macOS'ta .pkg. İndirilen yükleyiciyi açın, varsayılanlarını koruyun ve kurulumu tamamlayın. Node.js, bilgisayarınızın uygulamanın JavaScript'ini çalıştırmasına olanak tanır; npm onunla birlikte yüklenir.

Kurulumdan sonra terminalinizi kapatıp yeniden açın. Windows'ta Başlat'ı açın, PowerShell yazın ve açın. MacOS'ta Command + Space tuşlarına basın, Terminal yazın ve Enter tuşuna basın. Linux'ta uygulamalar menünüzden Terminal'i açın. Aşağıdaki komutu yapıştırın ve Enter tuşuna basın. v22.x.x veya v24.x.x gibi bir sonuç, Düğümün kullanılabilir olduğunu doğrular. Komutun bulunamadığını veya tanınmadığını görürseniz terminali yeniden açın veya Düğümü PATH seçeneği etkinleştirilmiş olarak yeniden yükleyin.

[Resmi Node.js yükleyicileri](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3. Git'i ve bir metin düzenleyiciyi yükleyin

Aşağıdaki Git indirme sayfasını açın, işletim sisteminizi seçin ve yükleyicisini takip edin. Git özel deponuzu indirir ve dosya değişikliklerini kaydeder. MacOS'ta aşağıdaki komutu çalıştırmak Apple'ın komut satırı araçlarının kurulumunu sunabilir; kabul edin ve tamamlandıktan sonra komutu yeniden çalıştırın. Linux'ta Git sayfasında dağıtımınız için gösterilen kurulum komutunu kullanın.

Visual Studio Code'yi resmi indirme sayfasından yükleyin. Bu, projeyi açmak ve yapılandırma dosyalarını kaydetmek için kullanılan bir metin düzenleyicisidir. Açın, Dosya → Klasörü Aç (Dosya → MacOS'ta Aç) seçeneğini seçin ve daha sonra indirdiğiniz supastack klasörünü seçin. İlk yerel gösterimi tamamlamak için kod yazmanıza gerek yoktur.

Yeni açılan bir terminalde aşağıdaki komutu çalıştırın. Git versiyonunun başlayan bir sonuç Git'in hazır olduğu anlamına gelir. Komut eksikse yükleyiciyi tamamlayın ve terminali yeniden açın.

[Resmi Git yükleyicileri](https://git-scm.com/downloads/)

[Visual Studio Code indir](https://code.visualstudio.com/download)

```
git --version
```


## 4. GitHub davetinizi kabul edin

Satın alırken sağladığınız hesabı kullanarak tarayıcınızda GitHub'de oturum açın. GitHub davetiye e-postanızı açın, Daveti görüntüle ve erişimi kabul et seçeneğini seçin. Ardından davet edilen depoyu açın. Dosyalarını ve yeşil bir Kod düğmesini görmelisiniz. 404 genellikle davetin kabul edilmediği veya farklı bir GitHub hesabında oturum açtığınız anlamına gelir.

Kod → Yerel → HTTPS seçeneğini seçin ve gösterilen adresi kopyalayın. Bir sonraki adımda tam olarak bu adresi kullanın. Açılı ayraçlar içeren örnek adresler şablonlardır: köşeli ayraçları yapıştırmak yerine bunları değiştirin. Bir kuruluş adını tahmin etmenize veya özel havuzu herkese açık hale getirmenize gerek yoktur.


## 5. Projeyi bilgisayarınıza indirin

Projeleriniz için Belgeler gibi bir klasör seçin. Bu klasörü Dosya Gezgini veya Finder'da açın. Windows'ta boş bir alana sağ tıklayın ve Terminalde Aç'ı seçin, ardından gerekiyorsa PowerShell'yi seçin. MacOS'ta Terminal'i açın, cd yazın ve ardından bir boşluk bırakın, klasörü terminale sürükleyin ve Enter tuşuna basın. Terminal artık bu klasörde çalışıyor.

Aşağıdaki ilk komutta YOUR_COPIED_HTTPS_ADDRESS'yi az önce kopyaladığınız HTTPS adresiyle değiştirin. Her seferinde bir satır çalıştırın. İlk satır supastack adında yeni bir klasör oluşturur; ikinci satır buna girer. Git oturum açmanızı isterse tarayıcıda oturum açma işlemini tamamlayın. GitHub hesabınızın şifresini Git şifresi olarak kullanmayın. Tarayıcıda oturum açma kullanılamıyorsa GitHub'nin aşağıda bağlantısı verilen HTTPS kimlik doğrulama kılavuzunu izleyin.

Başarı: supastack klasörü package.json, pnpm-workspace.yaml, apps ve packages içerir. Bir Desktop checkout, apps içinde yalnızca masaüstü kabuğunu gösterir; All Platforms monorepo'su web ve mobil uygulamalarını da gösterir. Bu depo köküdür. Git hedefin zaten var olduğunu söylerse, başka bir boş klasör kullanın veya mevcut kopyayı açın; çalışmanızı silmeyin. Sonraki adım için bu terminali açık tutun.

[GitHub HTTPS kimlik doğrulama yardımı](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6. Corepack'yi ve sabitlenmiş paket yöneticisini kontrol edin

Aşağıdaki ilk komutu çalıştırın. Corepack, package.json dosyasında kayıtlı pnpm sürümünü seçer; pnpm, projenin kullandığı kitaplıkları indirir. Corepack bu sürümü indirmek için izin isterse y yazın ve Enter tuşuna basın. Bu ödeme pinleri pnpm 11.19.0; farklı bir paket yöneticisi seçmek yerine pinini saklayın.

Corepack eksikse npm install --global corepack'yi çalıştırın, terminalinizi yeniden açın ve yeniden deneyin. PowerShell, bir npm.ps1 veya corepack.ps1 betiğinin çalıştırılamayacağını söylüyorsa bu komut için corepack.cmd pnpm install dahil npm.cmd veya corepack.cmd'yi kullanın. Bilgisayarınızın yürütme ilkesini değiştirmenize gerek yoktur.

Filtrelenen ilk çalıştırma komutları doğrudan Corepack'yi çağırır. corepack pnpm dev gibi bir Turbo komutu kullanıyorsanız Turbo'nun ayrıca PATH üzerinde bir pnpm komutuna ihtiyacı vardır. Aşağıdaki Windows kurulumu, bu komutu kullanıcı tarafından yazılabilen bir klasörde oluşturur; PATH değişikliği yalnızca geçerli terminal için sürer. pnpm eksikse yeni bir terminal açtıktan sonra bu bloğu tekrar çalıştırın. MacOS/Linux'ta corepack enable'yi çalıştırın; bir izin hatası bildirirse bunun yerine filtrelenmiş ilk çalıştırma komutunu kullanın.

[Bir komutu nasıl çalıştıracağınızı ve bir dosyayı nasıl düzenleyeceğinizi öğrenin](https://supastack.dev/tr/docs/desktop/terminal-basics.md)

```
corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"
```


## 7. Rust ve yerel derleme araçlarını yükleyin

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.

[Tauri'nin işletim sistemi önkoşul kontrol listesi](https://tauri.app/start/prerequisites/)

[Resmi Rust yükleyicisi](https://rustup.rs/)

```
rustc --version
cargo --version
```


## 8. Desktop kılavuzlarıyla devam edin

Node ve Git sürümleri yazdırdığında, Corepack sabitlenmiş pnpm'i seçebildiğinde, rustc ve cargo sürümleri yazdırdığında ve terminaliniz package.json içeren klasörde olduğunda hazırsınız. Aşağıdan bir öğretici seçin.

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

[Masaüstü uygulamasını çalıştırın](https://supastack.dev/tr/docs/desktop/ship-in-5-minutes.md)

[Desktop teknoloji yığını ile tanışın](https://supastack.dev/tr/docs/desktop/tech-stack.md)


## Sonraki

[Komutlar, dosyalar ve yapılandırma](https://supastack.dev/tr/docs/desktop/terminal-basics.md)