Yazar:
    Aymeric PINEAU
    Oluşturma:2026-09-02Son güncelleme:2026-09-02

    next-intl 2026'da Güncelliğini Yitirdi mi?

    Vercel, App Router yapısını tanıtıp Pages Router'daki yerleşik i18n desteğini sonlandırdığında, next-intl bu boşluğu hızla doldurdu. Jan Amann'ın hazırladığı anlaşılır dokümantasyon ve zamanında sağlanan App Router desteği, kütüphaneyi topluluğun bir numaralı tercihi yaptı.

    Öyleyse bugün neden güncelliği tartışılıyor?

    Web mimarisi son üç yılda köklü bir değişim geçirdi, ancak next-intl'in temel yaklaşımı aynı kaldı.

    Next.js; React Server Components (RSC), akış (streaming) ve derleyici düzeyinde optimizasyonlara odaklanırken, next-intl yerelleştirmeyi halen bir çalışma zamanı meselesi olarak görüyor: istemci sağlayıcılarına büyük JSON nesneleri geçiyor, tarayıcıda ICU formatlayıcıları çalıştırıyor ve paket büyümesini önlemek için manuel ad alanı ayrımına güveniyor.

    Öne Çıkanlar

    Geliştirme temposunda yavaşlama:

    Son 12 ayda next-intl ~187 commit kaydetti, bu çalışmaların neredeyse tamamı Next.js sürümleriyle uyumluluk ve hata düzeltmeleri üzerine yoğunlaştı.

    İstemci çalışma zamanı yükü:

    NextIntlClientProvider bileşenini useTranslations() ile bağlamak, tek bir kelime görüntülemeden önce ~12.8 KB gzipped (51 KB minified) kod ekler, bu da next-intlayer'ın (4.3 KB) yaklaşık 3 katıdır.

    %90 oranında içerik sızıntısı:

    Yaygın kurulumlarda, bir sayfaya aktarılan çevirilerin %89.8'i diğer sayfalara aittir. Kullanıcı /contact sayfasına girdiğinde /pricing ve yönetim paneli metinlerini de indirmek zorunda kalır.

    Manuel ad alanı yönetimi:

    Paket şişkinliğini önlemek için ad alanlarını rota rota elle bölmek gerekir, bu da üretim ortamında eksik metin riskini artırır.

    Ticari ortaklık:

    Crowdin'in resmi ortağı olan bir kütüphanenin, CLI içine yerel ve ücretsiz bir yapay zeka çeviri komutu geliştirmesi için ticari bir gerekçesi yoktur.

    Bakım vs. Modern Araçlar

    Son 12 aydaki commit hareketliliği:

    Depo Yıldızlar Toplam commit Yıllık commit Son commit
    amannn/next-intl stars commits yearly last
    aymericzip/intlayer stars commits yearly last

    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

    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.

    Next.js 16 App Router Performans Testi

    10 rota ve 10 dil içeren tipik bir App Router uygulamasında ölçüm yapılmıştır:

    Dinamik JSON yükleme

    Çevirileri çalışma zamanında geç yükler

    Kapsamlı JSON (ad alanı oluşturma)

    Sayfa başına çeviri ad alanları

    I18n Performans Karşılaştırması

    Bu metrik nedir?

    Uluslararasılaştırma kitaplığı paketinin toplam gzip sıkıştırılmış boyutu. Sadece ağaç sallama (tree-shaking) ve küçültme (minification) sonrası sağlayıcı ve içerik getirme mantığını içerir.

    Neden önemlidir?

    Daha küçük bir kitaplık boyutu, başlangıç JavaScript yükünü azaltarak istemci tarafında daha hızlı indirme ve yürütme sürelerine yol açar.

    Olarak gör

    Gerçek tarayıcı ortamlarında gzip sıkıştırmasıyla test edilmiştir. Tüm detaylar Next.js benchmark raporunda.

    Kütüphane Ayak İzi

    Çeviri metinleri eklenmeden önceki istemci yükü:

    Kütüphane Gzipped Minified
    next-intl@4.9.1 12.8 KB 51.0 KB
    next-intlayer@8.7.12 4.3 KB 13.3 KB

    Sayfa Ağırlığı ve Veri Sızıntısı

    Kurulum Ort. sayfa JS (gz) Dil sızıntısı Diğer sayfa sızıntısı Ort. bileşen (gz)
    Temel (i18n yok) 150.8 KB 0.0% 0.0% 0.7 KB
    next-intl (statik) 163.5 KB 4.2% 89.8% 20.5 KB
    next-intl (dinamik) 163.4 KB 9.7% 89.9% 20.5 KB
    next-intlayer 152.1 KB 0.0% 0.0% 7.2 KB

    Rotalar Arası Veri Sızıntısı Neden Olur?

    Klasik next-intl projelerinde kök layout tüm sözlüğü tek seferde çeker:

    app/[locale]/layout.tsx
    export default async function RootLayout({ children, params }) {
  const messages = await getMessages();

  return (
    <html>
      <body>
        <NextIntlClientProvider messages={messages}>
          {children}
        </NextIntlClientProvider>
      </body>
    </html>
  );
}

    messages kök düzeyinde istemci sağlayıcısına teslim edildiğinde, tarayıcı her sayfada tüm kelime havuzunu edinir. /login sayfasına giren bir ziyaretçi yardım, rehber ve gösterge paneli içeriklerini de birlikte indirir.

    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.

    Intlayer bunu statik analiz ile çözer: Intlayer derleyicisi 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?

    Kütüphanenin arayüzü çalışma zamanında çözülen dinamik dize anahtarlarına dayanır:

    UserProfile.tsx
    "use client";

