Next.js uygulaman çevrilmiş ama tarayıcı sekmesi, 404 sayfası, form hataları ve link önizlemesi hâlâ İngilizce ise neden neredeyse her zaman aynı: bu metinler bir bileşenin dışında üretiliyor, yani useTranslations çağrısı onlara hiç dokunmadı. globalize.now AI destekli yerelleştirme altyapısıdır ve bir AI agent bir App Router projesine i18n eklediğinde en sık yarım kalan katman bu: görünen sayfa dönüştürülmüş, yüzeyin geri kalanı değil.

Aşağıda bu metinlerin her birinin nerede yaşadığı ve onu çözen next-intl çağrısı var. Her örnek, 2026-10-28 tarihinde alınan güncel next-intl dokümanlarını izliyor.

App Router uygulamasında çevrilmemiş metinler nerede saklanır?

Metin render eden React bileşeni olmayan altı yerde saklanırlar. Bileşenlerini tek tek gezerek i18n ekleyen bir coding agent görünen arayüzü dönüştürür ve bunların yanından geçip gider:

  1. generateMetadata içindeki sayfa başlıkları ve açıklamaları.
  2. Server Action'lardaki doğrulama hataları ve sonuç mesajları.
  3. not-found.tsx, yani 404 sayfası.
  4. error.tsx, yani çalışma zamanı hata sayfası.
  5. opengraph-image.tsx, manifest.ts ve sitemap.ts gibi üretilen dosyalar.
  6. Metin döndüren Route Handler'lar.

Ortak nokta şu: hiçbiri [locale] layout ağacının içinde normal yoldan render edilmiyor, bu yüzden dilin onlara elle verilmesi ya da farklı okunması gerekiyor. Next.js 16 routing yazısı routing bağlantısını anlatıyor; bu yazı ise o bağlantının ulaşmadığı yerleri.

Sayfa başlıklarını ve açıklamalarını nasıl çevirirsin?

generateMetadata içinde next-intl/server üzerinden getTranslations çağır. Bu fonksiyon bir sayfadan ya da layout'tan export edilebilir ve async olduğu için await edilebilir API doğru seçim:

// app/[locale]/page.tsx
import {getTranslations} from 'next-intl/server';

export async function generateMetadata() {
  const t = await getTranslations('Metadata');
  return {title: t('title'), description: t('description')};
}

Tuzak statik form. Agent'lar daha kısa olduğu için sık sık export const metadata = {title: 'Dashboard'} yazar, oysa bir sabit çeviri fonksiyonunu çağıramaz. Bunu fonksiyon formuna çevir ve aynı anahtarları her dil için kataloğa ekle. Arama motorlarının gördüğü metin de bu, yani metadata'sını çevirmeden uygulamayı çevirmek sıralamaya pek katkı sağlamaz.

Server Action ve doğrulama mesajlarını nasıl çevirirsin?

Dili action'a geçir ve getTranslations'u hem bir namespace hem de o locale ile çağır. Server Action sayfanın hangi dilde olduğunu bilmez, bu yüzden next-intl dokümanları dili senin vermeni ister; örneğin argüman olarak:

'use server';
import {getTranslations} from 'next-intl/server';

export async function subscribe(locale: string, formData: FormData) {
  const t = await getTranslations({locale, namespace: 'Subscribe'});
  // ...validate, then return t('success') or t('invalidEmail')
}

Aynı dokümandan dikkat edilmesi gereken bir nokta: bir action'ın mesajı ekrandayken ziyaretçinin dil değiştirebildiği durumu düşün. URL'de [locale] segmenti varsa bu otomatik halledilir, çünkü route değişir. Yoksa mesajı kendin temizlemek isteyebilirsin; örneğin bileşene key={locale} verip state'ini sıfırlatarak.

Zod ile form doğrulamada belgelenen yöntem bir hata haritası. Zod her safeParse çağrısı için bir tane kabul eder ve harita getTranslations'ı çağırabilir. Bunu tek bir async yardımcıya koy ve sonucunu her parse'ta error seçeneği olarak geçir. Böylece şemaların İngilizce cümle değil kural içerir ve AI üretimi formlar Letonca bir sayfaya "Invalid email" basmayı bırakır.

404 ve hata sayfalarını nasıl çevirirsin?

not-found.tsx dosyasını app/[locale]/ içine koy, sonra gerçekten tetiklenmesi için bir catch-all ekle. Next.js bu dosyayı bir segment notFound() çağırdığında render eder; bilinmeyen bir URL bunu kendiliğinden çağırmaz:

// app/[locale]/[...rest]/page.tsx
import {notFound} from 'next/navigation';

export default function CatchAllPage() {
  notFound();
}

next-intl middleware'inin eşleştirmediği isteklerde hiçbir locale bilgisi bulunmaz, bu yüzden [locale] 404'ü bunlara hiçbir zaman uygulanmaz. Dokümanın cevabı app/global-not-found.tsx; Next.js bunu deneysel olarak belgeliyor ve kendi html ile body öğelerini render ediyor. Bilinmeyen bir [locale] değeri için doküman, genellikle i18n/request.ts içinde notFound() çağırmayı söylüyor.

