Ana içeriğe atla
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

Sorulara yanıt verin:
  1. Project folder: proje klasörü
  2. Your LeaderOS website URL: https://siteniz.com
  3. Public key: pk_live_...
Araç şunları yapar:
  1. Girdiğiniz adrese GET /headless/v1/site/config isteği atıp bağlantıyı test eder (✔ Connected to ... (LeaderOS 6.x)). Başarısız olursa uyarı verir ama devam eder.
  2. Şablonu klasöre kopyalar (klasör boş olmalıdır).
  3. .env.local dosyasını oluşturur:

İlk çalıştırma

Tarayıcıda 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') sonra const user = await requireAuth() çağırın. Elle redirect('/login') yazmayın.
  • Veri çekme: Server Component’te const api = await leaderos(), etkileşimli bileşenlerde useLeaderOS().
  • Çeviri: t('English text') (sunucuda await getT(), istemcide useT()).
  • 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; dangerouslySetInnerHTML ile .prose-content içinde gösterilir.

Yeni sayfa ekleme

Footer veya düzenleri değiştirirken <PoweredBy /> bileşeninin görünür kaldığından emin olun. Bu bir lisans şartıdır.

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.