Spaces, özel temaları ve partner uygulamalarını terminalden geliştirip yayınlamanın yoludur. Kodu yerelde (ya da bulutta) geliştirirsiniz; tecof theme push yalnız değişen dosyaları yükler ve her yükleme numaralı, değişmez bir sürüm olur. Sürümü önizler, hazır olunca yeniden derlemeden saniyeler içinde canlıya alırsınız. Bir sorun çıkarsa önceki canlı sürüme yine saniyeler içinde dönersiniz.

Kavramlar#

Kavram	Anlamı
Space (alan)	Yayınlanabilir birim: bir mağazanın tema kurulumu ya da bir partner uygulaması. Her alan Tecof'ta bir GitHub deposu ve bir Vercel projesiyle eşleşir
Alan kimliği	Tema: `thm_<kurulum kimliği>` (paneldeki `/app/themes/<kimlik>/versions` adresinde görünen kimlik). Uygulama: `app_<uygulama kimliği>` (`tecof.app.json` içindeki `id`)
Sürüm (`vN`)	Alan deposundaki bir commit ve onun üretim derlemesi. Numara alan başına artar ve bir kez verilir; aynı numara başka içeriğe gitmez
Canlı (live)	Mağazanın ya da uygulamanın alan adlarının o anda gösterdiği sürüm
Hedef: staged	Varsayılan push hedefi. Canlı sitenin ortam değişkenleriyle tam bir üretim derlemesi yapılır ama alan adı atanmaz; canlı site değişmez. `promote` ile yeniden derlemeden canlıya çıkar
Hedef: production	`--prod` ile push. Commit doğrudan `main` dalına gider, derleme bitince canlıya çıkar
Taban (base)	Push'unuzun üstüne kurulduğu `main` commit'i. Staged bir sürüm yalnız `main` bu tabandan ileri gitmediyse canlıya alınır
Kaynak (source)	Sürümü neyin ürettiği: `cli` (CLI push'u ya da `tecof app deploy`), `ide` (Cloud IDE kaydı), `ai` (AI tema işi), `git` (`main` dalına giden diğer commit'ler)

Nasıl Çalışır#

Metin

