@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/tr/intlayer_with_vite+vue.md

@@ -93,7 +93,7 @@ Bir i18n çözümünden çok daha fazlası olan Intlayer, **kendi kendine barın
 
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
@@ -130,19 +130,19 @@ GitHub'da [Uygulama Şablonu](https://github.com/aymericzip/intlayer-vite-vue-te
 Gerekli paketleri npm kullanarak kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/docs/tr/live-sync.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: Canlı senkronizasyon | CMS içerik değişikliklerini çalışma zamanında yansıtın
+description: Uygulamanızın, yeniden derleme veya yeniden dağıtım gerektirmeden Intlayer CMS içerik değişikliklerini çalışma zamanında yansıtmasını sağlayın.
+keywords:
+  - Canlı senkronizasyon
+  - Live Sync
+  - CMS
+  - Görsel Düzenleyici
+  - Uluslararasılaştırma
+  - Dokümantasyon
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Intlayer CMS belgelerinden ayrılarak kendi sayfasına taşındı"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "Canlı senkronizasyon dokümantasyonu eklendi"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "`hotReload` alanı `liveSync` ile değiştirildi"
+author: aymericzip
+---
+
+# Canlı senkronizasyon
+
+Canlı Senkronizasyon, uygulamanızın CMS içerik değişikliklerini çalışma zamanında yansıtmasını sağlar. Yeniden derleme veya yeniden dağıtım gerekmez. Etkinleştirildiğinde, güncellemeler uygulamanızın okuduğu sözlükleri yenileyen bir Canlı Senkronizasyon sunucusuna aktarılır.
+
+## İçindekiler
+
+<TOC/>
+
+---
+
+## Canlı senkronizasyonu etkinleştirme
+
+> Canlı Senkronizasyon sürekli bir sunucu bağlantısı gerektirir ve yalnızca enterprise planında kullanılabilir.
+
+Intlayer yapılandırmanızı güncelleyerek Canlı Senkronizasyonu etkinleştirin:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... diğer yapılandırma ayarları
+  editor: {
+    /**
+     * Değişiklik algılandığında yerel ayar yapılandırmalarının sıcak yeniden yüklemesini etkinleştirir.
+     * Örneğin, bir sözlük eklendiğinde veya güncellendiğinde, uygulama sayfada görüntülenen içeriği günceller.
+     *
+     * Sıcak yeniden yükleme sürekli bir sunucu bağlantısı gerektirdiği için,
+     * yalnızca `enterprise` planı müşterileri için kullanılabilir.
+     *
+     * Varsayılan: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * Sözlüklerin nasıl içe aktarılacağını kontrol eder:
+     *
+     * - "live": Sözlükler, Live Sync API kullanılarak dinamik olarak getirilir.
+     *   useIntlayer yerine useDictionaryDynamic kullanılır.
+     *
+     * Not: Canlı mod, sözlükleri getirmek için Live Sync API'sini kullanır. API çağrısı
+     * başarısız olursa, sözlükler dinamik olarak içe aktarılır.
+     * Not: Yalnızca uzak içeriğe ve "live" bayraklarına sahip sözlükler canlı modu kullanır.
+     * Diğerleri performans için dinamik modu kullanır.
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+Uygulamanızı sarmak için Live Sync sunucusunu başlatın:
+
+Next.js kullanarak örnek:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer komutlar
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Vite kullanarak örnek:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer komutlar
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Live Sync sunucusu uygulamanızı sarar ve güncellenen içeriği geldiği anda otomatik olarak uygular.
+
+CMS'den değişiklik bildirimleri almak için, Live Sync sunucusu backend ile bir SSE bağlantısı sürdürür. CMS'de içerik değiştiğinde, backend güncellemeyi Live Sync sunucusuna iletir ve bu sunucu yeni sözlükleri yazar. Uygulamanız, sonraki gezinme veya tarayıcı yenilemesinde güncellemeyi yansıtacaktır, yeniden derleme gerekmez.
+
+Akış şeması (CMS/Backend -> Live Sync Sunucusu -> Uygulama Sunucusu -> Ön Yüz):
+
+![Live Sync Mantık Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+Nasıl çalışır:
+
+![Live Sync Akış CMS/Backend/Live Sync Sunucusu/Uygulama Sunucusu/Ön Yüz Şeması](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+## Geliştirme iş akışı (yerel)
+
+- Geliştirme aşamasında, uygulama başladığında tüm uzak sözlükler alınır, böylece güncellemeleri hızlıca test edebilirsiniz.
+- Next.js ile Live Sync'i yerel olarak test etmek için geliştirme sunucunuzu şu şekilde sarmalayın:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... diğer scriptler
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Vite için
+  },
+}
+```
+
+Optimizasyonu etkinleştirin, böylece Intlayer geliştirme sırasında Live import dönüşümlerini uygular:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true,
+  },
+};
+
+export default config;
+```
+
+Bu yapılandırma, geliştirme sunucunuzu Live Sync sunucusuyla sarar, başlangıçta uzak sözlükleri getirir ve CMS'den SSE aracılığıyla güncellemeleri aktarır. Değişiklikleri görmek için sayfayı yenileyin.
+
+## Notlar ve kısıtlamalar
+
+- Live sync kaynağını site güvenlik politikanıza (CSP) ekleyin. Live sync URL'sinin `connect-src` içinde (ve ilgili ise `frame-ancestors` içinde) izinli olduğundan emin olun.
+- Live Sync statik çıktı ile çalışmaz. Next.js için, sayfa çalışma zamanında güncellemeleri alabilmek için dinamik olmalıdır (örneğin, tam statik kısıtlamalardan kaçınmak için `generateStaticParams`, `generateMetadata`, `getServerSideProps` veya `getStaticProps` uygun şekilde kullanılmalıdır).
+- CMS'de, her sözlüğün bir `live` bayrağı vardır. Yalnızca `live=true` olan sözlükler live sync API'si aracılığıyla alınır; diğerleri dinamik olarak içe aktarılır ve çalışma zamanında değişmeden kalır.
+- `live` bayrağı her sözlük için build zamanında değerlendirilir. Uzaktaki içerik derleme sırasında `live=true` olarak işaretlenmemişse, o sözlük için Live Sync'i etkinleştirmek üzere yeniden derleme yapmanız gerekir.
+- Live sync sunucusunun `.intlayer` dosyasına yazabilmesi gerekir. Konteynerlerde, `/.intlayer` dosyasına yazma erişiminin olduğundan emin olun.
+
+## Faydalı bağlantılar
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Intlayer Görsel Düzenleyici](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_visual_editor.md)
+- [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)

package/docs/tr/migration_from_i18next_to_intlayer.md

@@ -100,19 +100,19 @@ Aşağıdaki adımlar, mevcut `i18next` uygulamanızı herhangi bir kod değişi
 Temel Intlayer paketi ile uyumluluk adaptörünü kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/docs/tr/migration_from_next-i18next_to_intlayer.md

@@ -103,19 +103,19 @@ Aşağıdaki adımlar, mevcut Next.js (Pages Router) uygulamanızı hiçbir sayf
 Temel Intlayer paketlerini ve uyumluluk adaptörlerini kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/docs/tr/migration_from_next-intl_to_intlayer.md

@@ -99,19 +99,19 @@ Aşağıdaki adımlar, mevcut `next-intl` uygulamanızı herhangi bir kod deği
 Temel Intlayer paketlerini ve `@intlayer/next-intl` uyumluluk adaptörünü kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.
@@ -185,9 +185,7 @@ import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
 
 const withIntlayer = createNextIntlPlugin();
 
-const nextConfig: NextConfig = {
-  /* Mevcut Next.js seçenekleriniz */
-};
+const nextConfig: NextConfig = {/* Mevcut Next.js seçenekleriniz */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/tr/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -102,19 +102,19 @@ Aşağıdaki adımlar, mevcut Nuxt uygulamanızı hiçbir bileşen kodunu deği
 Temel Intlayer paketlerini ve uyumluluk adaptörünü kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/docs/tr/migration_from_react-i18next_to_intlayer.md

@@ -102,19 +102,19 @@ Aşağıdaki adımlar, mevcut `react-i18next` uygulamanızı hiçbir bileşen ko
 Temel Intlayer paketlerini ve uyumluluk adaptörünü kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.
@@ -210,9 +210,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* diğer yapılandırma ayarlarınız */
-};
+const nextConfig: NextConfig = {/* diğer yapılandırma ayarlarınız */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/tr/migration_from_vue-i18n_to_intlayer.md

@@ -101,19 +101,19 @@ Aşağıdaki adımlar, mevcut `vue-i18n` uygulamanızı hiçbir bileşen kodunu
 Temel Intlayer paketlerini ve uyumluluk adaptörünü kurun:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/docs/tr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Yeni Intlayer v9 - Yenilikler Neler?
 description: Intlayer v9'daki yenilikleri keşfedin. Popüler i18n kütüphaneleri için doğrudan uyumlu paketler ve Koleksiyonlar ve Varyantlar desteği sunuluyor.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=zmCN4z_B4jk
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Intlayer v9'a hoş geldiniz! Bu ana sürüm, büyük i18n kütüphaneleri (`react-i18next`, `next-intl`, `vue-i18n` vb.) için sunulan **Compat Adapter Paketleri** ile Intlayer'a geçiş sürecini basitleştirmede dev bir adımı temsil ediyor ve zengin içerik yapıları için destek ekliyor: **Koleksiyonlar (Collections)** ve **Varyantlar (Variants)**.
 
+<iframe
+  src="https://www.youtube.com/embed/zmCN4z_B4jk"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## İçindekiler
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +121,40 @@ Intlayer v9, statik anahtar-değer nesnelerinin ötesine geçerek sözlüklerin
 
 CMS tarafından yönetilen sıralı öğelerin bir listesini tanımlayın (örneğin SSS'ler, ürünler veya blog listeleri):
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        tr: "Intlayer nedir?",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        tr: "Bir i18n araç kiti.",
-        en: "An i18n toolkit.",
-        fr: "Une boîte à outils i18n.",
-      }),
-    },
-  ],
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Kullanım:
 
 ```ts
-// Tüm öğeleri getir
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Dizine göre tek bir öğe getir
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Varyantlar (Variants)
@@ -192,28 +208,52 @@ export default {
 ```ts
 // Yalnızca talep edilen öğeyi dinamik olarak getirir (Suspense gerektirir)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Dinamik Yükleme ve Bundle Boyutu Optimizasyonları
