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

Giriş

supastack nedir, ne elde edersiniz ve çalışan bir uygulamaya giden yol.

Bu kılavuz hakkında sor

Buradan başlayın: ne aldınız

Kit, kişiselleştirebileceğiniz bir başlangıç uygulamasıdır. Web, tarayıcı arayüzü artı sunucu API'dir; Mobil telefon arayüzüdür; Masaüstü, Web uygulamasını görüntüleyen yerel bir penceredir. API, bir istemcinin oturum açmak veya verileri okumak için çağırdığı sunucu adresidir. Paylaşılan paketler, bu uygulamalar tarafından kullanılan yeniden kullanılabilir parçalardır.

Aşağıdaki Web yerel eğitimiyle başlayın. Kitaplıkları nasıl indireceğinizi, sunucuyu nasıl başlatacağınızı ve sahte bir AI task'yi nasıl çalıştıracağınızı tam olarak anlatır. Daha sonra kayıtlı hesaplar için veritabanını ekleyin, yalnızca ürününüzün ihtiyaç duyduğu sağlayıcıları seçin, markanızı özelleştirin ve barındırmayı hazırlayın. Teknik açıklamaları daha sonra okuyabilirsiniz; bunlar ilk demoyu açmak için ön koşul değildir.

Paylaşılan bir temelden inşa edin

supastack web, mobil ve masaüstünde AI SaaS için modüler bir temeldir. Next.js web kullanıcı arayüzünü ve API'yi taşır, Expo yerel referans akışları sağlar ve Tauri masaüstü kabuğu aynı web uygulamasını yükler. Paylaşılan paketler kimlik, çalışma alanları, faturalandırma, yapay zeka, işler, e-posta, depolama ve gözlemlenebilirliği yönetir.

Modüllerin birbirine nasıl uyduğunu anlamak için yerel referans akışıyla başlayın. Üretim sağlayıcılarını ancak ortamınızda akış çalışmaya başladıktan sonra yapılandırın.

Yolunuzu bulun

Uygulamalar paylaşılan paketleri oluşturur. Ürüne özgü özellikler, yeniden kullanılabilir çekirdekten ziyade tüketen ürün kod tabanına aittir.

apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery

Başlangıç noktanızı seçin

Beş dakikalık yerel kurulumla başlayın. Ardından her kılavuzun altındaki Kuruluma devam et bağlantısını izleyin: dağıtımı hazırlamadan önce veritabanını, kimlik doğrulamayı, planları ve sağlayıcıları yapılandırın. Her özelliği, sağlayıcıyı, bileşeni ve referansı bulmak için eksiksiz dokümantasyon dizinini kullanın.

Yerel altın yol, projenin geliştirme ortamında geçti. Süre tutulan temiz klon kurulumu, gerçek sağlayıcı duman testi, dağıtım ve fiziksel cihaz kabulü ayrı doğrulama adımları olarak kalır.

supastack'e hoş geldiniz

supastack, YZ SaaS ürünleri için modüler bir kittir: bir Next.js web uygulaması, bir Expo mobil uygulaması ve bir Tauri masaüstü kabuğu — hepsi kimlik, faturalama, YZ, işler, e-posta, depolama ve gözlemlenebilirlik için paylaşılan TypeScript paketleri üzerine kuruludur.

Satın alma sonrası kit depolarına — web, mobil ve masaüstü — bir GitHub daveti alırsınız (Tüm Platformlar paketi tam monorepo'yu teslim eder). Yayınlayacağınız yüzeyi klonlayın ve kendinizin yapın.

Bu dokümanlar bir referans dökümü değil, adım adım bir yoldur: önce uygulamayı yerelde çalıştırın, sonra sağlayıcı kurulum sayfalarını sırayla izleyin. Her sayfa bir sonrakine işaret ederek biter.

Yerel bir sunucu başlatın

Node.js 22 veya daha yenisine ihtiyacınız var. Depo paket yöneticisini sabitler (packageManager: [email protected]), bu yüzden pnpm'i Corepack üzerinden çalıştırın — genel kurulum gerekmez.

1. Yerel yapılandırmanızı oluşturmak için ortam dosyasını kopyalayın.

2. Çalışma alanı bağımlılıklarını kurun.

3. İsteğe bağlı olarak gerçek kalıcılık için yerel Postgres konteynerini başlatın — varsayılanlar onsuz da çalışır.

4. Geliştirme sunucusunu başlatın ve http://localhost:3000 adresini açın.

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

.env dosyası

Ortam ayarları kit tarafından kullanılan yerel veya barındırılan hizmeti seçer. Geçişler için .env.example dosyasını kök .env dosyasına ve Web sunucusu için apps/web/.env.local dosyasına kopyalayın. Expo, apps/mobile/.env.local.'yi kullanır Yalnızca root .env'nin kopyalanması her uygulamayı yapılandırmaz.

Varsayılan sahte/yerel sağlayıcıların ücretli API kimlik bilgilerine ihtiyacı yoktur. Bellek içi / kontrol paneli gösterimini tamamlamanıza izin verirler; /auth'ta gerçek oturum açma işlemi hâlâ PostgreSQL ve geçiş işlemlerine ihtiyaç duyuyor. Gerçek bir sağlayıcı için, Web yapılandırma dosyasında yalnızca adlandırılmış ayarlarını değiştirin, kaydedin, ardından sunucuyu durdurun ve yeniden başlatın. Gizli bilgileri asla NEXT_PUBLIC_ veya EXPO_PUBLIC_ değerleri aracılığıyla ifşa etmeyin.

Yolunuzu seçin

Burada yeni misiniz? 5 dakikada yayınlayın, sizi yalnızca varsayılanlarla klonlamadan çalışan bir uygulamaya götürür.

Telefon ya da masaüstü için mi geliştiriyorsunuz? Mobil ve Masaüstü sekmeleri Expo ve Tauri yüzeylerini kapsar. Uygulama çalıştığında, Sağlayıcıları kurun grubu her entegrasyonu belge belge anlatır.

Kuruluma devam etmek için 5 dakikada yayınlayın kılavuzunu okuyun.