> ## Documentation Index
> Fetch the complete documentation index at: https://developer.leaderos.net/llms.txt
> Use this file to discover all available pages before exploring further.

# create-leaderos-theme

> Tek komutla LeaderOS sitenize bağlı hazır bir Next.js teması oluşturun.

`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ıç](https://developer.leaderos.net/headless/tr/quickstart.md))

## Kurulum

> [tab] Etkileşimli
>
> ```bash theme={null}
> npm create leaderos-theme@latest my-theme
> ```
>
> Sorulara yanıt verin:
>
> 1. **Project folder**: proje klasörü
> 2. **Your LeaderOS website URL**: `https://siteniz.com`
> 3. **Public key**: `pk_live_...`

> [tab] Etkileşimsiz
>
> ```bash theme={null}
> npx create-leaderos-theme my-theme \
>   --url https://siteniz.com \
>   --key pk_live_XXXXXXXX \
>   --yes
> ```

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:

```bash theme={null}
LEADEROS_URL=https://siteniz.com
LEADEROS_PUBLIC_KEY=pk_live_XXXXXXXX
```

## İlk çalıştırma

```bash theme={null}
cd my-theme
npm install
npm run dev
```

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ı

```
my-theme/
├── app/
│   ├── (site)/            # header + footer içeren sayfalar
│   ├── (auth)/            # giriş/kayıt düzeni
│   ├── headless/v1/[...path]/route.ts   # API proxy
│   ├── layout.tsx
│   ├── sitemap.ts, robots.ts
├── components/            # header, footer, ürün kartı, sayfalama…
├── lib/
│   ├── leaderos.ts        # sunucu istemcisi, getConfig(), getUser()
│   ├── guards.ts          # requireAuth(), requireGuest()
│   └── module-page.ts     # requireModule(), apiCall()
├── public/                # CSS, görseller
├── AGENTS.md  CLAUDE.md  .mcp.json
└── .env.local
```

## Komutlar

| Komut | Görev |
| - | - |
| `npm run dev` | Geliştirme sunucusu |
| `npm run build` | Üretim derlemesi |
| `npm start` | Derlenmiş uygulamayı başlatır |
| `npm run typecheck` | TypeScript kontrolü |

## Ö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

```tsx theme={null}
// app/(site)/yazilar/page.tsx
import { requireModule, apiCall } from '@/lib/module-page';
import { leaderos } from '@/lib/leaderos';

export default async function Page() {
  await requireModule('blog');               // modül kapalıysa 404
  const api = await leaderos();
  const { data } = await apiCall(() => api.blog.posts.list());
  return <ul>{data.map((p) => <li key={p.id}>{p.title}</li>)}</ul>;
}
```

> [!WARNING]
>
> 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

> [card] [Yapay zeka ile geliştirin](https://developer.leaderos.net/headless/tr/ai-development.md)
>
> Claude Code, Cursor vb. ile temayı özelleştirin.

> [card] [Yayına alın](https://developer.leaderos.net/headless/tr/deployment.md)
>
> Temayı kendi VDS'inizde çalıştırın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.