import { useTranslations } from "next-intl";

export function UserProfile() {
  const t = useTranslations("UserProfile");

  return <h2>{t("heading")}</h2>;
}
    UserProfile.tsx
    "use client";

import { useIntlayer } from "next-intlayer";

export function UserProfile() {
  const { heading } = useIntlayer("user-profile");

  return <h2>{heading}</h2>;
}

    Turbopack ve Webpack, UserProfile içinde hangi anahtarların çağrılacağını bilemez. Çalışma anında hata oluşmaması için paketleyici tüm ad alanını istemci paketine dahil eder. Intlayer'ın parçalanmış özellikleri sayesinde derleyici erişilen alanları analiz eder ve gereksiz metinleri ayıklar. Detaylar için paket optimizasyonu konusuna göz atın.

    Geliştirici Deneyimi

    Ayrı JSON Klasörleri vs. Birlikte Konumlandırma

    next-intl ile metinler messages/ dizininde koddan uzakta durur. Intlayer ise içerik tanımlarını doğrudan bileşenlerin yanına koyar:

    messages/en.json
    {
  "authModal": {
    "title": "Sign in to your account",
    "submitButton": "Continue"
  }
}
    messages/tr.json
    {
  "authModal": {
    "title": "Hesabınıza giriş yapın",
    "submitButton": "Devam Et"
  }
}
    AuthModal.tsx
    import { useTranslations } from "next-intl";

export const AuthModal = () => {
  const t = useTranslations("authModal");
  return (
    <form>
      <h2>{t("title")}</h2>
      <button type="submit">{t("submitButton")}</button>
    </form>
  );
};
    AuthModal.content.ts
    import { t, type Dictionary } from "intlayer";

export default {
  key: "auth-modal",
  content: {
    title: t({
      en: "Sign in to your account",
      tr: "Hesabınıza giriş yapın",
    }),
    submitButton: t({
      en: "Continue",
      tr: "Devam Et",
    }),
  },
} satisfies Dictionary;
    AuthModal.tsx
    import { useIntlayer } from "next-intlayer";

export const AuthModal = () => {
  const { title, submitButton } = useIntlayer("auth-modal");
  return (
    <form>
      <h2>{title}</h2>
      <button type="submit">{submitButton}</button>
    </form>
  );
};

    AuthModal.tsx bileşenini taşıdığınızda veya sildiğinizde, çevirileri de birlikte taşınır ya da silinir.

    Otomatik Tamamlama vs. Kesin Tip Denetimi

    next-intl içinde IntlMessages arayüzünü genişletmek ana dile göre otomatik tamamlama sunar:

    global.d.ts
    import en from "./messages/en.json";

type Messages = typeof en;

