Başlarken

Bu sayfa tema geliştirmenin zihinsel modelini anlatır. Komutlara geçmeden önce okumanız, ilerideki "neden böyle" sorularının çoğunu ortadan kaldırır.

Tema nedir?

Winkwop'ta tema bir site değil, bir bölüm kütüphanesidir.

Siz Header, Hero, ProductGrid gibi React bileşenleri yazarsınız. Bunların hangi sayfada, hangi sırada ve hangi ayarlarla görüneceğine mağaza sahibi tema editöründen karar verir. Aynı tema, iki mağazada tamamen farklı görünebilir.

Bunun pratik sonucu: bileşeniniz nerede çizileceğini bilmemeli. Bir bölüm "ben ana sayfanın en üstündeyim" varsayımıyla yazılırsa, mağaza sahibi onu kategori sayfasına koyduğunda bozulur.

Üç parça

Parça	Nerede	Ne yapar
Manifest	Partner paneli → geliştirme ekranı	Bölümlerinizi ve her bölümün ayarlarını tanımlar
Kaynak kod	Yerel proje (src/sections/)	Bileşenlerin kendisi
Sürüm	Platform	Manifest + derlenmiş kod; mağazalar bir sürüme sabitlenir

Manifest ile kod arasındaki bağ pull komutuyla kurulur: geliştirme ekranında tanımladığınız prop'lar projenize TypeScript tipleri olarak iner. Bileşeniniz HeaderProps tipini kullandığı için, panelde olmayan bir ayarı okumaya çalışırsanız derleme hatası alırsınız.

Akış

Partner paneli              Yerel proje                 Platform
─────────────────           ────────────                ──────────
bölüm/prop tanımla   ──►    pull                        
                            bileşeni yaz
                            npm run dev (önizleme)
                            deploy              ──►     derle → ready
                                                        │
mağaza temayı kurar ◄───────────────────────────────────┘
mağaza bölümleri yerleştirir ve yayınlar

Yerel geliştirme neye bağlanır?

npm run dev temanızı gerçek bir mağazanın verisiyle çalıştırır: ürünler, kategoriler, sepet hepsi canlı API'den gelir. Hangi mağaza olduğunu link komutu belirler.

Burada dikkat edilecek nokta şu: bağlandığınız mağaza gerçek bir müşteri mağazasıysa, sepet ve sipariş denemeleriniz o mağazanın gerçek verisine yazar. Bu yüzden kendi geliştirme mağazanızı kurmanız önerilir — demo katalogla gelir, kimsenin onayını beklemez ve tahsilat yapmaz.

Sırada ne var

1. Kurulum — CLI, giriş, proje oluşturma
2. İlk temanız — ilk bölümü uçtan uca yazma
3. Bölümler — bölüm anatomisi ve kuralları