yerel klasör ──push──▶ v12 (staged, alan adı yok) ──open──▶ korumalı önizleme bağlantısı
                         │
                         └──promote──▶ v12 canlıda (yeniden derleme yok; main → v12 commit'i)
                                          │
                                          └──rollback──▶ önceki canlı sürüm (anında)

Push: CLI projeyi tarar, her dosyanın git blob SHA-1 özetini çıkarır ve yalnız depoda olmayan içerikleri yükler. Yerelde sildiğiniz dosyalar depodan da silinir.
Sürüm: Tecof değişiklikleri tabanın üstüne commit'ler, commit'i tecof/v12 etiketiyle işaretler ve üretim derlemesini başlatır. Bu derleme alan adı almaz.
Önizleme: Derleme hazır olunca tecof theme open v12 sürümü korumalı bir bağlantıda açar.
Canlıya alma: tecof theme promote v12 alan adlarını bu derlemeye çevirir; yeniden derleme yapılmaz. Aynı anda main dalı v12'nin commit'ine ileri alınır.
Geri alma: tecof theme rollback alan adlarını bir önceki canlı sürüme döndürür.

Kurallar ve ayrıntılar: Sürümler, Canlıya Alma ve Geri Alma.

main Dalı Kaynak Gerçeği Olarak Kalır#

Her alanın deposunda main dalı, sitenin kodunun tek doğru kaynağıdır:

Cloud IDE kayıtları, AI tema işleri ve MCP ile yapılan commit'ler eskisi gibi main dalına gider ve derleme bitince canlıya çıkar; tecof theme push --prod de aynı yolu izler. Bu yayınlar da sürüm listesinde kendi kaynaklarıyla (ide, ai, git, cli) görünür.
Staged sürüm main dalına yazılmaz; commit yalnız tecof/vN etiketinde durur. Sürüm canlıya alınınca main o commit'e hızlı ileri (fast-forward) alınır. Böylece canlı site ile main aynı kodu gösterir ve herkes aynı geçmişi görür.
Canlıya alma yalnız hızlı ileri mümkünse yapılır. Siz push ettikten sonra başka biri (Cloud IDE, AI, başka bir geliştirici ya da CI) main dalını değiştirdiyse işlem başlamaz ve 409 base-moved döner; güncel main dalını çekip (tecof theme pull) yeniden push edersiniz. Böylece başkasının değişikliği, eski tabana kurulmuş bir sürümle fark edilmeden geri alınmaz.

Önceki Akışla Karşılaştırma#

	Spaces öncesi	Spaces ile
Tema kodu	Cloud IDE, AI ya da MCP ile; her kayıt `main` dalına gidip canlıya çıkar. CLI'da tema komutu yoktu	Yerelde ya da bulutta geliştirme, `tecof theme push`
Yükleme	Uygulamada `tecof app deploy` her seferinde tüm kaynağı arşivleyip yükler	Yalnız değişen dosyalar yüklenir; silmeler de aktarılır
Canlıya çıkmadan deneme	Cloud IDE oturum önizlemesi; üretim derlemesi canlıya çıkmadan denenemez	Staged sürüm: üretim derlemesi, alan adı yok, korumalı önizleme
Canlıya alma	Derleme bitince kendiliğinden	Staged sürüm tek komutla, yeniden derlemeden
Geri alma	Düzeltme commit'i ve yeni derleme	Önceki canlı sürüme saniyeler içinde
Sürüm geçmişi	Yok	Her derleme numaralı bir sürüm; panelde Sürümler ekranı
Otomasyon	—	`--json` makbuzları, ajan modu, kapsamlı CI token'ları

Önceki yollar çalışmaya devam eder: Cloud IDE ve AI yine main dalına yayınlar, tecof app deploy hâlâ çalışır.

Kimler Kullanabilir#

Temalar#

Bir mağazanın ekibindeki her kullanıcı o mağazanın tema alanlarını görür. Mağaza ekibine eklenmiş ajans ve partner kullanıcıları da buna dahildir; partner hesabı gerekmez.
Yalnız özel temalar yazılabilir: kendi deposu ve Vercel projesi olan, bu mağazaya ait temalar. Özel tema panelde yapay zekâyla üretilir, boş iskeletten açılır ya da bir katalog temasından kopyalanır.
Erişim her istekte yeniden doğrulanır: ekipten çıkarılan kullanıcının CLI'ı o mağazanın alanlarına hemen erişemez.

Uygulamalar#

Aktif bir partner üyeliği gerekir. Partner hesabınızın, Tecof barındırmasını kullanan (hosting: "tecof") platform uygulamaları alan olarak listelenir.
Kendi sunucunuzda barındırılan (hosting: "external") uygulamalar alan değildir; dağıtımları sizdedir.
Partner üyeliğiniz biterse CLI oturumunuz tema alanlarında çalışmaya devam eder, uygulama uçları 403 developer-not-partner döner.

Salt Okunur Alanlar#

tecof spaces ls her alanın yazılabilir olup olmadığını gösterir. Salt okunur alanda sürüm listesi, günlükler ve önizleme okunabilir; push, canlıya alma, geri alma, yerel geliştirme değişkenleri ve bulut geliştirme 403 space-read-only ile reddedilir.

`readOnlyReason`	Anlamı	Ne yapılır
`catalog-theme`	Katalog (paylaşımlı) teması; aynı kod yüzlerce mağazada çalışır. Kaynak kodu da indirilemez (`403 space-source-forbidden`)	Temayı özel temaya kopyalayın (aşağıda)
`shared-theme`	Özel tema başka bir mağazaya ait	Temanın ait olduğu mağazanın alanını kullanın
`no-repo`	Temanın deposu henüz yok	Tema kurulumu tamamlanınca alan yazılabilir olur
`no-project`	Temanın Vercel projesi henüz yok	Tema kurulumu tamamlanınca alan yazılabilir olur
`external-hosting`	Uygulama kendi sunucunuzda barındırılıyor	Kendi dağıtımınızı kullanın ya da Tecof barındırmasına geçin

Katalog temasını özel temaya kopyalama: Panelde temanın Sürümler ekranındaki Özel temaya kopyala düğmesi Tecof asistanını bu istekle açar; asistan işlemden önce onayınızı ister ve kullanılacak krediyi gösterir. Kopya hazır olunca etkinleşir, o zamana kadar mevcut temanız yayında kalır. Uzak MCP sunucusunda aynı işi fork_theme_to_custom aracı yapar (MCP). Kopyanın kendi deposu, Vercel projesi ve sürüm geçmişi olur.

Paket Gereksinimi#

Tema alanına yazan işlemler — push, canlıya alma, geri alma ve bulut geliştirme — mağaza paketinde Özel Temalar ve Kod Erişimi özelliklerinin ve geliştirme modunun (Cloud IDE) açık olmasını ister. Bu, Cloud IDE'nin istediği koşulla aynıdır: hiçbir paket CLI'dan Cloud IDE'nin vermediği bir kod yetkisi almaz.

Okuma işlemleri pakete bağlı değildir: alan ve sürüm listesi, günlükler, önizleme bağlantısı, kaynak indirme (tecof theme pull) ve yerel geliştirme (tecof theme dev).

Hata	Anlamı
`403 plan-feature-unavailable`	Pakette gereken özellik yok; `data.feature` eksik özelliği, `data.currentPlan` mevcut paketi verir
`403 plan-module-locked`	Geliştirme modu pakete dahil değil; `data.requiredPlan` gereken paketi verir

Uygulama alanları mağaza paketine bağlı değildir.

Tek Hesap, Kullanıcıya Bağlı Oturum#

tecof login ile açılan oturum kişisel hesabınıza bağlıdır, bir partner hesabına değil. Aynı oturumla üyesi olduğunuz mağazaların özel temalarında ve partner hesabınızın uygulamalarında çalışırsınız. Cihaz oturumu 30 gün geçerlidir ve 14 gün kullanılmazsa düşer.

CI için hesabınızın tüm erişimini taşıyan cihaz oturumu yerine yalnız gereken alana ve yetkiye sınırlı bir kapsamlı token kullanın: Güvenlik ve CI.

Bu Bölümün Sayfaları#

Sayfa	İçerik
Tema Geliştirme: Hızlı Başlangıç	Kurulum, giriş, kodu indirme, yerel ve bulut geliştirme, push, önizleme, canlıya alma, geri alma
Sürümler, Canlıya Alma ve Geri Alma	Sürüm durumları, staged ve production, önizleme bağlantıları, canlıya alma ve geri alma kuralları, panel ekranı
Güvenlik ve CI	Kimlik bilgisi saklama, token ömürleri, CI token'ları, GitHub Actions, gizli anahtar taraması, ajan modu
CLI Başvurusu	Tüm komutlar ve seçenekler, ortam değişkenleri, çıkış kodları, JSON makbuzları, yok sayma kuralları, sınırlar
Hızlı Başlangıç: Tecof CLI	Uygulamalar için `tecof app` akışı ve `tecof app push` ile sürümler