declare global {
  interface IntlMessages extends Messages {}
}

    Ancak yalnızca temel dil doğrulanır. tr.json içinden bir anahtar silindiğinde TypeScript hata vermez, CI başarılı görünür ve kullanıcılar boş metinlerle karşılaşır.

    Intlayer, tipleri tüm bildirimlerden çıkarır. strictMode modu etkinleştirildiğinde herhangi bir dildeki eksik çeviri derleme hatası oluşturur.

    Araç Ekosistemi ve Yapay Zeka

    Özellik next-intl Intlayer
    VS Code Eklentisi ❌ Yok ✅ Resmi eklenti
    Language Server (LSP) ❌ Yok ✅ Özel LSP
    MCP Sunucusu (AI İçin) ❌ Yok ✅ Entegre MCP sunucusu
    Ajan Becerileri (Skills) ❌ Yok ✅ Kullanıma hazır beceriler
    Görsel CMS ❌ Yok ✅ Ücretsiz ve Açık Kaynak

    Entegre LSP ve MCP sunucuları sayesinde yapay zeka kodlama asistanları projenin içerik yapısını eksiksiz algılar ve çevirileri hatasız biçimde tamamlar.

    Crowdin Ortaklığı

    next-intl resmi olarak Crowdin ile ortaklık yürütmektedir. Sponsorluklar açık kaynağı destekler ancak yol haritasını da şekillendirir: harici TMS platformlarına istemci olacak şekilde kurgulanan next-intl, CLI içine yerel ve ücretsiz bir yapay zeka çeviri komutu entegre etmeye odaklanmaz.

    Intlayer bu araçları standart olarak sunar:

    Yerel Yapay Zeka Doldurma (intlayer fill):

    Eksik çevirileri OpenAI, Anthropic, Mistral veya Gemini API anahtarlarınızla otomatik tamamlar.

    Kendi Sunucunuzda Barındırılabilir Görsel CMS:

    Teknik olmayan ekiplerin Git ile entegre biçimde metin düzenlemesi için Intlayer CMS kullanın.

    Özgür Açık Kaynak Lisansı:

    Tüm araçlar Apache 2.0 lisansı altındadır.

    next-intl Hangi Durumlarda Halen Tercih Edilebilir?

    Uygulamanız iç içe geçmiş çoğul kurallarına ve gelişmiş sıralama biçimlendiricilerine dayanıyorsa, next-intl olgun bir ICU desteğine sahiptir.

    Hali hazırda çeviri operasyonunu Crowdin üzerinde yürüten ekipler için next-intl entegrasyonu oldukça kolaydır.

    Mevcut projeniz ihtiyaçlarınızı karşılıyor ve paket boyutu sizin için bir sorun teşkil etmiyorsa, geçiş zorunlu değildir.

    Mevcut next-intl Yapılandırmamı Nasıl Geliştirebilirim?

    Intlayer, next-intl kütüphanesinin fonksiyon ve kanca (hook) imzalarını (useTranslations, getTranslations ve yönlendirme yardımcıları) birebir koruyan doğrudan uyumluluk paketleri sunar. Derleyici seviyesindeki optimizasyonlardan yararlanmak için bileşenlerinizi sıfırdan yazmanıza gerek yoktur.

    Kurulum tek bir komutla tamamlanır:

    bash
    npx intlayer init --interactive

    Bu etkileşimli CLI aracı:

    1. @intlayer/next-intl uyumluluk paketini yükler.
    2. Paketleyici takma adlarını (alias) yapılandırarak mevcut import'larınızın (next-intl, next-intl/server) doğrudan Intlayer'a yönlendirilmesini sağlar; böylece eski kütüphaneyi package.json dosyasından kaldırabilirsiniz.
    3. Editörde Dil Sunucusu (LSP) teşhislerini anında açar, sayfalar arası çeviri sızıntılarını ortadan kaldırır (tam tree-shaking) ve büyük bir yeniden yapılandırma gerektirmeden yerel yapay zeka çeviri iş akışlarını etkinleştirir.

    Ayrıntılı adımlar için hazırladığımız kılavuzları inceleyin:

    Sitenizin boyutunu ve sızıntılarını ücretsiz i18n SEO Tarayıcısı ile inceleyin:

    Ek Kaynaklar

    react-i18next vs react-intl vs Intlayeri18next güncelliğini yitirdi mi?

    Yorumlar

    Henüz yorum yok. Düşüncelerinizi paylaşan ilk kişi olun.

    İlgili Gönderiler

    SvelteKit i18n: routing, SSR, and shared state

    SvelteKit ships no i18n. How to wire locale routing with an optional param or the reroute hook, and why a module-level locale store leaks between SSR requests.

    Aymeric PINEAU

    SEO ve Uluslararasılaştırma

    Çok dilli web sitenizi arama motorları için optimize etmeyi ve SEO'nuzu iyileştirmeyi öğrenin.

    Aymeric PINEAU

    Best Internationalization (i18n) Tools for Svelte - Eksiksiz çeviri rehberi: Best Svelte i18n Libraries 2026 — Compared by DX & Bundle

    Bundle boyutu, SEO, performans ve sürdürülebilirlik için en iyi çözüm. Svelte uygulamayı'ınızı 2026'da çok dilli yapın, LLM çevirisi, Agent Skills & MCP.

    Aymeric PINEAU

    Bileşen-Başına vs Merkezileştirilmiş i18n: Intlayer ile Yeni Bir Yaklaşım

    React'te uluslararasılaştırma stratejilerine derinlemesine bir bakış; merkezi, per-key (anahtar-başına) ve bileşen-başına yaklaşımları karşılaştırır ve Intlayer'ı tanıtır.

    Aymeric PINEAU

    Son Gönderiler

    i18next 2026'da Güncelliğini Yitirdi mi?

    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.

    Aymeric PINEAU

    vue-i18n 2026'da Güncelliğini Yitirdi mi?

    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.

    Aymeric PINEAU

    Next.js i18n - what the App Router makes you build

    The App Router dropped built-in i18n routing. What you now write yourself, why Server and Client Components split the problem, and how libraries compare.

    Aymeric PINEAU

    React Router i18n - locale routes that get indexed

    How to add locale-prefixed routes in React Router v7, why the answer differs between framework mode and SPA mode, and how to avoid hydration mismatches.

    Aymeric PINEAU