# Tecof Geliştirici Dokümantasyonu > Tecof üzerinde tema, uygulama ve entegrasyon geliştirmek için tek kaynak: CLI, @tecof paketleri, Tecof Studio (theme-editor), API referansları, MCP ve AI araçları. Tecof; Next.js temaları (Tecof Studio / @tecof/theme-editor ile görsel düzenleme), panelde çalışan partner uygulamaları (@tecof/app-sdk, @tecof/app-bridge, @tecof/app-ui), @tecof/cli ile Spaces tabanlı sürüm/yayın akışı, REST API’ler ve MCP sunucuları sunar. Kurallar: Belgede olmayan API, alan ya da uç uydurmayın. Her sayfanın ham Markdown’u `.md` ile alınır. Tüm içerik tek dosyada: https://tecof-app-dev.vercel.app/llms-full.txt. Doküman MCP sunucusu: https://tecof-app-dev.vercel.app/api/mcp (Streamable HTTP, salt okunur). Güncel paket sürümleri: @tecof/cli@0.2.0, @tecof/theme-editor@0.0.98, @tecof/analytics@0.0.3, @tecof/app-sdk@0.1.0, @tecof/app-bridge@0.1.0, @tecof/app-ui@0.1.0, @tecof/invoice-kit@0.2.0, @tecof/mcp@0.2.7. ## Başlangıç - [Genel Bakış](https://tecof-app-dev.vercel.app/getting-started.md): Tecof geliştirici platformuna genel bakış — tema, uygulama, CLI, API ve AI yüzeyleri, hangi yoldan başlanacağı, kimlik doğrulama katmanları ve ortam değişkenleri. ## Tema geliştirme - [Tema Geliştirme: Hızlı Başlangıç](https://tecof-app-dev.vercel.app/theme-quickstart.md): Özel temayı terminalden geliştirip canlıya alma: tecof login, theme init, dev (yerel/bulut), push, önizleme, promote, rollback ve base-moved çözümü. - [Tema Mimarisi ve Runtime](https://tecof-app-dev.vercel.app/storefronts.md): Tecof temalarının yapısı — Next.js runtime akışı, ortam değişkenleri, temel dosyalar, bileşen kaydı (registry), vitrin API’leri ve analytics entegrasyonu. - [Tecof Studio’ya Giriş (@tecof/theme-editor)](https://tecof-app-dev.vercel.app/theme-editor.md): @tecof/theme-editor ile Tecof Studio: kurulum, TecofProvider, editör ve yayın sayfası, doküman veri modeli ve paketin alt giriş noktaları. - [Studio Arayüzü](https://tecof-app-dev.vercel.app/editor-studio.md): Tecof Studio arayüzü — kanvas, paneller, Inspector sekmeleri, düzenleme/önizleme modları, otomatik kayıt, canlı katılım ve TecofEditor prop’larının tamamı. - [Bileşen Yapılandırması](https://tecof-app-dev.vercel.app/editor-components.md): StudioConfig ve ComponentConfig başvurusu, defineSection/defineElement, ve , kök className sözleşmesi, dinamik alanlar, sürükle-bırak kuralları, varyantlar ve varsayılan çocuklar. - [Alanlar](https://tecof-app-dev.vercel.app/editor-fields.md): Tecof Studio alan başvurusu — yerleşik tipler, çok dilli metin, zengin metin, medya, bağlantı, renk, kod, ikon, tekrar eden satırlar, harici/API kaynakları, CMS ve e-ticaret seçicileri; saklanan değer biçimleri. - [Slotlar ve Şablonlar](https://tecof-app-dev.vercel.app/editor-slots.md): Zone modeli, dikey ve yatay slotlar, repeat zone (öğe şablonu) ve veri kaynakları, slider deseni, bölüm ve sayfa şablonları, id güvenliği — canlı repeat zone önizlemesiyle. - [Stil Editörü](https://tecof-app-dev.vercel.app/editor-styles.md): Studio stil editörü — _tecofStyles token modeli, 54 kontrol, masaüstü-öncelikli kırılımlar, hover/focus/active, serbest değerler, renk kaynakları, TecofRender’ın ürettiği CSS, safelist ve sayfalar arası stil senkronu. - [Canlı Tema ve Karanlık Mod](https://tecof-app-dev.vercel.app/editor-theme.md): Canlı tema — ThemeConfig, tema birleştirme sırası, Studio Tema paneli ve hazır paletler, --theme-* CSS değişkenleri, fontlar, karanlık mod (config.darkMode) ve tema yardımcıları. - [Yayın Render’ı](https://tecof-app-dev.vercel.app/editor-render.md): TecofRender ile yayın — prop’lar, sayfaya bastığı stil/tema/font çıktısı, CMS şablon sayfaları ve token’lar, TecofPicture ve odak noktası, Powered by bandı, yapım aşaması sayfası ve etkileşim çalışma zamanı. - [API İstemcisi (TecofApiClient)](https://tecof-app-dev.vercel.app/editor-api-client.md): TecofApiClient başvurusu — kurucu, kimlik başlıkları, sayfa/medya/çeviri/CMS/ortak bileşen/e-ticaret metotları, kullandıkları /api/store ve /api/merchant uçları ve hata modeli. - [iframe ve postMessage](https://tecof-app-dev.vercel.app/editor-iframe.md): Tecof Studio’yu bir panel ya da uygulama içine iframe ile gömme — puck:* postMessage protokolü (kaydet, geri al, refetch, highlight, viewport), editörden gelen olaylar ve hostOrigin ile origin güvenliği. - [İzinler ve Migration](https://tecof-app-dev.vercel.app/editor-permissions.md): Düğüm izinleri (drag, delete, duplicate, edit) ve katman sırası, resolvePermissions, kilitli düğümler; MigrationConfig ile eski sayfa verisini yeni şemaya güvenle yükseltme. - [Klavye Kısayolları](https://tecof-app-dev.vercel.app/editor-shortcuts.md): Tecof Studio klavye kısayolları — komut paleti, kaydet, geri al/yinele, pano, çoğalt, sil, kılavuz/boyutlandırma/boşluk modları, seçim ve gezinme. - [Sorun Giderme](https://tecof-app-dev.vercel.app/editor-troubleshooting.md): Tecof Studio ve TecofRender için sık sorunlar ve çözümleri — seçilemeyen bileşen, yayında görünmeyen stil veya bileşen, boş repeat şablonu, API/CORS/yükleme hataları, iframe mesajları ve üretim kontrol listesi. ## Uygulama geliştirme - [Uygulama Geliştirme](https://tecof-app-dev.vercel.app/app-development.md): Partner uygulamalarına genel bakış: uygulama türleri, yetenekler, mimari, kimlik bilgileri ve geliştirmeden yayına yaşam döngüsü. - [Hızlı Başlangıç: Tecof CLI](https://tecof-app-dev.vercel.app/app-quickstart.md): Uygulamayı sıfırdan test mağazasında çalıştırıp yayınlama: tecof app init/dev/push/promote, proje yapısı ve tecof.app.json referansı. - [Tasarım Kimliği (@tecof/app-ui)](https://tecof-app-dev.vercel.app/app-ui.md): @tecof/app-ui ile Tecof panel görünümünde uygulama arayüzü: kurulum, globals.css katman sırası, TecofAppProvider, AppShell ve bileşenler, durum sözlüğü, ekran düzenleri, metin tonu ve yasaklar. - [Formlar ve Şema](https://tecof-app-dev.vercel.app/app-forms.md): Uygulama formları — @tecof/app-ui/schema ile istemci ve sunucuda tek şema, v kuralları, koşullu zorunluluk, AppForm ve hazır alanlar, SecretField ile Vault sırları, validateOnServer ve 422 hata sözleşmesi. - [App Bridge](https://tecof-app-dev.vercel.app/app-bridge.md): Panel ile gömülü uygulama arasındaki postMessage protokolü, bağlam nesnesi, @tecof/app-bridge ve React sağlayıcısı. - [Kimlik Doğrulama ve Kapsamlar](https://tecof-app-dev.vercel.app/app-auth.md): Kapsamlar, kurulum token’ı (tcfi_), 60 sn’lik oturum JWT’si, X-Tecof-Signature imzalı istekler ve istemci sırrı döndürme. - [Webhook'lar](https://tecof-app-dev.vercel.app/app-webhooks.md): Webhook aboneliği, olay kataloğu ve gereken kapsamlar, yaşam döngüsü olayları, teslimat biçimi, yeniden deneme ve idempotency. - [Aksiyonlar (Actions)](https://tecof-app-dev.vercel.app/app-actions.md): Panel yerleşimleri, iframe ve API aksiyonları, imzalı istek/yanıt biçimi ve aksiyonları yerelde test etme. - [Ayarlar, Vault ve Metafield'lar](https://tecof-app-dev.vercel.app/app-data.md): Kurulum ayarları, şifreli Vault sırları, yerel ayar formu ve kaynaklara bağlı metafield’lar. - [Uygulamalar Arası İletişim](https://tecof-app-dev.vercel.app/app-interop.md): Uygulamalar arası olaylar (pub/sub), paylaşılan metafield’lar ve keşif kataloğu. - [Ücretlendirme ve Hak Ediş](https://tecof-app-dev.vercel.app/app-billing.md): Uygulama planları, KDV, abonelik durumları, %80 geliştirici payı ve partner ödemesi. - [Yayınlama ve İnceleme](https://tecof-app-dev.vercel.app/app-publishing.md): İnceleme durumları, public/private dağıtım, kurulabilirlik kuralları, gönderim kontrol listesi, mağaza görselleri (ikon, kapak, ekran görüntüleri, store-assets/ ve listing.media), askıya alma ve izleme. - [Fatura Uygulamaları](https://tecof-app-dev.vercel.app/app-invoicing.md): Tecof’un fatura uygulamaları, kurumsal/bireysel alıcı, ortak invoice metafield’ı, para kuralları ve @tecof/invoice-kit. - [Örnek Uygulama: Logo İşbaşı](https://tecof-app-dev.vercel.app/app-example-isbasi.md): Uçtan uca örnek uygulama: Logo İşbaşı ile otomatik fatura — Vault, metafield, aksiyon ve olay yayını. ## CLI - [CLI Başvurusu](https://tecof-app-dev.vercel.app/cli-reference.md): Tüm tecof komutları ve seçenekleri (@tecof/cli 0.2.0), ortam değişkenleri, çıkış kodları, JSON makbuzları ve next.action, yok sayma kuralları ve sınırlar. - [Geliştirici Alanları (Spaces)](https://tecof-app-dev.vercel.app/spaces.md): Tema ve uygulama Spaces’leri: numaralı değişmez sürümler, staged ve production hedefleri, anında canlıya alma/geri alma, kimlerin kullanabildiği ve paket gereksinimi. - [Sürümler, Canlıya Alma ve Geri Alma](https://tecof-app-dev.vercel.app/versions-and-rollback.md): Sürüm durumları, aktivasyon sonuçları, korumalı önizleme bağlantıları, canlıya alma ve geri alma kuralları, panel Sürümler ekranı ve derleme günlükleri. - [Güvenlik ve CI](https://tecof-app-dev.vercel.app/dev-security.md): CLI kimlik bilgisi deposu, token ömürleri, kapsamlı CI token’ları, GitHub Actions örneği, ajan modu, gizli anahtar taraması ve korunan yollar. ## API’ler - [Public API Referansı](https://tecof-app-dev.vercel.app/public-apis.md): Vitrin /api/store sözleşmesi: auth başlıkları, render, CMS, e-ticaret, müşteri hesabı, analytics ve ödeme sağlayıcı geri dönüşleri. - [Headless CMS Mimarisi ve API Rehberi](https://tecof-app-dev.vercel.app/headless-cms.md): CMS koleksiyon ve öğe modeli, panel (JWT) yönetim uçları, vitrin canlı içerik okuma, yayın kuralları ve referans alanları. - [API ile Veri Erişimi](https://tecof-app-dev.vercel.app/app-api.md): /api/v1 yanıt zarfı, sayfalama ve hız sınırları; sipariş, müşteri, envanter, ürün şekilleri; Tools API ile yazma ve uygulamaya özel uçlar. ## Paketler - [Paketler ve Güncel Sürümler](https://tecof-app-dev.vercel.app/packages.md): Tüm @tecof npm paketleri: güncel sürüm, kurulum komutu, giriş noktaları, peer bağımlılıklar ve sürüm geçmişi. Sürümler npm kayıt defterinden saatlik olarak yenilenir. ## AI ve MCP - [Model Context Protocol (MCP)](https://tecof-app-dev.vercel.app/mcp.md): Tecof uzak MCP sunucusu (api.tecof.com/mcp): kimlik, kapsamlar, onay ve kredi semantiği, istemci kurulumu ve @tecof/mcp stdio paketi. - [Dokümanı AI ile Kullanın](https://tecof-app-dev.vercel.app/ai-docs.md): Bu dokümantasyonu AI asistanlarına bağlama — llms.txt ve llms-full.txt, her sayfanın .md ikizi, sayfa eylemleri (Markdown/README kopyala, ChatGPT/Claude’da aç) ve salt-okunur doküman MCP sunucusu (HTTP ve stdio). - [Yapay Zeka Destekli Alışveriş Ajanları](https://tecof-app-dev.vercel.app/agents.md): AI alışveriş ajanlarını vitrin API’lerine güvenli bir sunucu araç katmanıyla bağlama: önerilen araçlar, şemalar, güvenlik kuralları ve analytics olayları. ## SEO ve GEO - [Tema SEO’su](https://tecof-app-dev.vercel.app/seo-geo.md): Tecof temalarında SEO — platformun hazır verdiği sitemap, robots.txt, alan adı ve sayfa düzeyi noindex, meta/OG alanları, çok dilli adresler ve 301’ler, özel kod, ürün beslemeleri; tema tarafında hreflang ve JSON-LD ekleme. - [GEO: AI Storefront](https://tecof-app-dev.vercel.app/ai-storefront.md): Üretken yapay zekâ görünürlüğü (GEO) için AI Storefront — mağaza kökündeki agents.md, llms.txt, llms-full.txt ve /ai/*.json dosyaları, site türleri (kurumsal, e-ticaret, hibrit), bilgi merkezi, tema proxy’si, WebMCP ve UTM takibi. ## Optional - [Tüm dokümantasyon tek dosyada](https://tecof-app-dev.vercel.app/llms-full.txt): Bütün sayfaların birleştirilmiş Markdown’u. - [Site haritası](https://tecof-app-dev.vercel.app/sitemap.xml): Tüm sayfa adresleri ve son güncelleme tarihleri.