Skip to content

komunite/tezgah

Tezgah

npm version CI License: MIT

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

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