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/web/before-you-start.md (or send Accept: text/markdown).
Başlamadan önce
Node.js, Git ve bir düzenleyici yükleyin, depo davetinizi kabul edin, kiti indirin ve bilgisayarınızın ilk çalıştırmaya hazır olup olmadığını kontrol edin.
1. Neyi çalıştırmak istediğinizi seçin
İnternet bağlantısı olan bir Windows, macOS veya Linux bilgisayar kullanın. Bir tarayıcı Web uygulamasını çalıştırır; bir telefon Mobil uygulamayı çalıştırır; Masaüstü uygulaması kendi penceresinde açılır. Aşağıdaki kurulum adımlarını telefonunuz tek başına gerçekleştiremez.
Depo, GitHub aracılığıyla aldığınız dosyaların bulunduğu klasördür. Web, Mobil ve Masaüstü satın alımlarının her biri ilgili kit deposunu sağlar; Tüm Platformlar paketi, üç uygulamayı da içeren bir klasör olan monorepo'yu sağlar. Satın aldığınız deponun davetini kabul edin. Mobil veya Masaüstü ödeme için yine de erişilebilir bir Web arka ucuna ihtiyaç vardır: hesapları ve verileri yöneten sunucu. Bu istemci depoları Web sunucusunu içermez.
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.
node --version
npm --version3. 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.
git --version4. 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ılı: supastack klasörü package.json, pnpm-workspace.yaml, uygulamalar ve paketleri içerir. Bu depo köküdür. Git, hedefin zaten mevcut olduğunu söylüyorsa farklı bir boş klasör kullanın veya mevcut klonu açın; çalışmanızı silmeyin. Bir sonraki adım için bu terminali açık tutun.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. 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.
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. Platformunuzla devam edin
Node ve Git sürümleri yazdığında, Corepack sabitlenmiş pnpm'yi seçebildiğinde ve terminaliniz package.json'ı içeren klasörde olduğunda hazırsınız demektir. Aşağıdan bir eğitim seçin. Docker, Web gösterimi için isteğe bağlıdır; gerçek hesaplar için daha sonra bir veritabanı gerekir. Masaüstü ayrıca Rust ve yerel derleme araçlarına ihtiyaç duyar; eğitimi bunları başlatma komutundan önce açıklar.