İçeriğe atla
supastack
Dokümanlara göz atın
WebNext.js

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/tech-stack.md (or send Accept: text/markdown).

Teknoloji yığını

Kitin arkasındaki teknolojiler ve her birinin oynadığı rol.

Bu kılavuz hakkında sor
Şurada aç

Başlamadan önce

İndirdiğiniz supastack projenizi Visual Studio Code'de Dosya → Klasörü Aç'ı kullanarak açın ve ardından Terminal → Yeni Terminal'i seçin. Depo kökü package.json'u, uygulamaları ve paketleri içeren klasördür. Aşağıdaki komutu orada çalıştırın ve terminalini açık bırakın. Bir komut tanınmazsa devam etmeden önce araç kurulum kılavuzunu tamamlayın.

Önce platform eğitimini okuyun. Sunucu, tarayıcı veya telefon isteklerini yanıtlayan uygulama işlemidir. Web, apps/web/.env.local'yi okur, Expo, apps/mobile/.env.local'yi okur ve veritabanı geçiş komutları root .env'yi okur. Veritabanı olmayan/gösterge paneli gösterimi, Postgres'nin taşınmasını gerektiren gerçek/auth hesaplarından ayrıdır. Yalnızca telefona veya masaüstüne yönelik bir ödeme, ayrı olarak çalışan bir Web arka ucuna ihtiyaç duyar.

corepack pnpm --filter @supastack/web dev

Uygulama yığını

Web uygulaması, paylaşılan TypeScript paketlerinden oluşan bir Next.js uygulamasıdır — aynı paketler Expo mobil uygulamasını da besler. Ürün arayüzü, tasarım belirteçleri üzerinde CSS modülleri kullanır; bu sayede hata ayıklanacak çalışma zamanı CSS-in-JS yoktur ve nesne depolama S3 uyumludur. Aşağıdaki araçlar bilinçli seçilmiş varsayılanlardır.

Next.js + React

Web uygulaması, App Router ve React 19 sunucu bileşenleriyle Next.js 16 üzerinde çalışır.

TypeScript + Turborepo

TypeScript strict modu tüm pnpm çalışma alanında geçerlidir ve Turborepo derlemeleri koordine eder.

Better Auth

Better Auth kimlik motorudur; üzerinde standartlaşan ekipler için bir Auth.js motoru da mevcuttur.

Drizzle + PostgreSQL

Kalıcılık, PostgreSQL üzerinde Drizzle ORM ile sağlanır — her kaydın aktığı şema ve yardımcılar.

Faturalandırma

Stripe faturalandırması varsayılandır ve bir Lemon Squeezy bağdaştırıcısı dahildir.

Trigger.dev

Arka plan işleri Trigger.dev üzerinde çalışır.

İşlemsel e-posta

İşlemsel e-postalar Resend veya AWS SES üzerinden gönderilir.

Sentry + PostHog

Gözlemlenebilirlik Sentry ve PostHog üzerinden sağlanır.

Expo

Expo mobil uygulaması aynı TypeScript paketlerini kullanır; böylece sözleşme değişiklikleri her iki yüzeyde aynı anda tür denetiminden geçer. Expo, iOS ve Android için derlenir.

Paylaşılan modüller

Her yatay yetenek, küçük bir sözleşmeye sahip bir pakette yaşar: auth, db, billing, ai, jobs, email, storage, observability, config, i18n ve api. Uygulamalar bunları bir araya getirir; ürün alan mantığı kitin dışında kalır.

Sağlayıcı destekli her modül, varsayılan test ve geliştirme döngüsü faturalı bir hizmeti hiç çağırmasın diye sahte ya da yerel bir bağdaştırıcıyla gelir.

Doğrulama araçları

Vitest birim ve entegrasyon davranışını, Playwright tarayıcı akışlarını kapsar; ESLint ve Prettier kodu tutarlı tutar. Deterministik paket, sağlayıcı kimlik bilgileri olmadan çalışır; gerçek sağlayıcı kabulü ayrıca kapılı bir yoldur.

corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows

Sık sorulan sorular

14 soru

supastack nedir?

supastack, YZ destekli SaaS ürünleri oluşturmak için modüler bir temeldir. Ortak altyapıyı bir araya getirir, böylece ürüne özgü özelliklere odaklanabilirsiniz.

Web ve mobil destekliyor mu?