-
-Bundle boyutlarını son derece küçük tutmak için Intlayer v9 dinamik tembel yüklemeyi (dynamic lazy loading) destekler.
-
-Yapılandırmanızda `importMode` değerini `'dynamic'` veya `'fetch'` olarak ayarlayın:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: içerik gösterim takibi ve A/B testi
+
+Yeni bir isteğe bağlı paket olan [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), ziyaretçilerinize gerçekte hangi içeriğin gösterildiğini bildirir — ve içerik üzerinde A/B testi yapmanıza ve varyant başına dönüşümleri ölçmenize olanak tanıyarak **Collections & Variants** döngüsünü tamamlar.
+
+- **Provider düzeyinde takip**: `IntlayerProvider` (React / Next.js / React Native) yükleme, rota değişikliği ve dil değişikliğinde otomatik olarak `page_view` olayları kaydeder.
+- **Node düzeyinde takip**: her `useIntlayer` çözümlemesi bir `content_exposure` olayı bildirir — hangi sözlük anahtarı, anahtar yolu, dil ve (varsa) hangi A/B **varyantı** gösterildiği. Bir flush penceresi içinde aynı düğümün tekrarlanan gösterimleri tek bir olayda birleştirilir.
+- **Deterministik A/B ataması**: `getVariant(experimentKey, variants)`, **sunucuya gidiş-dönüş olmadan** her oturuma bir varyant atar, bu nedenle ilk render öncesinde titreme olmaz.
+- **`useConversion()`**: bir hedefi (kayıt, tıklama, satın alma…) oturumun maruz kaldığı varyanta atfeder.
+- **Kurulu değilse sıfır maliyet**: `@intlayer/editor` ile aynı tree-shakeable desen — `try/catch` içine sarılmış dinamik `import()`, artı bunu etkinleştirmeyen uygulamalar için tüm entegrasyonu ölü kod olarak kaldıran bir derleme zamanı ortam değişkeni (`INTLAYER_ANALYTICS_ENABLED`).
+- **Yeni bir yapılandırma şeması yok**: mevcut `editor.backendURL` (gönderim uç noktası / kendi sunucunuzda barındırma) ve `editor.clientId` (proje anahtarı, aynı zamanda etkinleştirme anahtarı) yeniden kullanılır.
+- **Gizliliğe saygılı**: anonim oturum hashleme (SHA-256, ham kimlikler saklanmaz), IP saklanmaz, yalnızca kaba ülke düzeyinde konum, istekler yaklaşık her 20 saniyede bir toplu olarak gönderilir.
+- **Kontrol paneli**: bir proje seçildikten sonra kenar çubuğunda görünen yeni bir **Analytics** sayfası; aktif kullanıcıları, bugünkü kullanıcıları, son 7/30/90 gündeki kullanıcıları, bir ziyaretçi gelişim grafiğini ve Yerel Ayar/Konum dağılımlarını gösterir.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-Derleme zamanında, `@intlayer/swc` ve `@intlayer/babel` dosyalarınızı tarar ve `useIntlayer` / `getIntlayer` çağrılarını tree-shakeable sarmalayıcılarla (`useDictionary` / `useDictionaryDynamic`) değiştirir. Yalnızca seçilen koleksiyon öğesi, varyant veya dil (locale) için gerekli olan içerik yüklenir, böylece üretim (production) bundle'ınızın kullanılmayan çevirileri içermesi engellenir.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Bugün React, Next.js ve React Native (`react-intlayer` üzerinden) için kullanılabilir; diğer framework bağlamaları (Vue, Svelte, Angular, …) `@intlayer/editor` ile aynı yayılma desenini izleyerek planlanmaktadır. Tam kılavuz için [Analytics belgelerine](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) bakın.
 
 ---
 
