> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Teknoloji yığını

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

## 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.

[Araçları yükleyin ve kodu alın](https://supastack.dev/tr/docs/web/before-you-start.md)

[Komutları, dosyaları ve yapılandırmayı öğrenin](https://supastack.dev/tr/docs/web/terminal-basics.md)

[Web'de ilk çalıştırma eğitimini tamamlayın](https://supastack.dev/tr/docs/web/ship-in-5-minutes.md)

```
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](https://react.dev) 19 sunucu bileşenleriyle [Next.js](https://nextjs.org) 16 üzerinde çalışır.

- [Next.js](https://nextjs.org)
- [React](https://react.dev)


## TypeScript + Turborepo

[TypeScript](https://www.typescriptlang.org) strict modu tüm pnpm çalışma alanında geçerlidir ve [Turborepo](https://turborepo.com) derlemeleri koordine eder.

- [TypeScript](https://www.typescriptlang.org)
- [Turborepo](https://turborepo.com)


## Better Auth

[Better Auth](https://better-auth.com) kimlik motorudur; üzerinde standartlaşan ekipler için bir Auth.js motoru da mevcuttur.

- [Better Auth](https://better-auth.com)


## Drizzle + PostgreSQL

Kalıcılık, [PostgreSQL](https://www.postgresql.org) üzerinde [Drizzle](https://orm.drizzle.team) ORM ile sağlanır — her kaydın aktığı şema ve yardımcılar.

- [Drizzle](https://orm.drizzle.team)
- [PostgreSQL](https://www.postgresql.org)


## Faturalandırma

[Stripe](https://stripe.com) faturalandırması varsayılandır ve bir [Lemon Squeezy](https://www.lemonsqueezy.com) bağdaştırıcısı dahildir.

- [Stripe](https://stripe.com)
- [Lemon Squeezy](https://www.lemonsqueezy.com)


## Trigger.dev

Arka plan işleri [Trigger.dev](https://trigger.dev) üzerinde çalışır.

- [Trigger.dev](https://trigger.dev)


## İşlemsel e-posta

İşlemsel e-postalar [Resend](https://resend.com) veya AWS SES üzerinden gönderilir.

- [Resend](https://resend.com)


## Sentry + PostHog

Gözlemlenebilirlik [Sentry](https://sentry.io) ve [PostHog](https://posthog.com) üzerinden sağlanır.

- [Sentry](https://sentry.io)
- [PostHog](https://posthog.com)


## Expo

[Expo](https://expo.dev) 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.

- [Expo](https://expo.dev)


## 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
```


## Sonraki

[Yerel kurulum](https://supastack.dev/tr/docs/web/local-setup.md)
