Bugün Cursor'dan ya da Claude Code'dan bir Next.js uygulamasına i18n eklemesini istersen büyük olasılıkla middleware.ts, her layout'ta setRequestLocale ve useTranslations çağrısını bir async sayfasında görürsün. Bu kurulum Next.js 15 için doğruydu, Next.js 16'da ise bir nesil eskimiş durumda. globalize.now yapay zekâ destekli yerelleştirme altyapısı olduğu için bu katmanı yakından izliyoruz: yönlendirme bağlantıları değişti, sunduğu katalog değişmedi. Aşağıda neyin taşındığını, üretilen kodunun hangi döneme ait olduğunu nasıl anlayacağını ve yeniden yazım yerine bir öğleden sonrada biten üç düzeltmeyi bulacaksın.
Hiçbiri kırıcı değişiklik değil. Gözden kaçması kolay olmasının sebebi de tam bu.
Next.js 16'da i18n için ne değişti?
Locale'i belirleyen dosyanın adı değişti. Next.js, middleware dosya kuralını kullanımdan kalkmış ve v16.0.0 ile birlikte proxy olarak yeniden adlandırılmış diye belgeliyor; gerekçesi de terminolojiyle ilgili: “middleware” sürekli Express middleware'i diye okunduğu için özellik, aslında olduğu şeyi, yani ağ sınırını anlatacak şekilde yeniden adlandırıldı.
v16'daki yeniden adlandırmayla iki davranış notu da geliyor. Proxy varsayılan olarak Node.js runtime'ında çalışır ve dosya başına runtime yapılandırma seçeneği orada artık yok: ayarlarsan Next.js hata verir. Proxy ayrıca statik export'ta desteklenmez; locale belirlemek, export almamanın tek sebebiyse bu önem kazanır.
Özellikle dil yönlendirmesi için next-intl kurulum rehberi artık dosyayı src/proxy.ts olarak gösteriyor ve Next.js 16'ya kadar middleware.ts diye adlandırıldığını açıkça belirtiyor. İçindeki import değişmedi:
// src/proxy.ts
import createMiddleware from 'next-intl/middleware';
import {routing} from './i18n/routing';
export default createMiddleware(routing);
export const config = {
matcher: '/((?!api|trpc|_next|_vercel|.*\\..*).*)'
};
Asimetriye dikkat et, çünkü insanları şaşırtıyor: dosya artık proxy.ts, import yolu ise hâlâ next-intl/middleware. Import'u da yeniden adlandırmak sık yapılan bir aşırı düzeltme.
Yapay zekâyla üretilen i18n kodu neden bir sürüm geride çıkıyor?
Çünkü kodlama agent'ı en çok temsil edilen deseni tahmin eder, en çok temsil edilen desen de yıllarca birikmiş olandır. 2026 sonundan önce App Router dil yönlendirmesi hakkında yazılmış her blog yazısı, Stack Overflow yanıtı ve GitHub örneği middleware.ts der. Bu külliyatı birkaç haftalık v16 dokümanıyla tartan bir model, bir yeniden adlandırma olduğuna dair hiçbir uyarı vermeden, kendinden emin biçimde eski yapıya uzanır.
Bu, daha önce yazdığımız bir sorunun da arkasındaki mekanizma: Cursor, i18n kurulumundan sonra koda gömülü metin eklemeye devam eder. Agent senin kod tabanını değil, istatistiksel olarak en yaygın kod tabanını yeniden üretir. GitHub Copilot'ta talimat dosyalarının sorunu yalnızca kısmen çözmesinin nedeni de bu: sohbet yüzeyinin okuduğu kuralları satır içi tamamlama okumayabilir.
Pratik sonuç dar ama gerçek. Üretilen kurulumun çalışıyor, yani hiçbir şey gürültüyle patlamıyor. Sonra bir hata yakalıyorsun, arıyorsun ve güncel her yanıt, sende olmayan dosyaları anlatıyor.
Üretilen kurulumum hangi döneme ait, nasıl anlarım?
Dört grep. Proje kökünden çalıştır, yaklaşık bir dakikada öğrenirsin.
# 1. Pre-16 locale negotiation file
ls middleware.ts src/middleware.ts 2>/dev/null
# 2. Legacy static-rendering API
grep -rn "setRequestLocale" app src 2>/dev/null
# 3. Hooks called inside async components
grep -rn -B3 "useTranslations" app | grep -n "async function"
# 4. Which next-intl era the config reads from
grep -rn "root-params\|await params" src/i18n/request.ts 2>/dev/null
1 ve 2'de sonuç çıkması 16 öncesi iskelet demek. 3'te sonuç çıkması, o bileşeni render eden ilk isteği bekleyen gerçek bir çalışma zamanı hatası demek. 4'te sonuç çıkmaması, request config'inin dili eski yoldan okuduğu anlamına gelir.
middleware.ts dosyasını proxy.ts olarak yeniden adlandırmak zorunda mıyım?
Acil değil ve elle yapma. Next.js hem dosyayı hem dışa aktarılan fonksiyonu yeniden adlandıran bir codemod sunuyor:
npx @next/codemod@canary middleware-to-proxy .
Yeniden adlandırma bir kullanımdan kaldırma, silme değil, o yüzden mevcut middleware.ts çalışmaya devam eder. Yine de çalıştırmanın sebebi bakım maliyeti: dosya adların güncel dokümanla eşleşirse bundan sonraki her arama sonucu deponda geçerli olur. Eski bırakırsan her hata ayıklama oturumunda küçük bir vergi ödersin, sonsuza dek.
setRequestLocale next-intl'de kullanımdan mı kaldırıldı?
Legacy olarak işaretli. Bu, “deprecated”dan daha yumuşak bir iddia ve dikkatli okunmaya değer. next-intl dokümanı setRequestLocale için, next/root-params gelene kadar var olan bir API olduğunu söylüyor. Geriye dönük uyumluluk için desteklenmeye devam ettiğini belirtiyor ve bunun yerine next/root-params öneriyor.
Yeni yapı, eşleşen dili her layout ve sayfadan elle geçirmek yerine request config'in içinde okur:
// src/i18n/request.ts
import * as rootParams from 'next/root-params';
import {notFound} from 'next/navigation';
import {getRequestConfig} from 'next-intl/server';
import {hasLocale} from 'next-intl';
import {routing} from './routing';
export default getRequestConfig(async ({locale}) => {
if (!locale) {
const paramValue = await rootParams.locale();
if (hasLocale(routing.locales, paramValue)) {
locale = paramValue;
} else {
notFound();
}
}
return {locale};
});
next/root-params Next.js 16.3 ve sonrasında varsayılan olarak açık. Daha eski sürümlerde experimental.rootParams ile açılması gerekir. Kurulumu bu şekilde yaparsan, [locale] segmenti için generateStaticParams export etmeye devam ettiğin sürece statik render bedavaya gelir.
Eski yaklaşım, statik render etmek istediğin her sayfa ve layout'ta, başka herhangi bir next-intl çağrısından önce setRequestLocale çağırmayı gerektiriyordu, çünkü Next.js layout'ları ve sayfaları birbirinden bağımsız render eder. Bir AI agent'ın yazdığı beşinci dosyada unutacağı türden bir kural bu. Gereksinimi silmek, bu hata sınıfını da siler.
useTranslations neden async Server Component'imde çöküyor?
Çünkü hook'lar async bileşenlerden çağrılamaz ve useTranslations bir hook'tur. Bu, next-intl'in bir tuhaflığı değil, React Server Components kısıtı. next-intl'in cevabı da paralel bir await edilebilir fonksiyon seti:
// Async component: await the server API
import {getTranslations} from 'next-intl/server';
export default async function ProfilePage() {
const user = await fetchUser();
const t = await getTranslations('ProfilePage');
return <h1>{t('title', {username: user.name})}</h1>;
}
// Non-async component: the hook is correct here
import {useTranslations} from 'next-intl';
export default function UserDetails({user}) {
const t = useTranslations('UserProfile');
return <h2>{t('title')}</h2>;
}
getFormatter, getNow, getTimeZone, getMessages ve getLocale aynı kalıbı izler. İkinci örnek üzerinde durmaya değer: async olmayan ve etkileşimli özelliği bulunmayan bir bileşen paylaşılan bileşendir; next-intl, sunucuda mı istemcide mi render edildiğine göre doğru uygulamayı seçer. Yani bir Server Component'te useTranslations kullanmak hata değil, hata onu async bir bileşenden çağırmak.
NextIntlClientProvider context hatasını neden alıyorum?
next-intl'in sorun giderme notları iki neden sayıyor ve ikisinin çözümü birbirinin tersi. Ya bileşen gerçekten client'ta çalışıyor ve üstünde provider yok: o zaman bileşeni provider ile sarmala ve ihtiyaç duyduğu mesajları geçir. Ya da sen server rendering beklerken bileşen client modül grafiğine kaymış: o zaman bileşeni bir Server Component içinde import etmek yerine children üzerinden Server Component'tan geçir.
İkinci durum, AI üretimi uygulamaların takıldığı durum. Çünkü agent'lar etkileşimi çalıştırmak için 'use client' direktifini bol bol kullanır ve direktif import grafiğinde aşağı doğru bulaşır. Tercih edilen kalıp, çeviriyi sunucuda yapıp hazır metinleri sınırın karşısına geçirmek:
import {useTranslations} from 'next-intl';
import Expandable from './Expandable'; // 'use client'
export default function FAQEntry() {
const t = useTranslations('FAQEntry');
return <Expandable title={t('title')}>{t('description')}</Expandable>;
}
Bir bileşenin istemcide gerçekten mesajlara ihtiyacı varsa, tüm mesajları tarayıcıya göndermek yerine yalnızca o alt ağaç için bir provider tanımlayabilirsin: kök provider'daki messages={null} hiç mesaj geçirmez.
Bunların hiçbiri neyi değiştirmez?
Dil dosyalarını değiştirmez. Yukarıdaki her çözüm routing ve rendering bağlantısıyla ilgili; uygulamanın yüklediği JSON bunların hiçbirinden etkilenmez. Akılda kalması gereken nokta da bu: bağlantı işi bir öğleden sonraya sığar ve yılda bir değişir, katalog ise yeni arayüz çıktıkça her hafta çürür.
Bizim kurduğumuz ayrım bu. next-intl ve benzerleri çevirileri çalışma zamanında sunar: onlarla rekabet etmiyoruz, aralarında seçim yapıyorsan next-intl, react-i18next ve Lingui karşılaştırması artı ve eksileri sıralıyor. globalize.now bir üst katmanda durur, bu kütüphanelerin okuduğu anahtarları ve dil dosyalarını üretir. Next.js entegrasyonunun locale belirlemenin middleware.ts içinde mi proxy.ts içinde mi olduğuna aldırmamasının sebebi de bu.
Dönüşüm tek seferliktir ve uygulama içinde yapılır: deponu bağlarsın, globalize.now kod tabanını bir kez dönüştürür ve kataloğu içeren bir PR açar. Sonrasında push işleri, yeni katalog birimleri ortaya çıktıkça çevirir. Çeviri dosyaları neden senkrondan çıkar yazısında anlatılan hata modu tam olarak bu; bu açığı üçüncü dilden önce kapatmaya değmesinin nedeni de bu.
Projende elle yazılmış bir next-intl kurulumu varsa nelere dokunup nelere dokunmadığımızı tam olarak yazdık. Yoksa Cursor rehberi en kısa yol; tek not, ürettiği dosyanın eski adlandırma kuralına göre adlandırılmış olması, bu yüzden sonrasında codemod'u çalıştır.
Nereden başlamalı?
Dört grep'i çalıştır. İlk ikisinde sonuç çıkarsa codemod'u çalıştır, request config'ini next/root-params altına taşı; böylece güncel olursun. Sonra dil dosyalarına bak, çünkü gelecek ay da kaymaya devam edecek kısım orası. AI ile yazılmış bir uygulama yayına alıyorsan ve kataloğu elle sürdürmek yerine yönetilmesini istiyorsan, genel bakış vibe coder sayfasında, fiyatlar ise kendi sayfası olan fiyatlandırmada.
globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.
globalize.now'ı ücretsiz dene