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/terminal-basics.md (or send Accept: text/markdown).
Komutlar, dosyalar ve yapılandırma
Komutları nereye yapıştıracağınızı, doğru proje klasörünü nasıl açacağınızı, .env dosyalarını nasıl düzenleyeceğinizi, bir sunucuyu nasıl durduracağınızı ve sırları paylaşmadan bir kurulum hatasını nasıl bildireceğinizi öğrenin.
Terminale bir komut giriyor
Terminal, bilgisayarınıza ilişkin talimatları yazdığınız penceredir. Visual Studio Code'de, önce Dosya → Klasörü Aç'ı kullanarak supastack klasörünüzü açın, ardından Terminal → Yeni Terminal'i seçin. Yeni terminal bu klasörde başlar. Windows'ta terminalin + düğmesinin yanındaki menüyü kullanarak PowerShell'yi seçin. Bir macOS veya Linux terminalinde macOS/Linux bloklarını kullanın.
Yalnızca komut bloğunun içeriğini, her seferinde bir komut olacak şekilde yapıştırın ve Enter tuşuna basın. Çevredeki Markdown geri işaretlerini, PS C:\... gibi bir istemi veya örnek çıktıyı yapıştırmayın. # ile başlayan satırlar açıklamadır; hiçbir şeyi çalıştırmıyorlar. Bir sonraki komuta girmeden önce her kurulum komutunun bitmesini bekleyin. Bir sunucu komutu çalışmaya devam eder ve siz onu durdurana kadar yeni bir komut istemi döndürmez.
Terminalin hangi klasörü kullandığını kontrol edin
Depo kökü, package.json, pnpm-workspace.yaml, uygulamalar ve paketleri içeren üst düzey supastack klasörü anlamına gelir. Bir adım aksini söylemediği sürece komutları orada çalıştırın. Aşağıdaki komut geçerli klasörü yazdırır; dosya listesinde package.json gösterilmelidir. Windows'ta PowerShell pwd ve ls de çalışır.
Listede yalnızca apps/web veya apps/mobile içeriği gösteriliyorsa, cd ../.. yazın ve köke dönmek için Enter tuşuna basın. Ana klasörünüzü gösteriyorsa, cd yazın, ardından bir boşluk bırakın ve klonunuzun tam yolunu, boşluk içerdiğinde tırnak işaretleri içine alın. Proje klasörünü editörde açmak ve yeni bir terminal oluşturmak genellikle daha kolaydır.
pwd
lsYapılandırma terminalde değil, bir dosyada gider
AI_PROVIDER=fake gibi bir blok konfigürasyon metnidir. Adlandırılmış .env dosyasını düzenleyicide açın, AI_PROVIDER= ile başlayan satırı bulun, değerini değiştirin ve Ctrl + S (macOS'ta Command + S) ile kaydedin. Her ayar KEY=value formunda bir satırı kaplar. Markdown geri tıklamalarını eklemeyin. Aynı anahtarın tek bir dosyada kopyalarından kaçının.
Veritabanı geçiş komutları için root .env'yi, Next.js Web sunucusu için apps/web/.env.local'yi ve Expo için apps/mobile/.env.local'yi kullanın. Next ve Expo kendi uygulama klasörlerinde çalışır ve root .env dosyasını otomatik olarak yüklemez. Veritabanı bağlantısı değişirse DATABASE_URL'yi hem kök .env'de hem de apps/web/.env.local'de güncelleyin, böylece geçişler ve sunucu aynı veritabanını kullanır. Örnek dosyayı ileride başvurmak üzere değiştirmeden saklayın.
Adları noktayla başlayan dosyalar dosya yöneticinizde gizlenmiş olabilir; editörün Explorer'ı bunları gösterir. Dosya adının .env.local.txt değil, tam olarak .env.local olduğundan emin olun. Bu yerel dosyalar parola içerebilir ve Git'in dışında tutulur; bunları yüklemeyin veya içeriklerini destek mesajlarına yapıştırmayın.
Sunucuyu çalışır durumda tutun; komutlar için başka bir terminal kullan
Geliştirme sunucusu siz çalışırken uygulamanıza hizmet eder. Bir eğitimde localhost:3000'in açılması söylendiğinde terminalini açık bırakın. localhost bu bilgisayar anlamına gelir; :3000, uygulama tarafından kullanılan numaralı kapı gibi bağlantı noktasıdır. URL'yi terminale değil tarayıcınızın adres çubuğuna yerleştirin.
Sunucu etkinken başka bir komut çalıştırmak için düzenleyicide Terminal → Yeni Terminal'i seçin. Yeni terminal aynı projeye açılan ayrı bir penceredir. Sunucuyu durdurmak için terminalini seçin ve Ctrl + C tuşlarına bir kez basın. Windows'ta Toplu işi sonlandır istenirse Y yazın ve Enter tuşuna basın. Tekrar başlatmadan önce normal uyarıyı bekleyin.
Web ortamı ayarlarını düzenledikten sonra aşağıdaki komutla Web sunucusunu durdurup yeniden başlatın. Kaynak dosyanın kaydedilmesi normalde sayfayı otomatik olarak yeniler, ancak ortam değişikliklerinin yeniden başlatılması gerekir. Expo ayarlarını düzenledikten sonra, Expo'yi durdurun, ardından yeniden başlatmak ve önbelleğe alınmış paketi temizlemek için corepack pnpm --filter @supastack/mobile start --clear komutunu çalıştırın.
corepack pnpm --filter @supastack/web devBir arızayı okuyun ve faydalı yardım isteyin
Bir yükleme kırmızı hata metni verirse o adımda durun. Uygulamayı başlatmaya devam etmek yerine ilk hatayı okuyun. Komut bulunamadı genellikle bir aracın eksik olduğu anlamına gelir; package.json olmaması genellikle yanlış klasör anlamına gelir; ECONNREFUSED genellikle gerekli bir sunucunun veya veritabanının çalışmadığı anlamına gelir; EADDRINUSE, başka bir işlemin zaten bağlantı noktasını kullandığı anlamına gelir.
Yardım isterken işletim sisteminizi, URL kılavuzunu ve adım numarasını, girdiğiniz tam komutu ve ilk hata mesajını ekleyin. Parolaları, API anahtarlarını, belirteçleri ve herhangi bir URL veritabanının parola bölümünü kaldırın. .env dosyalarınızı göndermeyin. Hatanın ekran görüntüsü yardımcı olabilir ancak kopyalanabilir metnin teşhis edilmesi daha kolaydır.