Tezgah

Claude Code ile production-ready SaaS kur.

Tezgah, Claude Code için yazılmış bir skill setidir. Sıfırdan çalışan bir SaaS uygulaması kurmanın tüm adımlarını — veritabanı, kimlik doğrulama, ödeme, e-posta, landing page, yasal uyumluluk, API güvenliği, test, analytics ve deployment — kapsar.

Türkiye'deki solopreneur'ler için tasarlandı. Stripe Türkiye kısıtlamaları, Lemon Squeezy MoR avantajı, KVKK uyumluluğu gibi konular özellikle ele alınmıştır.

English: Tezgah is a Claude Code skill kit for building production-ready SaaS apps. Currently in Turkish — contributions for i18n are welcome.

---

Hızlı Başlangıç

npx tezgah init

Bu komut skills/ klasörüne 12 skill dosyası kurar. Sonrasında Claude Code'da:

/saas-launcher

komutuyla orkestratörü başlat. Sana sorular soracak, tech stack kararlarını verecek ve her katmanı adım adım kuracak.

CLI Komutları

npx tezgah init                        # Tüm skill'leri kur
npx tezgah add saas-auth               # Tek bir skill ekle
npx tezgah remove saas-storage         # Bir skill'i kaldır
npx tezgah update                      # Kurulu skill'leri güncelle
npx tezgah doctor                      # Kurulumu kontrol et
npx tezgah list                        # Mevcut skill'leri listele

# Seçenekler
npx tezgah init --dir .claude/skills   # Farklı klasöre kur
npx tezgah init --force                # Mevcut dosyaların üstüne yaz
npx tezgah list --no-color             # Renksiz çıktı

Skill'ler

Orkestratör

Skill	Açıklama
saas-launcher	Tüm süreci yöneten ana skill. Keşif görüşmesi yapar, tech stack kararlarını verir, her katmanı sırayla ilgili uzman skill'e devreder.

Uzman Skill'ler

Her biri bağımsız olarak da kullanılabilir:

Skill	Faz	Kapsam
saas-database	2	Supabase kurulumu, şema tasarımı, RLS, migration, connection pooling
saas-auth	3	Google OAuth, Magic Link, e-posta/şifre, JWT oturum, middleware
saas-payments	4	Stripe / Lemon Squeezy, checkout, webhook, abonelik yönetimi
saas-email	5	Resend / Mailgun, DNS (SPF, DKIM, DMARC), e-posta şablonları
saas-storage	6.5	Supabase Storage, dosya yükleme, RLS güvenliği, görsel optimizasyonu
saas-landing-seo	6	Landing page bileşenleri, SEO, sitemap, Open Graph, blog
saas-legal	7	KVKK/GDPR, gizlilik politikası, kullanım koşulları, çerez onayı
saas-api-security	8	Rate limiting, plan bazlı erişim, input validation, CORS
saas-testing	9	Vitest, Playwright E2E, webhook testi, CI entegrasyonu
saas-analytics	10	PostHog, event tracking, feature flags, session replay
saas-deployment	11	Vercel / Railway / Fly.io, domain, SSL, CI/CD, izleme

Faz Akışı

Faz 0   Keşif Görüşmesi         ─── saas-launcher
Faz 1   Tech Stack Kararları     ─── saas-launcher
Faz 2   Altyapı + Veritabanı    ─── saas-database
Faz 3   Kimlik Doğrulama         ─── saas-auth
Faz 4   Ödeme Sistemi            ─── saas-payments
Faz 5   E-posta Altyapısı        ─── saas-email
Faz 6   Landing Page & SEO       ─── saas-landing-seo
Faz 6.5 Dosya Depolama           ─── saas-storage (opsiyonel)
Faz 7   Yasal Uyumluluk          ─── saas-legal
Faz 8   API Güvenliği            ─── saas-api-security
Faz 9   Test                     ─── saas-testing
Faz 10  Analytics                ─── saas-analytics
Faz 11  Deployment               ─── saas-deployment

Varsayılan Tech Stack

Katman	Teknoloji	Gerekçe
Framework	Next.js (App Router) + TypeScript	Server/client rendering, dahili API route'ları
UI	Tailwind CSS + shadcn/ui	Hızlı geliştirme, tutarlı tasarım
Veritabanı	Supabase (PostgreSQL)	Auth + DB + Storage + Realtime tek çatıda
Auth	Google OAuth + Magic Link	Şifresiz, düşük sürtünmeli giriş
Ödeme	Stripe veya Lemon Squeezy	Bölgeye ve ihtiyaca göre seçim
E-posta	Resend + React Email	Modern API, tip güvenli şablonlar
Analytics	PostHog	Ürün analizi, feature flags, session replay
Hosting	Vercel	Sıfır konfigürasyon, otomatik deploy

Her teknoloji keşif görüşmesinde kullanıcının ihtiyaçlarına göre değiştirilebilir.

Tezgah vs. Alternatifler

	Tezgah	create-t3-app	Shipfast / Supastarter
Ne	Claude Code skill seti (rehber)	Boilerplate kod üretici	Hazır SaaS şablonu
Nasıl	Claude Code ile adım adım inşa	Proje iskeleti oluşturur	Hazır kodu klonla
Dil	Türkçe	İngilizce	İngilizce
Fiyat	Ücretsiz (MIT)	Ücretsiz	$200-400
Esneklik	Her karar tartışılır, değiştirilebilir	Sabit tech stack	Sabit mimari
Kapsam	DB → Auth → Ödeme → SEO → Yasal → Test → Deploy	Sadece proje iskeleti	Kod + bazı entegrasyonlar
Türkiye bağlamı	KVKK, Stripe/LS karşılaştırması, yerel ipuçları	Yok	Yok

Gereksinimler

• Claude Code kurulu olmalı
• Node.js 18+

Nasıl Çalışır

1. npx tezgah init ile skill dosyalarını projenize kopyalarsınız
2. Claude Code'da /saas-launcher ile orkestratörü başlatırsınız
3. Orkestratör size ürününüz hakkında sorular sorar (Faz 0)
4. Tech stack kararlarını birlikte verirsiniz (Faz 1)
5. Her katman ilgili uzman skill tarafından adım adım inşa edilir (Faz 2-11)

Tek bir skill'i bağımsız kullanmak da mümkündür:

/saas-auth          # Sadece auth sistemi kur
/saas-payments      # Sadece ödeme entegrasyonu ekle
/saas-database      # Sadece Supabase altyapısını kur
/saas-legal         # Sadece yasal sayfaları hazırla

Katkıda Bulunma

Katkılarınızı bekliyoruz! CONTRIBUTING.md dosyasını okuyun.

Kısa özet:

• Yeni skill ekleyebilirsiniz
• Mevcut skill'leri iyileştirebilirsiniz
• Hata bildirimi veya özellik talebi açabilirsiniz
• Türkçe dışında dil desteği ekleyebilirsiniz

Güvenlik

Güvenlik açığı bildirimi için SECURITY.md dosyasını okuyun.

Lisans

MIT — Fatih Guner