Evet. supastack, web ve mobil deneyimler için başlangıç noktası olarak Next.js ve Expo uygulamaları içerir.

Hangi kimlik doğrulama dahil?

Better Auth; e-posta/parola, OTP ve sosyal girişi kapsar. Kişisel çalışma alanları hesapla birlikte sağlanır, böylece ürün kayıtları ilk günden itibaren sınırlı kalır.

YZ'yi nasıl destekliyor?

supastack; yapılandırılabilir çok sağlayıcılı YZ, kullanım takibi, bütçeler ve şifreli kendi-anahtarını-getir desteği içerir.

Abonelikler nasıl ele alınıyor?

Kit üzerine kurulu ürünler için Stripe faturalama, abonelikler ve yetkilendirmeler ücretli erişim temelini oluşturur. Sağlayıcı gizli anahtarları yalnızca sunucuda kalır.

Ürüne özgü kodum nerede durur?

Ürüne özgü özellikler ayrı bir kod tabanında kalırken ürün, supastack'in temel modüllerini yapılandırır ve entegre eder.

supastack fiyatlandırması nasıl çalışır?

Kit, ömür boyu güncellemeli tek seferlik bir satın alımdır: 249 $'a Tek Platform (geçici tanıtım fiyatı — normal fiyat 349 $ üzerinden 100 $ indirim) — Next.js (Web), Expo (iOS ve Android) veya Tauri (macOS ve Windows Masaüstü) seçiminiz — ya da tüm platformları ve tam monorepo'yu içeren 499 $'lık Tüm Platformlar Paketi (geçici tanıtım fiyatı — normal fiyat 599 $ üzerinden 100 $ indirim); ek geliştirici koltuğu başına 75 $. Kit aboneliği yok. Bu sitedeki ödeme, lisans anahtarınızı e-postayla teslim eder ve depo erişimi GitHub davetiyle sağlanır.

Çalışma alanları verilerimi nasıl sınırlar?

Kullanıcıya ait kayıtlar workspaceId ile sınırlanır. Kimlik, yetkilendirmeler, YZ kullanımı, faturalama olayları ve denetim kayıtları kişisel çalışma alanı sınırının içinde kalır.

Arka plan işleri nasıl çalışır?

Trigger.dev açık iş çalışma zamanıdır. JobRunner sözleşmesi yalnızca enqueue, status ve cancel vaat eder — iş akışı semantiği Trigger.dev'e özgü ve açık kalır.

E-posta, tanıtım yazılarından nasıl farklı?

İşlemsel e-posta, tamamlanma bildirimleri gibi ürün iş akışlarını kapsar. Soğuk tanıtım ve kampanyalar, bu kitin e-posta modülünün dışında kalan ürün konularıdır.

Mobil satın almalar nasıl çalışır?

Mobil uygulama RevenueCat ile yerel satın alma ve geri yükleme sunar; erişimi sunucunuz doğrular. Yayınlamadan önce mağaza hesaplarını yapılandırın ve cihaz testlerini tamamlayın. Web faturalandırması ayrı kalır.

YZ sağlayıcı anahtarları nerede durur?

Kendi-anahtarını-getir kimlik bilgileri şifrelidir ve yalnızca sunucuda kalır. Anahtarlar günlüklerden gizlenir; kullanım ve bütçeler çalışma alanı düzeyinde görünür kalır.

Ödeme hangi ödeme yöntemlerini kabul ediyor?

Stripe tarafından barındırılan ödeme sayfası kartları kabul eder; cüzdanlar Stripe hesabında etkinleştirildiğinde Alipay ve WeChat Pay de sunabilir — Çin'deki alıcılar için kullanışlı. Cüzdan yetkilendirmeleri eşzamansız onaylanır; ödeme tamamlanır tamamlanmaz lisans sayfası güncellenir.

Geri ödeme alabilir miyim?

Depoya erişim kazandıktan sonra supastack sonsuza kadar sizin olur, bu nedenle geri ödeme yapılamaz. Ancak içiniz rahat olsun: kendiniz veya müşterileriniz için sınırsız sayıda ürün geliştirip yayınlamak üzere ömür boyu güncellemeler içeren eksiksiz kaynak koduna sahip olursunuz. Yalnızca kodu yeniden satamaz veya depoyu bir başlangıç kiti ya da şablon olarak yeniden dağıtamazsınız.

TR
Tema