# trkit

> Tek komutla Türkçe Next.js projesi: KVKK, çerez onayı, il/ilçe, TCKN/IBAN doğrulama, iyzico/PayTR, Netgsm ve AI asistanları için hazır kurallar.

trkit, Türk projeleri için Next.js altyapı kitidir. Yeni proje: `npx create-trkit-app@latest`. Mevcut projeye: `npx trkit init` ve `npx trkit add <öğe>`.
Kurallar: para kuruş cinsinden tamsayı; tarihler Europe/Istanbul; yasal metinler trkit.config.ts'den üretilir, elle yazılmaz; ödeme sonucu yalnızca callback'te verifyCallback() ile belirlenir.
Tüm içerik tek dosyada: https://zersjs.github.io/trkit/llms-full.txt · MCP sunucusu: `npx -y @trkit-app-pack/mcp` (stdio)

## Başlarken

- [trkit nedir?](https://zersjs.github.io/trkit/docs/index.md): Türk geliştiriciler için hazır Next.js altyapısı. Her projede yeniden yazdığınız yerel ihtiyaçları tek komutla kurar.
- [Kurulum](https://zersjs.github.io/trkit/docs/kurulum.md): create-trkit-app ile tek komutla Türkçe Next.js projesi oluşturun.
- [Proje yapısı](https://zersjs.github.io/trkit/docs/proje-yapisi.md): create-trkit-app ile oluşturulan projedeki dosyalar ve ne işe yaradıkları.
- [trkit CLI](https://zersjs.github.io/trkit/docs/cli.md): Bileşen ve sayfa ekleme, yasal metinleri kontrol etme ve dışa aktarma komutları.
- [Mevcut projeye ekleme](https://zersjs.github.io/trkit/docs/mevcut-projeye-ekleme.md): Var olan bir Next.js projesine trkit'i adım adım ekleyin.

## AI ile geliştirme

- [AI ile geliştirme](https://zersjs.github.io/trkit/docs/ai.md): trkit projeleri Claude Code, Cursor, Codex, ChatGPT ve diğer AI asistanlarıyla çalışmaya hazır gelir.
- [Claude Code](https://zersjs.github.io/trkit/docs/ai/claude-code.md): trkit projelerinde Claude Code kullanımı; CLAUDE.md, MCP sunucusu ve örnek iş akışları.
- [Cursor](https://zersjs.github.io/trkit/docs/ai/cursor.md): trkit projelerinde Cursor kuralları, MCP ayarı ve dokümantasyon indeksleme.
- [ChatGPT](https://zersjs.github.io/trkit/docs/ai/chatgpt.md): ChatGPT'yi trkit uzak MCP sunucusuna bağlayın veya dokümantasyonu Proje dosyası olarak ekleyin.
- [Codex](https://zersjs.github.io/trkit/docs/ai/codex.md): OpenAI Codex (CLI, IDE eklentisi ve bulut) ile trkit projeleri.
- [VS Code, Windsurf ve diğerleri](https://zersjs.github.io/trkit/docs/ai/diger.md): GitHub Copilot, Windsurf, Gemini CLI, Zed ve claude.ai için trkit ayarları.
- [MCP araçları](https://zersjs.github.io/trkit/docs/ai/mcp.md): @trkit-app-pack/mcp sunucusunun araçları, girdileri ve kendi sunucunuzda barındırma.

## Rehberler

- [KVKK uyumu](https://zersjs.github.io/trkit/docs/rehber/kvkk.md): Bir web sitesinde 6698 sayılı Kanun'a uyum için trkit ile yapılacaklar.
- [Çerez onayı](https://zersjs.github.io/trkit/docs/rehber/cerez.md): KVKK Çerez Uygulamaları Rehberi'ne uygun çerez banner'ı, script yükleme ve onay kaydı.
- [Türkçe formlar](https://zersjs.github.io/trkit/docs/rehber/form.md): Türkçe hata mesajları, TCKN/IBAN/telefon doğrulama ve il/ilçe seçimiyle form yazma.
- [Ödeme akışı](https://zersjs.github.io/trkit/docs/rehber/odeme.md): iyzico veya PayTR ile güvenli ödeme; sepet, onaylar, callback ve iade.
- [SMS ve OTP](https://zersjs.github.io/trkit/docs/rehber/sms-otp.md): Netgsm ile bilgilendirme/ticari SMS ve güvenli telefon doğrulama.
- [Yayına alma kontrol listesi](https://zersjs.github.io/trkit/docs/rehber/yayina-alma.md): trkit projesini canlıya almadan önce kontrol edilecekler.

## Paketler

- [@trkit-app-pack/validate](https://zersjs.github.io/trkit/docs/paketler/validate.md): TCKN, VKN, IBAN, telefon, plaka, posta kodu ve MERSİS doğrulama; hazır zod şemaları ve Türkçe hata mesajları.
- [@trkit-app-pack/format](https://zersjs.github.io/trkit/docs/paketler/format.md): TL, İstanbul saatiyle tarih, göreli zaman, tutarı yazıya çevirme, ünlü uyumlu hâl ekleri ve Türkçe harf dönüşümü.
- [@trkit-app-pack/address](https://zersjs.github.io/trkit/docs/paketler/address.md): 81 il, 973 ilçe, bölge ve alan kodu verisi; Türkçe karakter duyarsız arama.
- [@trkit-app-pack/legal](https://zersjs.github.io/trkit/docs/paketler/legal.md): KVKK ve e-ticaret yasal metin şablonları, çerez onayı ve onay kayıtları.
- [@trkit-app-pack/pay](https://zersjs.github.io/trkit/docs/paketler/pay.md): iyzico, PayTR ve mock ödeme sağlayıcıları için ortak arayüz.
- [@trkit-app-pack/sms](https://zersjs.github.io/trkit/docs/paketler/sms.md): Netgsm ve geliştirme sağlayıcısı, İYS filtresi, güvenli OTP.

## Bileşenler

- [İl / ilçe seçici](https://zersjs.github.io/trkit/docs/bilesenler/il-ilce-secici.md): Erişilebilir bağımlı il/ilçe seçimi ve Türkçe duyarsız arama bileşenleri.
- [Çerez banner'ı](https://zersjs.github.io/trkit/docs/bilesenler/cerez-banner.md): KVKK Çerez Rehberi'ne uygun onay banner'ı, tercih paneli ve script kapısı.
- [Yasal sayfalar](https://zersjs.github.io/trkit/docs/bilesenler/yasal-sayfalar.md): trkit.config.ts'den üretilen KVKK ve e-ticaret sayfaları.
- [Ödeme onayları](https://zersjs.github.io/trkit/docs/bilesenler/odeme-onaylari.md): Ön bilgilendirme ve mesafeli satış onayı, isteğe bağlı ticari ileti onayı.