@intlayer/docs 9.5.2 → 9.5.4-canary.0

package/blog/tr/i18next_vs_intlayer.md

@@ -0,0 +1,445 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: "i18next vs Intlayer: 2026 Karşılaştırma ve Benchmark Testi"
+description: "Next.js ve TanStack Start üzerinde Intlayer ile karşılaştırılan react-i18next ve next-i18next ölçümleri. Paket boyutu, içerik sızıntısı, dil değiştirme tepki süresi ve geliştirici deneyimi."
+keywords:
+  - i18next
+  - react-i18next
+  - next-i18next
+  - Intlayer
+  - Uluslararasılaştırma
+  - i18n
+  - Benchmark
+  - Paket boyutu
+  - Blog
+  - Next.js
+  - TanStack Start
+  - JavaScript
+  - React
+slugs:
+  - blog
+  - i18next-vs-intlayer
+author: aymericzip
+---
+
+# i18next VS Intlayer | React & Next.js Uluslararasılaştırma (i18n) Benchmark Karşılaştırması
+
+`i18next`, JavaScript ekosisteminde en yaygın kullanılan i18n kütüphanesidir. `react-i18next` ve `next-i18next` aracılığıyla çok sayıda React ve Next.js uygulamasını destekler. Intlayer ise derleyici tabanlı ve bileşen kapsamlı (component-scoped) modern bir alternatiftir.
+
+Bu makale iki aracı özellik listeleri yerine somut ölçümlerle karşılaştırır. Rakamlar, her kütüphaneyle aynı uygulamayı oluşturan ve tarayıcının gerçekte ne indirdiğini kaydeden açık kaynaklı bir test paketi olan [Benchmark Bloom](https://github.com/intlayer-org/benchmark-bloom) projesinden alınmıştır.
+
+<TOC/>
+
+> **Özet (tl;dr)**: `i18next`, bu benchmark testindeki en ağır çalışma zamanıdır (runtime): Standart (naive) kurulumda Next.js üzerinde sayfa başına **+77 KB gzip**, tam ad alanı (namespace) ve tembel yükleme (lazy-loading) optimizasyonundan sonra bile **+22 KB** ek yük getirir. Intlayer ise yalnızca **+0.3 KB** ekler. Tamamen izole edilmiş (scoped) kurulum dışındaki tüm `i18next` yapılandırmaları, **kullanıcının bulunmadığı diğer sayfaların çeviri metinlerinin yaklaşık %90'ını sızdırır**; Intlayer ise varsayılan olarak **%0** sızıntı ile çalışır. Tembel yüklenen bir backend ile dil değiştirmek `react-i18next` ile **123-185 ms** sürerken Intlayer ile yalnızca **3-4 ms** sürmüştür. `i18next` API'sini koruyan `@intlayer/next-i18next` uyumluluk adaptörü, sayfa boyutunu orijinalin **218.5 KB** seviyesinden **150.7 KB** seviyesine düşürmüştür.
+
+## Kısaca Özet
+
+- **i18next / react-i18next / next-i18next** - Olgun, zengin eklenti ekosistemine sahip ve çatıdan bağımsız (framework-agnostic). Ad alanları, dil algılayıcıları, arka uçlar, eklenti üzerinden ICU ve zengin içerikler için `<Trans>` desteği sunar. İçerikler `locales/{lng}/{ns}.json` altında merkezi olarak toplanır. Güçlüdür ancak her optimizasyonu (ad alanı ayrımı, sayfa bazlı yükleme, tip güvenliği) geliştiricinin manuel olarak yapılandırmasını ve sürdürmesini gerektirir.
+- **Intlayer** - Bileşen odaklı içerik modeli. `.content.ts` sözlükleri doğrudan hizmet ettikleri bileşenin yanında yer alır; derleme zamanı derleyicisi bileşen ve dil bazında ağaç budama (tree-shaking) ve tembel yükleme uygular, içerikten katı TypeScript tipleri otomatik oluşturulur ve eksik çeviriler derleme anında hata verir. Dahili middleware, SEO yardımcıları, Görsel Editör / CMS ve yapay zeka destekli çeviri sunar.
+
+| Kütüphane               | GitHub Yıldızları                                                                                                                                                                  | Toplam Commit                                                                                                                                                                          | Son Commit                                                                                                                                              | İlk Sürüm   | NPM Sürümü                                                                                                            | NPM İndirmeleri                                                                                                                  |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `aymericzip/intlayer`   | [![GitHub Repo stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=%E2%AD%90%20stars)](https://github.com/aymericzip/intlayer/stargazers)     | [![GitHub commit activity](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits)     | [![Last Commit](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits)     | Nisan 2024  | [![npm](https://img.shields.io/npm/v/intlayer?style=for-the-badge)](https://www.npmjs.com/package/intlayer)           | [![npm downloads](https://img.shields.io/npm/dm/intlayer?style=for-the-badge)](https://www.npmjs.com/package/intlayer)           |
+| `i18next/i18next`       | [![GitHub Repo stars](https://img.shields.io/github/stars/i18next/i18next?style=for-the-badge&label=%E2%AD%90%20stars)](https://github.com/i18next/i18next/stargazers)             | [![GitHub commit activity](https://img.shields.io/github/commit-activity/t/i18next/i18next?style=for-the-badge&label=commits)](https://github.com/i18next/i18next/commits)             | [![Last Commit](https://img.shields.io/github/last-commit/i18next/i18next?style=for-the-badge)](https://github.com/i18next/i18next/commits)             | Ocak 2012   | [![npm](https://img.shields.io/npm/v/i18next?style=for-the-badge)](https://www.npmjs.com/package/i18next)             | [![npm downloads](https://img.shields.io/npm/dm/i18next?style=for-the-badge)](https://www.npmjs.com/package/i18next)             |
+| `i18next/react-i18next` | [![GitHub Repo stars](https://img.shields.io/github/stars/i18next/react-i18next?style=for-the-badge&label=%E2%AD%90%20stars)](https://github.com/i18next/react-i18next/stargazers) | [![GitHub commit activity](https://img.shields.io/github/commit-activity/t/i18next/react-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/react-i18next/commits) | [![Last Commit](https://img.shields.io/github/last-commit/i18next/react-i18next?style=for-the-badge)](https://github.com/i18next/react-i18next/commits) | Aralık 2015 | [![npm](https://img.shields.io/npm/v/react-i18next?style=for-the-badge)](https://www.npmjs.com/package/react-i18next) | [![npm downloads](https://img.shields.io/npm/dm/react-i18next?style=for-the-badge)](https://www.npmjs.com/package/react-i18next) |
+| `i18next/next-i18next`  | [![GitHub Repo stars](https://img.shields.io/github/stars/i18next/next-i18next?style=for-the-badge&label=%E2%AD%90%20stars)](https://github.com/i18next/next-i18next/stargazers)   | [![GitHub commit activity](https://img.shields.io/github/commit-activity/t/i18next/next-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/next-i18next/commits)   | [![Last Commit](https://img.shields.io/github/last-commit/i18next/next-i18next?style=for-the-badge)](https://github.com/i18next/next-i18next/commits)   | Kasım 2018  | [![npm](https://img.shields.io/npm/v/next-i18next?style=for-the-badge)](https://www.npmjs.com/package/next-i18next)   | [![npm downloads](https://img.shields.io/npm/dm/next-i18next?style=for-the-badge)](https://www.npmjs.com/package/next-i18next)   |
+
+> Rozetler otomatik olarak güncellenir. Değerler zamanla değişiklik gösterebilir.
+
+## Özellik Karşılaştırması
+
+| Özellik                                          | Intlayer (`react-intlayer` / `next-intlayer`)                                       | i18next (`react-i18next` / `next-i18next`)                                  |
+| ------------------------------------------------ | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| **Bileşen yanında çeviri tanımlama**             | ✅ Evet, her bileşenle aynı dizinde `.content.ts`                                   | ❌ Hayır, `locales/{lng}/{ns}.json` altında merkezi yapı                    |
+| **TypeScript entegrasyonu**                      | ✅ İçerikten otomatik olarak üretilen katı tipler                                   | ⚠️ Temel; katı anahtarlar için `CustomTypeOptions` genişletmesi gereklidir  |
+| **Eksik çeviri tespiti**                         | ✅ TypeScript hatası + derleme anında hata/uyarı                                    | ⚠️ Çalışma zamanı yedeği (`saveMissing`, anahtarın kendisini döndürme)      |
+| **Zengin içerik (JSX / Markdown / bileşenler)**  | ✅ Doğrudan yerel destek                                                            | ⚠️ Numaralı etiketlerle `<Trans>` bileşeni                                  |
+| **ICU desteği**                                  | ⚠️ Geliştirilme aşamasında                                                          | ⚠️ Eklenti ile (`i18next-icu`)                                              |
+| **Çoğullaştırma (Pluralization)**                | ✅ Numaralandırma (enum) tabanlı açık modeller                                      | ✅ `_one` / `_other` sonekleri (Intl.PluralRules)                           |
+| **Biçimlendirme (tarih, sayı, para birimi)**     | ✅ `useNumber`, `useDate`, ... (yerel Intl desteği)                                 | ⚠️ İnterpolasyon biçimlendiricileri veya manuel `Intl.*` çağrıları          |
+| **Yerelleştirilmiş yönlendirme ve middleware**   | ✅ Yerleşik proxy/middleware desteği, `getMultilingualUrls`                         | ⚠️ Çekirdeğe dahil değil; özel middleware veya üçüncü taraf araçlar gerekir |
+| **SEO yardımcıları (hreflang, sitemap, robots)** | ✅ Yerleşik yardımcılar                                                             | ❌ Manuel kurulum gerekir                                                   |
+| **Eşzamanlı sunucu bileşenleri (RSC)**           | ✅ `next-intlayer/server` altındaki `useIntlayer` tüm sunucu bileşenlerinde çalışır | ⚠️ Sayfa seviyesinde `getFixedT` çağrısı yapıp `t`'yi Props ile aktarma     |
+| **Tree-shaking (yalnızca kullanılan içerik)**    | ✅ Bileşen ve dil bazında derleyici tarafından otomatik yapılır                     | ⚠️ Manuel: ad alanları + sayfa başına `ns` listesi + arka uç yapılandırması |
+| **Tembel yükleme (Lazy loading)**                | ✅ `importMode: 'dynamic'` (tek satırlık yapılandırma)                              | ✅ Arka uç eklentileri aracılığıyla (`i18next-resources-to-backend` vb.)    |
+| **Kullanılmayan içeriğin temizlenmesi**          | ✅ Kullanılmayan sözlükler derleme anında elenir                                    | ❌ Yerleşik destek yok                                                      |
+| **Eksik çeviri testleri (CLI / CI)**             | ✅ `npx intlayer content test`                                                      | ⚠️ `i18next-parser` veya harici araçlar                                     |
+| **Yapay zeka destekli çeviri**                   | ✅ Yerleşik, kendi API anahtarlarınızı kullanır                                     | ❌ Yok (Locize ayrı ve ücretli bir platformdur)                             |
+| **Görsel Editör / CMS**                          | ✅ Ücretsiz Görsel Editör + isteğe bağlı CMS                                        | ❌ Yok (Locize veya harici sistemler gerektirir)                            |
+| **MCP Sunucusu & Agent Skills**                  | ✅ Desteklenir                                                                      | ❌ Desteklenmez                                                             |
+| **Ekosistem ve topluluk**                        | ⚠️ Daha yeni ancak hızla büyüyor                                                    | ✅ En büyük ve en olgun ekosistem                                           |
+
+## Benchmark Testi
+
+### Neler Ölçüldü?
+
+[Benchmark Bloom](https://github.com/intlayer-org/benchmark-bloom) test paketi, her kütüphane ile **birebir aynı uygulamayı** inşa eder: **10 sayfa** (home, about, blog, careers, contact, FAQ, pricing, products, settings, team), **10 dil** (`en`, `fr`, `es`, `de`, `it`, `pt`, `zh`, `ja`, `ko`, `ru`), özdeş bileşenler ve özdeş içerik. Sayfalar İngilizce (`en`) ve Fransızca (`fr`) olarak test edilir. Her kütüphane dört farklı **yükleme stratejisi** ile değerlendirilir:
+
+| Strateji           | Açıklama                                                                                 | Tipik Kullanım Alanı                     |
+| ------------------ | ---------------------------------------------------------------------------------------- | ---------------------------------------- |
+| **static**         | Tüm diller ve tüm sayfalar tek pakette toplanır (`init()` içinde satır içi `resources`)  | Hızlı prototipler, yapay zeka kodları    |
+| **dynamic**        | Yalnızca aktif dil arka uçtan yüklenir, ancak tüm ad alanları tek seferde gelir          | Çoğu standart proje                      |
+| **scoped-static**  | Rota başına bir ad alanı ayrılır, tümü baştan ana pakete dahil edilir                    | Nadir görülen yapılandırmalar            |
+| **scoped-dynamic** | Rota başına ad alanı + arka uç tembel yükleme. Yalnızca mevcut sayfa ve mevcut dil gelir | Katı performans bütçesi olan uygulamalar |
+
+Intlayer için ayrı bir "scoped" varyantına ihtiyaç yoktur: Derleyici, içeriği **bileşen düzeyinde** otomatik olarak izole eder; bu nedenle `static` ve `dynamic` satırları zaten en iyi düzeyde optimize edilmiştir.
+
+Her derleme için kaydedilen metrikler:
+
+- **Lib size**: Yalnızca i18n kütüphanesini içe aktaran boş bir bileşenin gzip boyutu. Çalışma zamanının sabit maliyeti.
+- **Page JS**: Sayfa başına indirilen ortalama JavaScript gzip boyutu (tüm sayfalar ve diller genelinde).
+- **Locale leak %**: İndirilen JS içerisindeki, kullanıcının **görüntülemediği** bir dile ait çeviri metinlerinin oranı.
+- **Page leak %**: İndirilen JS içerisindeki, kullanıcının **bulunmadığı** diğer sayfalara ait çeviri metinlerinin oranı.
+- **Component avg**: İzole olarak derlenen her bir bileşenin ortalama gzip boyutu.
+- **E2E reactivity**: Yeni bir dil seçimi ile DOM'da `html[lang]` etiketinin güncellenmesi arasındaki gerçek süre (Playwright, 5 deneme ortalaması).
+- **Hydration**: React hidrasyon (hydration) aşamasının süresi.
+
+> Aşağıdaki veriler `next-i18next` 16.3.0, `react-i18next` 17.0.13 ve `intlayer` 9.5.1 sürümleriyle yapılan **2026-09-12** tarihli test çalıştırmasından alınmıştır. Test uygulaması bilinçli olarak kompakt tutulmuştur; bu nedenle sızıntı yüzdeleri **yapısal bir örüntüyü** temsil eder: İçeriğiniz büyüdükçe sızıntı katlanarak artarken çalışma zamanı maliyeti sabit kalır.
+
+### Next.js Sonuçları (`next-i18next`)
+
+| Kütüphane                         | Strateji       | Lib size (gz) | Page JS avg (gz) | Dil Sızıntısı | Sayfa Sızıntısı | Bileşen Ort. (gz) | E2E Tepki Süresi | Hydration |
+| --------------------------------- | -------------- | ------------: | ---------------: | ------------: | --------------: | ----------------: | ---------------: | --------: |
+| **base** (i18n yok)               | -              |        0.0 KB |         141.0 KB |          0.0% |            0.0% |            0.9 KB |          13.4 ms |   11.8 ms |
+| `next-i18next`                    | static         |       19.7 KB |         218.5 KB |          0.0% |           89.8% |           78.5 KB |          16.4 ms |   15.6 ms |
+| `next-i18next`                    | dynamic        |       19.7 KB |         169.5 KB |         50.0% |           89.8% |           26.1 KB |          15.4 ms |   27.7 ms |
+| `next-i18next`                    | scoped-static  |       19.7 KB |         220.1 KB |          0.0% |           89.8% |           78.9 KB |          16.4 ms |   14.7 ms |
+| `next-i18next`                    | scoped-dynamic |       19.7 KB |         163.4 KB |          0.0% |            0.0% |           27.1 KB |          15.9 ms |   15.1 ms |
+| **`next-intlayer`**               | static         |    **5.5 KB** |     **141.3 KB** |      **0.0%** |        **0.0%** |        **8.5 KB** |      **15.5 ms** |   16.9 ms |
+| **`next-intlayer`**               | dynamic        |    **5.5 KB** |     **141.3 KB** |      **0.0%** |        **0.0%** |        **6.9 KB** |      **15.3 ms** |   15.9 ms |
+| `@intlayer/next-i18next` (uyumlu) | static         |        9.4 KB |         150.7 KB |          0.0% |            0.0% |            9.7 KB |          10.7 ms |   11.3 ms |
+| `@intlayer/next-i18next` (uyumlu) | dynamic        |        9.4 KB |         150.7 KB |          0.0% |            0.0% |            9.7 KB |          11.9 ms |   10.6 ms |
+
+**Sonuçların Analizi**
+
+- **Çalışma zamanı maliyeti**: `i18next` çekirdeği ile `react-i18next` birlikte test edilen en ağır çalışma zamanıdır: Boş bir bileşen için **19.7 KB gzip** yer tutarken, `next-intlayer` yalnızca 5.5 KB tüketir.
+- **Standart kurulum maliyetlidir**: `init()` içine `resources` doğrudan yerleştirildiğinde **sayfa başına 218.5 KB** boyuta ulaşılır; bu da temel uygulamaya göre +77.5 KB fazlalıktır. Her sayfa tüm ad alanlarını taşımak zorunda kalır.
+- **Manuel optimizasyon zahmetlidir**: Bir arka uca (`dynamic`) geçmek 49 KB tasarruf sağlar ancak **başka sayfalara ait metinlerin %90'ını sızdırmaya devam eder** ve bu kurulumda indirilen metinlerin yarısı yanlış dile aittir. Rota bazlı ad alanlarına (`scoped-dynamic`) geçildiğinde sızıntı %0'a inse de ulaşılan **163.4 KB** boyutu, hiçbir manuel ayar gerektirmeyen Intlayer'ın (141.3 KB) **sayfa başına 22.4 KB üzerindedir**.
+- **Bileşen boyutu**: `useTranslation()` kullanan bir bileşen 26-79 KB boyutunda derlenirken, aynı bileşen `useIntlayer()` ile yalnızca 6.9 KB yer kaplar.
+- **Hidrasyon gecikmesi**: `dynamic` kurulumunda hidrasyon süresi 27.7 ms'ye yükselir; çünkü React hidrasyona başlamadan önce istemcide i18next örneğinin başlatılması ve arka uçtan veri alması gerekir.
+
+### TanStack Start Sonuçları (`react-i18next`)
+
+Next.js'e özgü yapılandırmaları dışarıda bırakmak adına TanStack Start üzerinde doğrudan `react-i18next` ile yapılan ölçümler:
+
+| Kütüphane           | Strateji       | Lib size (gz) | Page JS avg (gz) | Dil Sızıntısı | Sayfa Sızıntısı | Bileşen Ort. (gz) | E2E Tepki Süresi | Hydration |
+| ------------------- | -------------- | ------------: | ---------------: | ------------: | --------------: | ----------------: | ---------------: | --------: |
+| **base** (i18n yok) | -              |        0.0 KB |         111.0 KB |          0.0% |            0.0% |            0.7 KB |           8.1 ms |   21.6 ms |
+| `react-i18next`     | static         |       18.4 KB |         180.3 KB |         50.0% |           89.8% |           24.3 KB |          12.9 ms |   85.1 ms |
+| `react-i18next`     | dynamic        |       18.4 KB |         136.4 KB |         23.1% |           89.8% |           24.8 KB |         123.1 ms |   32.9 ms |
+| `react-i18next`     | scoped-static  |       18.4 KB |         184.2 KB |         50.7% |           89.8% |           25.3 KB |         185.1 ms |   25.2 ms |
+| `react-i18next`     | scoped-dynamic |       18.4 KB |         127.2 KB |          0.0% |            0.0% |           26.7 KB |          17.6 ms |   11.3 ms |
+| **`intlayer`**      | static         |    **5.0 KB** |     **125.8 KB** |         50.0% |        **0.0%** |        **8.1 KB** |       **3.2 ms** |   11.5 ms |
+| **`intlayer`**      | dynamic        |    **5.0 KB** |     **118.6 KB** |      **0.0%** |        **0.0%** |        **6.3 KB** |       **3.6 ms** |   14.1 ms |
+
+**Sonuçların Analizi**
+
+- Standart `react-i18next` uygulaması temel uygulamaya kıyasla sayfa başına **+69 KB** fazla kod taşır ve hidrasyon **85 ms** (temelin 4 katı) sürer; çünkü tüm kaynak ağacı ilk render öncesinde istemcide işlenir ve kaydedilir.
+- **Dil değişiminde gecikme**: Kaynaklar arka uç üzerinden tembel yüklendiğinde, dili değiştirmek `html[lang]` güncellenmeden önce bir ağ gidiş-dönüşü (round-trip) gerektirir: `dynamic` modunda **123 ms**, `scoped-static` modunda **185 ms**. Intlayer ise her iki modda da DOM'u **3-4 ms** içinde günceller; dil değişimi ağ çağrılarına takılmadan anında gerçekleşir.
+- Tamamen optimize edilmiş `scoped-dynamic` yapılandırması 127.2 KB seviyesine inse de, Intlayer'ın `dynamic` satırından **+8.6 KB daha ağırdır** ve bu sonuca ulaşmak için rota-ad alanı eşleme haritası, arka uç yükleyicisi ve Suspense sınırları gerekmiştir.
+- Intlayer'ın `static` modu, yalnızca ilgili sayfanın bileşenleri tarafından içe aktarılan sözlükleri paketlediği için zaten **%0 sayfa sızıntısına** sahiptir. `importMode: 'dynamic'` ayarını açmak dil sızıntısını da tamamen ortadan kaldırır.
+- **Bileşen boyutu**: `react-i18next` ile bileşen başına 24-27 KB iken Intlayer ile 6-8 KB seviyesindedir.
+
+## Fark Nereden Kaynaklanıyor? Global Örnek vs Derlenmiş Sözlükler
+
+`i18next`, 2012 yılında bir çalışma zamanı kütüphanesi olarak tasarlandı: Global bir örnek kaynak deposunu tutar, eklentiler bunu genişletir ve `t()` render anında anahtarları arar. Bu yapı ona yüksek esneklik kazandırsa da performans açısından ağır bir yük getirir:
+
+```bash
+.
+├── i18n.ts                      # createInstance().use(...).use(...).init({...})
+└── src
+    ├── locales
+    │   ├── en
+    │   │   ├── common.json
+    │   │   ├── home.json
+    │   │   └── about.json
+    │   └── fr
+    │       ├── common.json
+    │       ├── home.json
+    │       └── about.json
+    ├── components
+    │   └── Counter.tsx          # useTranslation("about") + t("counter.label")
+    └── app
+        └── [locale]
+            └── about
+                └── page.tsx     # ["common", "about"] gerektirdiğini bilmek zorundadır
+```
+
+Global örnek, bileşenin hangi anahtarlara ihtiyaç duyacağını önceden bilemez; bu nedenle yüklemesi söylenen tüm ad alanlarını bellekte tutar. Optimizasyon yapmak **sizin** katalogları bölmenizi, **sizin** her sayfanın ihtiyaç duyduğu ad alanlarını listelemenizi ve bileşenler taşındıkça bu listeyi elle güncellemenizi gerektirir. [Benchmark notlarında](https://github.com/intlayer-org/benchmark-bloom/blob/main/report/NOTE.md) ifade edildiği gibi: "Tip güvenliğini korurken hangi sayfaya hangi ad alanının dahil edileceğini tam olarak bilmek tam bir kabustur".
+
+Intlayer global örneği tamamen ortadan kaldırır. İçerik doğrudan bileşenin yanında tanımlanır ve derleyici bağımlılık grafiğini derleme zamanında çözer:
+
+```bash
+.
+├── intlayer.config.ts
+└── src
+    ├── components
+    │   └── Counter
+    │       ├── index.tsx        # useIntlayer("counter")
+    │       └── index.content.ts
+    └── app
+        └── [locale]
+            └── about
+                ├── page.tsx
+                └── page.content.ts
+```
+
+`@intlayer/swc` / `@intlayer/babel` hangi bileşenin hangi sözlüğü kullandığını tespit eder, yalnızca bunları ve yalnızca aktif dil için paketler, kullanılmayan içerikleri eler. "scoped-dynamic" kalıbı, ekibin yönetmek zorunda olduğu bir kural yerine derlemenin otomatik bir çıktısı haline gelir.
+
+> `dynamic` satırındaki rakamları elde etmek için `intlayer.config.ts` dosyasında `dictionary.importMode: 'dynamic'` ayarını yapmanız yeterlidir. Ayrıntılar için [paket optimizasyonu kılavuzuna](https://intlayer.org/tr/doc/concept/bundle-optimization) bakın.
+
+## Geliştirici Deneyimi (DX)
+
+### Kurulum Karşılaştırması
+
+**next-i18next (App Router)**
+
+```ts fileName="src/app/i18n/server.ts"
+import { createInstance } from "i18next";
+import { initReactI18next } from "react-i18next/initReactI18next";
+import resourcesToBackend from "i18next-resources-to-backend";
+import { defaultLocale } from "@/i18n.config";
+
+const backend = resourcesToBackend(
+  (locale: string, namespace: string) =>
+    import(`../../locales/${locale}/${namespace}.json`)
+);
+
+export const initI18next = async (
+  locale: string,
+  namespaces: string[] = ["common"]
+) => {
+  const i18n = createInstance();
+  await i18n
+    .use(initReactI18next)
+    .use(backend)
+    .init({
+      lng: locale,
+      fallbackLng: defaultLocale,
+      ns: namespaces,
+      defaultNS: "common",
+      interpolation: { escapeValue: false },
+      react: { useSuspense: false },
+    });
+  return i18n;
+};
+```
+
+Bunun yanı sıra istemci tarafı `I18nProvider`, `generateStaticParams` ve her sayfada ad alanı dizisi tanımlanmalıdır.
+
+**Intlayer**
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```tsx fileName="src/app/[locale]/layout.tsx"
+import { getHTMLTextDir } from "intlayer";
+import { IntlayerClientProvider, type NextLayoutIntlayer } from "next-intlayer";
+
+const LocaleLayout: NextLayoutIntlayer = async ({ children, params }) => {
+  const { locale } = await params;
+
+  return (
+    <html lang={locale} dir={getHTMLTextDir(locale)}>
+      <body>
+        <IntlayerClientProvider locale={locale}>
+          {children}
+        </IntlayerClientProvider>
+      </body>
+    </html>
+  );
+};
+
+export default LocaleLayout;
+```
+
+### İstemci Bileşeni (Client Component)
+
+**react-i18next**
+
+```json fileName="src/locales/en/about.json"
+{
+  "counter": {
+    "label": "Counter",
+    "increment": "Increment"
+  }
+}
+```
+
+```tsx fileName="src/components/Counter.tsx"
+"use client";
+
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+
+export const Counter = () => {
+  const { t, i18n } = useTranslation("about");
+  const [count, setCount] = useState(0);
+  const numberFormat = new Intl.NumberFormat(i18n.language);
+
+  return (
+    <div>
+      <p>{numberFormat.format(count)}</p>
+      <button
+        aria-label={t("counter.label")}
+        onClick={() => setCount((c) => c + 1)}
+      >
+        {t("counter.increment")}
+      </button>
+    </div>
+  );
+};
+```
+
+> Bu bileşeni kullanan sayfa `about` ad alanını yüklemek zorundadır ve `CustomTypeOptions` genişletilmedikçe `t("counter.label")` düz bir metinden ibarettir.
+
+**Intlayer**
+
+```ts fileName="src/components/Counter/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const counterContent = {
+  key: "counter",
+  content: {
+    label: t({ en: "Counter", fr: "Compteur" }),
+    increment: t({ en: "Increment", fr: "Incrémenter" }),
+  },
+} satisfies Dictionary;
+
+export default counterContent;
+```
+
+```tsx fileName="src/components/Counter/index.tsx"
+"use client";
+
+import { useState } from "react";
+import { useIntlayer } from "next-intlayer";
+import { useNumber } from "next-intlayer/format";
+
+export const Counter = () => {
+  const { label, increment } = useIntlayer("counter");
+  const number = useNumber();
+  const [count, setCount] = useState(0);
+
+  return (
+    <div>
+      <p>{number(count)}</p>
+      <button aria-label={label} onClick={() => setCount((c) => c + 1)}>
+        {increment}
+      </button>
+    </div>
+  );
+};
+```
+
+`label` ve `increment` katı tiplere sahiptir; yazım hataları anında TypeScript hatası verir ve eksik çeviriler derlemeyi durdurur.
+
+### Eşzamanlı Sunucu Bileşeni (Server Component)
+
+**next-i18next**
+
+```tsx fileName="src/components/ServerCounter.tsx"
+type ServerCounterProps = {
+  t: (key: string) => string;
+  locale: string;
+  count: number;
+};
+
+export const ServerCounter = ({ t, locale, count }: ServerCounterProps) => (
+  <div>
+    <p>{new Intl.NumberFormat(locale).format(count)}</p>
+    <button aria-label={t("counter.label")}>{t("counter.increment")}</button>
+  </div>
+);
+```
+
+Sayfa seviyesinde `i18n.getFixedT(locale, "about")` çağrılmalı ve `t` ile `locale` bileşene prop olarak aktarılmalıdır.
+
+**Intlayer**
+
+```tsx fileName="src/components/ServerCounter.tsx"
+import { useIntlayer } from "next-intlayer/server";
+import { useNumber } from "next-intlayer/server/format";
+
+export const ServerCounter = ({ count }: { count: number }) => {
+  const { label, increment } = useIntlayer("counter");
+  const number = useNumber();
+
+  return (
+    <div>
+      <p>{number(count)}</p>
+      <button aria-label={label}>{increment}</button>
+    </div>
+  );
+};
+```
+
+## i18next API'sini Koruyarak Intlayer Performansına Erişin
+
+Yukarıdaki benchmark kazanımlarını elde etmek için bileşenlerinizi sıfırdan yeniden yazmak zorunda değilsiniz. `@intlayer/i18next`, `@intlayer/react-i18next` ve `@intlayer/next-i18next` uyumluluk adaptörleri tak-çalıştır niteliğindedir: `useTranslation`, `t()`, `<Trans>`, çoğullaştırmalar ve bağlam sonekleri Intlayer derleyicisi tarafından optimize edilen sözlükler üzerinden çalışmaya devam eder.
+
+```ts fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [reactI18nextVitePlugin()],
+});
+```
+
+Benchmark testinde, aynı Next.js uygulamasının uyumluluk derlemesi kodlara dokunulmadan sayfa başına **218.5 KB'tan 150.7 KB'a**, bileşen başına **78.5 KB'tan 9.7 KB'a**, sayfa sızıntısı **~%90'dan %0'a** gerilemiş ve hidrasyon süresi 15.6 ms'den 11.3 ms'ye düşmüştür. Mevcut `locales/{lng}/{ns}.json` dosyalarınız JSON senkronizasyon eklentisi sayesinde ana kaynak olarak kalabilir.
+
+Geçiş kılavuzlarına göz atın: [i18next](https://intlayer.org/tr/doc/migration/i18next), [react-i18next](https://intlayer.org/tr/doc/migration/react-i18next), [next-i18next](https://intlayer.org/tr/doc/migration/next-i18next).
+
+## Hangisini Ne Zaman Seçmeli?
+
+- **i18next'i seçin**: Geniş eklenti ekosistemine (özel algılayıcılar, arka uçlar, ICU, Locize) kesin olarak ihtiyacınız varsa, React dışı alanlarda da (Node servisleri, vanilla JS, diğer çatılar) yerelleştirme yapıyorsanız, ekibiniz bu araca zaten hakimse veya harici çeviri platformunuz `locales/{lng}/{ns}.json` biçimini zorunlu kılıyorsa. Ancak performans önemliyse ad alanlarını ve rota haritalarını yönetmek için zaman ayırmayı unutmayın.
+- **Intlayer'ı seçin**: **Bileşen düzeyinde içerik yönetimi**, **katı TypeScript desteği**, **derleme zamanı eksik anahtar hataları**, **sıfır çaba ile otomatik tree-shaking ve tembel yükleme**, anında dil değişimi, eşzamanlı sunucu bileşenleri ve yerleşik düzenleme araçları (Görsel Editör, CMS, yapay zeka destekli çeviri, MCP sunucusu) istiyorsanız. Modüler kod tabanları ve tasarım sistemleri için idealdir.
+- **`@intlayer/*-i18next` adaptörlerini seçin**: Halihazırda i18next kullanıyorsanız ve büyük bir yeniden yazım sürecine girmeden paket boyutunda ve tepki süresinde hemen kazanım sağlamak istiyorsanız.
+
+## İlgili Karşılaştırmalar
+
+- [next-intl vs Intlayer](https://intlayer.org/tr/blog/next-intl-vs-intlayer) (aynı benchmark)
+- [Lingui vs Intlayer](https://intlayer.org/tr/blog/lingui-vs-intlayer) (aynı benchmark)
+- [vue-i18n vs Intlayer Karşılaştırması](https://intlayer.org/tr/blog/vue-i18n-vs-intlayer-benchmark) (aynı benchmark)
+- [next-i18next vs next-intl vs Intlayer](https://intlayer.org/tr/blog/next-i18next-vs-next-intl-vs-intlayer)
+- [react-i18next vs react-intl vs Intlayer](https://intlayer.org/tr/blog/react-i18next-vs-react-intl-vs-intlayer)
+- [i18next modası geçti mi?](https://intlayer.org/tr/blog/is-i18next-outdated)
+
+## GitHub Yıldızları
+
+GitHub yıldızları bir projenin popülerliğini, topluluk güvenini ve uzun vadeli sürdürülebilirliğini yansıtır. Tek başına teknik kaliteyi kanıtlamasa da, kaç geliştiricinin projeyi faydalı bulduğunu ve benimsediğini gösterir.
+
+[![Yıldız Geçmiş Grafiği](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
+
+## Sonuç
+
+`i18next` hak ettiği konuma sahiptir: Her ortamda çalışır, her senaryo için bir eklentisi vardır ve 10 yılı aşkın süredir geliştirilmektedir. Ancak bu benchmark, çalışma zamanı odaklı mimarinin getirdiği maliyeti açıkça göstermektedir. Standart yapılandırma **sayfa başına +70-77 KB gzip** ek yük getirmekte, **diğer sayfalara ait içeriğin ~%90'ını sızdırmakta** ve dil değişimi **100 ms'nin üzerinde** sürmektedir. Sızıntıyı sıfıra indirmek mümkündür ancak bu da karmaşık bir manuel takip gerektirir ve yine de Intlayer'dan **9-22 KB daha ağırdır**.
+
+Intlayer bu iş yükünü derleyiciye devreder. Bileşen başına sözlükler, dil başına tembel yükleme ve gereksiz metinlerin ayıklanması derlemenin otomatik sonuçlarıdır. Aynı uygulamada: **Sayfa başına yalnızca +0.3 KB**, **%0 sızıntı**, **3 ila 10 kat daha küçük bileşenler** ve **3-4 ms içinde dil değişimi**.
+
+Tüm ham veriler, test uygulamaları ve otomasyon komutları [Benchmark Bloom deposunda](https://github.com/intlayer-org/benchmark-bloom) herkese açıktır. Kendiniz test edebilirsiniz.
+
+Daha fazla bilgi için ['Neden Intlayer?' dokümanını](https://intlayer.org/tr/doc/why) inceleyin.

package/blog/tr/is_i18next_outdated.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-09-02
-updatedAt: 2026-09-02
+updatedAt: 2026-09-16
 title: i18next 2026'da Güncelliğini Yitirdi mi?
 description: i18next milyonlarca web sitesine güç veriyor, ancak 2011 yapımı çalışma zamanı mimarisi eskimeye başladı. Paket boyutu, tree-shaking sınırları ve duraksayan inovasyon üzerine bir inceleme.
 keywords:
@@ -70,7 +70,7 @@ Son on iki ayın geliştirme performansı:
 | `i18next` core  | 2.626         | **259**   | Küçük güncellemeler                          |
 | Intlayer        | 7.156         | **4.343** | Derleyici, IDE araçları ve yapay zeka motoru |
 
-[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
 
 Küçük bir kütüphane kararlı olabilir. Ancak i18n araçları yerinde saymadı: modern paketleyiciler kullanılmayan çevirileri derleme anında temizliyor, LLM'ler doğrudan CI süreçlerinde çeviri yapıyor ve editörler özel Language Server (LSP) ile yapay zeka ajanlarına dayanıyor. i18next'in çalışma zamanı modeli bu ilerlemelere ayak uydurmakta zorlanıyor.
 
@@ -125,6 +125,10 @@ Next.js'te `next-i18next`, temel projeye kıyasla **76.7 KB gzipped** ek yük ge
 
 Varsayılan ayarlarda, bir rotaya iletilen **çevirilerin %90'a yakını** diğer sayfalara aittir. Manuel ad alanı bölme zahmetlidir ve gözden kaçan eksikliklere gebedir.
 
+Aşağıdaki grafik, sayfa başına yaklaşık 30 KB metin içeren, 1 ila 10 sayfadan oluşan ve 1 ila 10 dile çevrilmiş teorik bir uygulamanın içerik yükünü tahmin eder. İçeriği locale bazında dinamik yüklemek dil eksenini ortadan kaldırır, içeriği bileşen veya rota bazında sınırlamak sayfa eksenini ortadan kaldırır ve yalnızca ikisinin birleşimi yükü sabit tutar.
+
+![Mimariye göre teorik içerik sızıntısı](https://github.com/aymericzip/intlayer/blob/main/docs/assets/theorical_content_leakage.webp?raw=true)
+
 **Hidrasyon gecikmesi:**
 
 `react-i18next` bileşenlerinin hidrasyonu **85 ms** sürerken, Intlayer'da bu süre **24 ms** olarak ölçülmüştür. İstemci bileşenlerine devasa JSON ağaçları göndermek ilk etkileşim süresini yavaşlatır.

package/blog/tr/is_next-intl_outdated.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-09-02
-updatedAt: 2026-09-02
+updatedAt: 2026-09-16
 title: next-intl 2026'da Güncelliğini Yitirdi mi?
 description: next-intl, Next.js App Router için varsayılan çözüm haline geldi. Ancak arka planda çalışma zamanı paket şişkinliği ve manuel ad alanı yükü taşımayı sürdürüyor.
 keywords:
@@ -66,7 +66,7 @@ Geçtiğimiz 12 ayın özeti:
 - `amannn/next-intl`: **187 commit** (çoğunlukla sürüm geçişleri ve küçük yamalar).
 - `aymericzip/intlayer`: **4.343 commit** (derleyiciler, IDE eklentileri, MCP sunucuları ve çeviri araçları üzerinde kesintisiz geliştirme).
 
-[![Star History Chart](https://api.star-history.com/chart?repos=amannn%2Fnext-intl%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#amannn/next-intl&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=amannn%2Fnext-intl%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#amannn/next-intl&aymericzip/intlayer)
 
 Kararlı bir kütüphane güven verir. Fakat i18n dünyası evrildi: derleyiciler çağrılmayan çevirileri build aşamasında atıyor, LLM'ler CI süreçlerinde otomatik çeviri sağlıyor ve editörler özel LSP ile yapay zeka asistanlarından yararlanıyor. Sadece runtime'a bağlı bir kütüphanenin bu dönüşüme uyum sağlaması zordur.
 
@@ -127,6 +127,10 @@ export default async function RootLayout({ children, params }) {
 
 Bunu önlemek için JSON dosyalarını ad alanlarına ayırmak mümkündür. Ancak bu eşleştirmeleri elle yönetmek zahmetlidir ve gözden kaçan eksikliklere yol açar.
 
+Aşağıdaki grafik, sayfa başına yaklaşık 30 KB metin içeren, 1 ila 10 sayfadan oluşan ve 1 ila 10 dile çevrilmiş teorik bir uygulamanın içerik yükünü tahmin eder. İçeriği locale bazında dinamik yüklemek dil eksenini ortadan kaldırır, içeriği bileşen veya rota bazında sınırlamak sayfa eksenini ortadan kaldırır ve yalnızca ikisinin birleşimi yükü sabit tutar.
+
+![Mimariye göre teorik içerik sızıntısı](https://github.com/aymericzip/intlayer/blob/main/docs/assets/theorical_content_leakage.webp?raw=true)
+
 Intlayer bunu statik analiz ile çözer: [Intlayer derleyicisi](https://intlayer.org/tr/doc/compiler) sadece o rotada çağrılan metinleri paketler, rotalar arası sızıntıyı **%0.0'a** indirir.
 
 ## next-intl Neden Tree-Shaking'e İzin Vermez?

package/blog/tr/is_vue-i18n_outdated.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-09-02
-updatedAt: 2026-09-02
+updatedAt: 2026-09-16
 title: vue-i18n 2026'da Güncelliğini Yitirdi mi?
 description: vue-i18n on yıl boyunca Vue ve Nuxt uygulamalarının standardı oldu. Fakat benchmarklarımızda web üzerindeki en ağır i18n çalışma zamanı çıktı. İşte nedenleri.
 keywords:
@@ -64,7 +64,7 @@ Son on iki ay:
 - `intlify/vue-i18n`: **259 commit** (Vue 3 ve Nuxt için periyodik bakım).
 - `aymericzip/intlayer`: **4.343 commit** (derleyici optimizasyonları, LSP araçları ve yapay zeka entegrasyonları).
 
-[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://star-history.com/#intlify/vue-i18n&aymericzip/intlayer)
 
 Köklü bir kütüphane istikrar sağlar. Fakat günümüz web mimarisi derleme anında AST dönüşümleri, ölü kod temizliği ve yapay zeka destekli yerelleştirme kullanır. Yalnızca çalışma zamanında çalışan bir sistemin bu yenilikleri benimsemesi zordur.
 
@@ -116,6 +116,12 @@ Varsayılan ayarlarda bir rotaya gönderilen **çevirilerin %90'ı** diğer sayf
 
 Yerel kapsamda derlenen bileşenler, sözlüklerin tekrar etmesi sebebiyle `vue-i18n` ile ortalama 196 KB tutarken, Intlayer'da bu değer **6.5 KB** olmuştur.
 
+**Sızıntı nasıl ölçeklenir:**
+
+Aşağıdaki grafik, sayfa başına yaklaşık 30 KB metin içeren, 1 ila 10 sayfadan oluşan ve 1 ila 10 dile çevrilmiş teorik bir uygulamanın içerik yükünü tahmin eder. İçeriği locale bazında dinamik yüklemek dil eksenini ortadan kaldırır, içeriği bileşen veya rota bazında sınırlamak sayfa eksenini ortadan kaldırır ve yalnızca ikisinin birleşimi yükü sabit tutar.
+
+![Mimariye göre teorik içerik sızıntısı](https://github.com/aymericzip/intlayer/blob/main/docs/assets/theorical_content_leakage.webp?raw=true)
+
 ## vue-i18n Neden Ağır?
 
 ### Tarayıcıya Taşınan AST Derleyicisi