# Kurulum

> create-trkit-app ile tek komutla Türkçe Next.js projesi oluşturun.

## Gereksinimler

- Node.js 20.9 veya üzeri
- npm, pnpm, yarn veya bun

## Yeni proje

```bash
npx create-trkit-app@latest benim-sitem
```

Komut size proje adını ve şablonu sorar, dosyaları oluşturur, bağımlılıkları kurar ve bir git deposu başlatır. Ardından:

```bash
cd benim-sitem
npm run dev
```

Tarayıcıda [http://localhost:3000](http://localhost:3000) adresini açın.

Diğer paket yöneticileriyle:

```bash
pnpm create trkit-app benim-sitem
yarn create trkit-app benim-sitem
bun create trkit-app benim-sitem
```

## Şablonlar

| Şablon | İçerik |
|---|---|
| `minimal` | Türkçe temel, KVKK aydınlatma metni, çerez politikası ve onay banner'ı, il/ilçe seçici, örnek iletişim formu |
| `kurumsal` (varsayılan) | Minimal + açık rıza metni, KVKK başvuru formu, ticari ileti onayı, il/ilçe arama |
| `eticaret` | Kurumsal + mesafeli satış sözleşmesi, ön bilgilendirme formu, teslimat-iade koşulları, iyzico/PayTR ödeme, ödeme onay kutuları, SMS ve OTP |

```bash
npx create-trkit-app@latest magaza --sablon eticaret
```

## Seçenekler

| Seçenek | Açıklama |
|---|---|
| `--sablon <ad>` | `minimal`, `kurumsal` veya `eticaret` |
| `--use-npm`, `--use-pnpm`, `--use-yarn`, `--use-bun` | Paket yöneticisini seçer (varsayılan: komutu çalıştırdığınız yönetici) |
| `--no-install` | Bağımlılıkları kurmaz |
| `--no-git` | Git deposu oluşturmaz |
| `-y`, `--yes` | Soru sormadan varsayılanlarla ilerler (CI ve AI ajanları için) |

> AI ajanına proje oluşturtuyorsanız `--yes` ile çalıştırın; etkileşimli sorular ajanı bekletir.

## İlk yapılacaklar

1. `src/trkit.config.ts` dosyasında şirket bilgilerinizi (unvan, MERSİS, adres, telefon, e-posta) doldurun.
2. Eksikleri kontrol edin:

   ```bash
   npx trkit check
   ```

3. `.env.example` dosyasını `.env.local` olarak kopyalayın ve değerleri girin.
4. Yayına almadan önce [kontrol listesini](/docs/rehber/yayina-alma) gözden geçirin.

## Mevcut bir projeniz mi var?

create-trkit-app yerine trkit CLI ile parça parça ekleyebilirsiniz: [Mevcut projeye ekleme](/docs/mevcut-projeye-ekleme).