error.tsx farklı. Next.js onun Client Component olmasını şart koşar ve layout'unun altında render edilir. Bu yüzden en azından Error namespace'ini taşıyan bir NextIntlClientProvider gerekir. Tüm kataloğu değil, yalnızca bu mesajları geçir:

// app/[locale]/layout.tsx (excerpt)
const messages = await getMessages();
// ...
<NextIntlClientProvider locale={locale} messages={pick(messages, 'Error')}>

Sonra useTranslations('Error'), error.tsx içinde çalışır. Sayfa global-error'yi kapsamaz, o dosya varsa elle kontrol et.

Paylaşım görselleri, manifest ve sitemap ne olacak?

Hepsi layout ağacının dışında yer aldığı için dilin onlara verilmesi gerekir. opengraph-image.tsx için locale'i params üzerinden oku ve getTranslations({locale, namespace})'ü çağır. Özelleştirilmiş bir localePrefix ile doküman, üretilen route'un erişilemez hale gelebileceği konusunda uyarıyor, çünkü Next.js proxy (middleware) rewrite'larını görmez. Çözüm, matcher'ın opengraph-image ile biten yolları atlamasını sağlamak.

app/manifest.ts, [locale] dışında durur, bu yüzden next-intl yoldan bir locale çıkaramaz. Temsilî bir tane seç, genellikle varsayılanı, ve açıkça geçir. sitemap.ts için alternates.languages girdileri ekle ve her URL'yi, navigasyon modülündeki async getPathname({locale, href}) ile host önekini ekleyerek oluştur. next-intl varsayılan olarak dil sürümlerini duyuran bir link response header'ı da gönderir. CMS kaynaklı slug'lar üzerinde kontrol gerektiğinde sitemap seçeneği devreye girer.

Route Handler'ları nasıl ele alırsın?

Dili bir search param'dan, bir segmentten ya da accept-language header'ından al, hasLocale(routing.locales, locale) ile doğrula ve başarısız olursa 400 döndür. Sonra getTranslations({locale, namespace})'yi çağır. Doğrulamayı atlarsan katalog aramasına rastgele bir string ulaşır.

Agent'ının geride bıraktığı İngilizceyi nasıl bulursun?

Bunları proje kökünden çalıştır. Bilerek kaba tasarlandılar; amaç puan değil, okunacak bir liste çıkarmak.

# 1. Static metadata that cannot be translated
grep -rn "export const metadata" app

# 2. Titles and descriptions already in generateMetadata
grep -rn "title:" app --include=page.tsx --include=layout.tsx

# 3. Server Actions with literal return messages
grep -rln "use server" app src 2>/dev/null | xargs grep -n "message:\|error:"

# 4. Zod schemas with inline messages
grep -rn "message:\s*['\"]" app src 2>/dev/null

# 5. 404 and error files, and whether a catch-all exists
ls app/\[locale\]/not-found.tsx app/\[locale\]/error.tsx "app/[locale]/[...rest]/page.tsx" 2>&1

İlk dört sonuçta çıkan düz İngilizce literal'lerin hepsi kataloğa aittir. Agent'lar neden koda gömülü metin eklemeye devam eder bunun neden tekrarladığını anlatıyor: agent görünen kalıbı izler ve görünen kalıp bileşendir. Copilot kullanıyorsan Copilot için talimat dosyası sınırları burada da geçerli.

Bu, kataloğunu nasıl etkiler?

Anahtar ekler, kayma da anahtarlarda başlar. Yukarıdaki her madde kataloğa yeni girdiler çeker; Metadata, Error, Subscribe ve doğrulama mesajları gibi. Her biri, yayınladığın her dilde bir çeviri ister. Bileşenlerini bir kez çevirip sonra bir Server Action ya da yeni bir sayfa başlığı ekleyen proje, çeviri dosyaları neden senkronizasyondan çıkar yazısında anlatılan projenin ta kendisidir.

next-intl çevirileri çalışma zamanında sunar ve biz onun yerine geçmiyoruz. globalize.now bir katman üstte durur: depoyu uygulamada bağlarsın, kod tabanı bir kez kataloğa dönüştürülür ve sonrasında push işleri yeni katalog birimlerini ortaya çıktıkça çevirir; sonuç, inceleyeceğin değişiklikler olarak gelir. Next.js entegrasyonu kurulumu anlatıyor, mevcut bir i18n kurulumunda nelere dokunup nelere dokunmadığımız ise next-intl'in zaten elle bağlandığı durumu kapsıyor.

Nereden başlamalı?

Beş grep'i çalıştır, statik metadata export'unu dönüştür, catch-all route'u ekle ve error.tsx'e provider'ını ver. Sonra kataloğu her dilde yeni namespace'ler için kontrol et. AI ile yazılmış bir uygulama yayınladıysan ve dönüştürmeyi ve çeviriyi elle sürdürmek yerine birinin üstlenmesini istiyorsan, genel bakış için vibe coder sayfası, agent kurulumları için geliştirici referansı var; fiyatlandırma ise ayrı bir sayfada.

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