Proje yapısı

Kurulum ve yapılandırma

Herhangi bir adımdan önce, Başlamadan önce ve Terminal temelleri bölümlerini okuyun. Bu talimatlar, supastack monorepo'nun tamamını VS Kodunda açtığınızı varsayar; kök package.json dosyası depo kökünü işaretler. pnpm komutlarında çalışma alanı paketi bir uygulama veya paylaşılan kod klasörüdür; Üründe çalışma alanı, ekibin veri taşıyıcısı ve güvenlik sınırıdır. corepack pnpm --filter ... komutlar kökünden çalıştırılırken monorepodan bir paket seçer. Yalnızca senkronize edilmiş bir mobil veya masaüstü klasörü açtıysanız, Web arka ucunu, Docker kurulumunu veya kök komut dosyalarını içermez: arka ucu bu monorepodan veya erişilebilir bir barındırılan sunucudan çalıştırın ve platform klasörünün kendi komut dosyalarını kullanın. Ortam değişkeni, yerel bir .env dosyasında veya barındırma kontrol panelinizde depolanan adlandırılmış bir ayardır; İlgili uygulamayı değiştirdikten sonra yeniden başlatın ve sunucu sırlarını NEXT_PUBLIC_ ve EXPO_PUBLIC_ değerlerinin dışında tutun.

1. VS Code'da root package.json dosyasını açın, ardından web sitesi için apps/web'ye, Expo için apps/mobile'ye, masaüstü kabuğu için apps/desktop'ye ve paylaşılan parçalar için paketlere göz atın.

2. Depo kökünden corepack pnpm --filter @supastack/web dev komutunu çalıştırın.

3. http://localhost:3000.'yi açın Beklenen: Paylaşılan paketler aynı depoda kalırken Web uygulaması apps/web'den başlar; Masaüstü penceresi ikinci bir ürün içermek yerine bu Web uygulamasını sarar.

pnpm çalışma alanı; apps/web altında Next.js, apps/mobile altında Expo ve packages altında paylaşılan paketleri içerir. Çalışma alanı komutlarını depo kökünden çalıştırın. Uygulama rotaları paylaşılan modülleri bir araya getirir; ürüne özgü davranış tüketen ürüne aittir.

Davranışı değiştirmeden önce AGENTS.md ve .ai/PROJECT_CONTEXT.md dosyalarını okuyun. .ai/ altındaki dosya yansımaları, tek başına bileşenden anlaşılmayabilecek kararları ve kısıtları açıklar.

apps/web/app/       Routes and layouts
apps/web/src/       Web components and server composition
apps/mobile/        Expo application
packages/           Shared contracts and adapters
tests/              Cross-module and browser checks
docs/               Operational guides

Kopyalanacak komutlar

Bir komutun hangi klasörde çalıştığını görmek için yorumları takip edin. İki terminal etiketlenmişse, iki terminal penceresi açın ve ikincisini kullanırken ilk komutu çalışır durumda tutun.

corepack pnpm --filter @supastack/web dev

Değişikliğin ait olduğu yer

Düzenlemeden önce değişikliğin hangi uygulamaya ya da pakete ait olduğuna karar verin. Pratik kural: yalnızca bir ürün yüzeyi gerektiriyorsa o uygulamaya koyun; her yüzey gerektiriyorsa packages/ altındaki paylaşılan bir pakete koyun.

Web deposu ve Tüm Platformlar monorepo'su aşağıdaki klasörlerin hepsini içerir. Bağımsız bir Mobil veya Masaüstü kopyası yalnızca kendi uygulamasını içerir — sunucu kodu Web deposunda kalır.

• İlk özelliğinizi oluşturun

• Yeni bir pazarlama veya açılış sayfası → apps/web/app/ — herkese açık web sitesi.
• Oturum açılmış ürün içinde yeni bir ekran → rota için apps/web/app/ ve mantığı için apps/web/src/ — sayfalar paylaşılan paketleri bir araya getirir.
• Yeni bir API rotası → apps/web/app/api/ — Web uygulamasının sunucu yarısı.
• Her uygulamanın paylaştığı bir değişiklik — veritabanı tablosu, sözleşme, sağlayıcı adaptörü → packages/ içindeki eşleşen klasör.
• Yalnızca telefona özgü bir ekran → apps/mobile/ — kendi arka ucunu barındırmak yerine Web uygulamasının API'siyle konuşur.
• Yalnızca masaüstüne özgü bir davranış → apps/desktop/ — Tauri kabuğu Web uygulamasını sarar ve ürün arayüzünü neredeyse hiç çatallamaz.

Uygulama iş akışı

Kullanıcı eylemini sahiplenen rotayla başlayın, sunucu işleyicisini izleyin ve ardından çağırdığı paylaşılan paketi inceleyin. Bir arayüz bileşeni çalışma alanı çözümünü, faturalama yetkilendirmesini ya da sağlayıcı seçimini yeniden oluşturmamalıdır.

Rota eklerken herkese açık mı yoksa kimlik doğrulamalı mı olduğuna karar verin. Kullanıcı kayıtlarına erişmeden önce kimliği doğrulanmış sahipliği sunucuda çözün ve sunucu kimlik bilgilerini istemci içe aktarımlarının dışında tutun.

Doğrulama ve sorun giderme

Komut, filtreyle eşleşen hiçbir proje olmadığını bildirirse, terminalin package.json kök dosyasını içeren klasörde olup olmadığını kontrol edin. Bağlantı noktası 3000 zaten kullanımdaysa, önce diğer yerel Web sunucusunu durdurun. Ayrı bir Masaüstü sohbeti veya oturum açma uygulaması aramayın; masaüstü kabuğu Web arka ucunu yükler.

Bir paket sözleşmesini değiştirdikten sonra ilgili testleri ve tip kontrolünü çalıştırın. Paylaşılan tipleri değiştirirken hem web hem mobil tüketicileri inceleyin. Tek başına başarılı bir web derlemesi, yerel uygulamayla uyumluluğu kanıtlamaz.