@@ -296,6 +336,46 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer'ı başsız içerik veritabanı olarak kullanın
+
+Intlayer v9, CMS ile programatik olarak etkileşim kurmak için `@intlayer/api` içinde temiz ve kendi kendine kimlik doğrulayan bir SDK sunar — projeleri getirin, sözlükleri getirin ve bunları kendi sunucunuzdan, betiklerinizden veya CI'nizden gönderin ya da güncelleyin. Kimlik doğrulama (OAuth2 `client_credentials`) sizin için yönetilir ve yenilenir.
+
+SDK **iki ayrı içe aktarmaya** bölünmüştür; böylece paketiniz yalnızca gerçekten kullandığınız alanları içerir:
+
+1. `createIntlayerCMS` — kimlik bilgilerini ve yönetilen jetonu tutan hafif bir **kimlik doğrulayıcı** (hiçbir alan istemcisi pakete dahil edilmez).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — her biri kendi alt yolundan içe aktarılan, alan başına **endpoint bağlayıcıları**.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// Yapılandırma isteğe bağlıdır: kimlik bilgileri INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET değerlerine geri döner (`@intlayer/config/built` tarafından çözülür).
+const cms = createIntlayerCMS();
+
+// Okuma
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Yazma — CMS'i bir veritabanı gibi kullanın
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Güvenlik: CMS kimlik bilgileri içeriğinize yazma erişimi verir. Kimlik doğrulayıcıyı her zaman yalnızca **sunucu tarafında** oluşturun — `clientId` / `clientSecret` değerlerini asla tarayıcıya göndermeyin.
+
+---
+
+## Kendi Sunucunuzda Barındırma
+
+Intlayer v9, tek bir komutla kendi Intlayer örneğinizi çalıştırmak için birinci sınıf destek sunuyor — Intlayer Cloud hesabı gerekmez.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Yükleyici, bir `docker-compose.yml` ve bir `.env` dosyasını indirir, gerekli gizli anahtarları otomatik olarak oluşturur ve `docker compose up -d` komutunu çalıştırır. Kontrol paneli, API, veritabanı, nesne depolama ve işlemsel e-posta dahil her şey yerel olarak kapsayıcılarda çalışır.
+
+---
+
 ## v8'den Geçiş Notları
 
 v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking changes) içermediğini unutmayın. Ancak işte temel değişiklikler:
@@ -310,4 +390,7 @@ v8'den yükseltme yapıyorsanız, v9'un yıkıcı değişiklikler (breaking chan
 
 - [Compat Adapter Paketleri Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/compat/index.md)
 - [Dinamik Sözlükler - Koleksiyonlar ve Varyantlar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/dynamic_dictionaries/index.md)
+- [Analytics - İçerik gösterim takibi ve A/B testi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Yapılandırma Referansı](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
+- [CMS SDK - @intlayer/api ile programatik erişim](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
+- [Kendi Sunucuda Barındırma Kılavuzu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/self_hosting.md)