create-leaderos-theme, LeaderOS sitenize bağlı çalışan bir Next.js (App Router, TypeScript) projesi oluşturan komut satırı aracıdır.
Şablonda ne var?
- Ana sitenin flat temasının birebir klonu (aynı Tabler/Bootstrap CSS, aynı sayfalar, aynı URL yapısı).
- Giriş/kayıt, 2FA, e-posta doğrulama, hesap, mağaza, sepet, ödeme sonuçları, kredi, sandık, hediye kodları, forum, öneriler, destek, yardım merkezi, başvurular, formlar, blog, indirmeler, üyeler, skor tabloları, cezalar, değişiklik günlüğü, oy verme, Gaming Night, Şans Çarkı, Pazar, özel sayfalar, sitemap/robots, 403/404/bakım ekranları.
- API proxy rotası (
app/headless/v1/[...path]), sunucu istemcisi (lib/leaderos.ts), sayfa korumaları (lib/guards.ts). - Yapay zeka dosyaları:
AGENTS.md,CLAUDE.md,.mcp.json.
Gereksinimler
- Node.js 18.18 veya üzeri (güncel LTS önerilir) ve npm
- Headless API’si açık bir LeaderOS sitesi ve public key (Hızlı başlangıç)
Kurulum
- Etkileşimli
- Etkileşimsiz
- Project folder: proje klasörü
- Your LeaderOS website URL:
https://siteniz.com - Public key:
pk_live_...
- Girdiğiniz adrese
GET /headless/v1/site/configisteği atıp bağlantıyı test eder (✔ Connected to ... (LeaderOS 6.x)). Başarısız olursa uyarı verir ama devam eder. - Şablonu klasöre kopyalar (klasör boş olmalıdır).
.env.localdosyasını oluşturur:
İlk çalıştırma
http://localhost:3000 adresini açın.
1
Frontend URL'yi ayarlayın
Ayarlar → Headless API → Frontend URL ve Sayfalar bölümüne
http://localhost:3000 yazın. Aksi halde e-posta bağlantıları ve ödeme dönüşleri LeaderOS sitesine gider.2
Origin ekleyin (isteğe bağlı)
Şablon proxy kullandığı için gerekmez; ancak tarayıcıdan doğrudan API’ye istek atıyorsanız
http://localhost:3000 adresini izin verilen origin’lere ekleyin.3
Siteyi gezin
Giriş yapın, mağazayı ve sepeti deneyin. Modülü kapalı olan sayfalar otomatik 404 verir.
Proje yapısı
Komutlar
Önemli desenler
- Sayfa korumaları: Giriş gerektiren sayfaların başında
await requireModule('slug')sonraconst user = await requireAuth()çağırın. Elleredirect('/login')yazmayın. - Veri çekme: Server Component’te
const api = await leaderos(), etkileşimli bileşenlerdeuseLeaderOS(). - Çeviri:
t('English text')(sunucudaawait getT(), istemcideuseT()). - Tema ayarları: Renkler, koyu mod, logo gibi seçenekler panelde flat temasının ayarlarından gelir (
config.theme). - HTML alanları (içerik, açıklama): yetkililer tarafından yazılır;
dangerouslySetInnerHTMLile.prose-contentiçinde gösterilir.
Yeni sayfa ekleme
Sonraki adımlar
Yapay zeka ile geliştirin
Claude Code, Cursor vb. ile temayı özelleştirin.
Yayına alın
Temayı kendi VDS’inizde çalıştırın.
