# Mevcut projeye ekleme

> Var olan bir Next.js projesine trkit'i adım adım ekleyin.

trkit'in parçaları birbirinden bağımsızdır. Yalnızca ihtiyacınız olanı ekleyebilirsiniz.

## Sadece paketler

Doğrulama ve biçimlendirme gibi saf fonksiyonlar için CLI gerekmez:

```bash
npm install @trkit-app-pack/validate @trkit-app-pack/format @trkit-app-pack/address
```

## CLI ile bileşen ve sayfalar

```bash
npx @trkit-app-pack/cli init
npx @trkit-app-pack/cli add yasal cerez-banner il-ilce-secici
```

`init` projenizin yapısını algılar (`src/` dizini, `tsconfig` import takma adı, shadcn/ui `components.json`) ve `trkit.json` dosyasına yazar. Algılanan yolları değiştirmek isterseniz bu dosyayı düzenleyin:

```json title="trkit.json"
{
  "aliases": { "app": "src/app", "components": "src/components", "lib": "src/lib", "src": "src" },
  "importAlias": "@/"
}
```

## Gerekli ayarlar

**Tailwind CSS**: Bileşenler shadcn/ui ile aynı renk adlarını kullanır (`bg-background`, `border-input`, `text-muted-foreground`, `bg-primary`…). Projenizde shadcn/ui varsa ek ayar gerekmez. Yoksa bu değişkenleri tanımlayın; örnek için create-trkit-app şablonundaki `globals.css` dosyasına bakın.

**Typography**: Yasal sayfalar `prose` sınıfını kullanır:

```bash
npm install -D @tailwindcss/typography
```

```css title="globals.css"
@plugin "@tailwindcss/typography";
```

**Çerez banner'ı**: `layout.tsx` içinde sayfa içeriğini sarın:

```tsx title="app/layout.tsx"
import { CookieConsentProvider } from "@/components/trkit/cerez-banner";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="tr">
      <body>
        <CookieConsentProvider>{children}</CookieConsentProvider>
      </body>
    </html>
  );
}
```

**Türkçe zod mesajları**:

```ts title="lib/zod.ts"
import { z } from "zod";
import { zodTurkce } from "@trkit-app-pack/validate";

zodTurkce(z);
export { z };
```

**AI dosyaları**: create-trkit-app'in ürettiği `AGENTS.md` dosyasını projenize kopyalayıp düzenleyebilirsiniz. Ayrıntılar: [AI ile geliştirme](/docs/ai).