Kalau aplikasi Next.js-mu sudah diterjemahkan tetapi tab browser, halaman 404, pesan error form, dan link preview masih berbahasa Inggris, penyebabnya hampir selalu sama: teks itu dihasilkan di luar komponen, sehingga panggilan useTranslations tidak pernah menyentuhnya. globalize.now adalah infrastruktur lokalisasi berbasis AI, dan lapisan inilah yang paling sering kami lihat setengah jadi ketika agen AI menambahkan i18n ke proyek App Router: halaman yang terlihat sudah dikonversi, sisanya belum.

Di bawah ini tempat setiap teks itu berada beserta panggilan next-intl yang menanganinya. Semua contoh mengikuti dokumentasi next-intl terbaru, diambil pada 28-10-2026.

Di mana teks yang belum diterjemahkan bersembunyi di aplikasi App Router?

Mereka bersembunyi di enam tempat yang bukan komponen React yang merender teks. Agen coding yang menambahkan i18n dengan menelusuri komponen akan mengonversi UI yang terlihat dan melewatkan semua ini:

  1. Judul dan deskripsi halaman di generateMetadata.
  2. Pesan validasi dan hasil di Server Action.
  3. not-found.tsx, halaman 404.
  4. error.tsx, halaman error runtime.
  5. File hasil generate seperti opengraph-image.tsx, manifest.ts, dan sitemap.ts.
  6. Route Handler yang mengembalikan teks.

Benang merahnya: tidak ada satu pun yang dirender di dalam layout tree [locale] dengan cara biasa, jadi locale harus diteruskan ke mereka atau dibaca dengan cara lain. Artikel routing Next.js 16 membahas wiring routing; artikel ini membahas apa yang tidak dijangkau wiring itu.

Bagaimana cara menerjemahkan judul dan deskripsi halaman?

Panggil getTranslations dari next-intl/server di dalam generateMetadata. Fungsi ini bisa diekspor dari page atau layout, dan bersifat async, jadi API yang bisa di-await adalah pilihan yang tepat:

// 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')};
}

Jebakannya ada di bentuk statis. Agen sering menulis export const metadata = {title: 'Dashboard'} karena lebih pendek, padahal konstanta tidak bisa memanggil fungsi terjemahan. Ubah ke bentuk fungsi, lalu tambahkan kunci yang sama ke katalog untuk setiap bahasa. Teks ini juga yang dibaca mesin pencari, itulah sebabnya menerjemahkan aplikasi tanpa menerjemahkan metadatanya hampir tidak membantu peringkat.

Bagaimana cara menerjemahkan pesan Server Action dan validasi?

Teruskan locale ke action, lalu panggil getTranslations dengan namespace dan locale tersebut. Server Action tidak tahu halaman memakai bahasa apa, jadi dokumentasi next-intl meminta kamu menyediakannya, misalnya sebagai argumen:

'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')
}

Satu catatan dari dokumentasi yang sama: pikirkan apa yang terjadi kalau pengunjung bisa berganti bahasa saat pesan dari action sedang tampil. Dengan segmen [locale] di URL, hal ini tertangani otomatis karena route berubah. Tanpa segmen itu, kamu mungkin perlu menghapus pesannya sendiri, misalnya dengan memberi komponen key={locale} agar state-nya ter-reset.

Untuk validasi form dengan Zod, pendekatan yang didokumentasikan adalah error map. Zod menerimanya di setiap panggilan safeParse, dan map itu bisa memanggil getTranslations. Taruh dalam satu helper async dan teruskan hasilnya sebagai opsi error pada setiap parse. Dengan begitu skemamu berisi aturan, bukan kalimat bahasa Inggris, dan form buatan AI tidak lagi menampilkan "Invalid email" di halaman berbahasa Latvia.

Bagaimana cara menerjemahkan halaman 404 dan error?

Taruh not-found.tsx di dalam app/[locale]/, lalu tambahkan catch-all agar benar-benar terpicu. Next.js merender file itu ketika sebuah segmen memanggil notFound(), dan URL yang tidak dikenal tidak memanggilnya sendiri:

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

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

Request yang tidak cocok dengan middleware next-intl sama sekali tidak membawa locale, jadi 404 [locale] tidak pernah berlaku untuk mereka. Jawaban dokumentasinya adalah app/global-not-found.tsx, yang oleh Next.js didokumentasikan sebagai eksperimental dan merender html dan body miliknya sendiri. Untuk nilai [locale] yang tidak dikenal, dokumentasi menyarankan memanggil notFound(), biasanya di i18n/request.ts.

error.tsx berbeda. Next.js mewajibkannya sebagai Client Component, dan ia dirender di bawah layout-mu, jadi butuh NextIntlClientProvider yang membawa setidaknya namespace Error. Teruskan hanya pesan-pesan itu, bukan seluruh katalog:

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

Setelah itu useTranslations('Error') berfungsi di dalam error.tsx. Halaman ini tidak mencakup global-error, jadi periksa file itu secara manual kalau kamu punya.

Bagaimana dengan gambar share, manifest, dan sitemap?

Masing-masing perlu diberi locale, karena berada di luar layout tree. Untuk opengraph-image.tsx, baca locale dari params dan panggil getTranslations({locale, namespace}). Dengan localePrefix yang dikustomisasi, dokumentasi memperingatkan route hasil generate bisa tidak terjangkau, karena Next.js tidak melihat rewrite dari proxy (middleware). Perbaikannya: buat matcher melewati path yang berakhiran opengraph-image.

app/manifest.ts berada di luar [locale], jadi next-intl tidak bisa menyimpulkan locale dari path. Pilih satu yang representatif, biasanya bahasa default, dan teruskan secara eksplisit. Untuk sitemap.ts, tambahkan entri alternates.languages dan bangun setiap URL dengan getPathname({locale, href}) async dari modul navigasimu, diawali dengan host. next-intl juga mengirim header respons link yang mengumumkan versi bahasa secara default. Sitemap adalah pilihan kalau kamu butuh kontrol atas slug yang berasal dari CMS.

Bagaimana menangani Route Handler?

Ambil locale dari search param, segmen, atau header accept-language, validasi dengan hasLocale(routing.locales, locale), dan kembalikan 400 kalau gagal. Lalu panggil getTranslations({locale, namespace}). Kalau validasi dilewati, string sembarang bisa masuk ke pencarian katalogmu.

Bagaimana menemukan teks Inggris yang ditinggalkan agenmu?

Jalankan ini dari root proyek. Sengaja dibuat kasar: tujuannya menghasilkan daftar untuk dibaca, bukan skor.

# 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

Apa pun di empat hasil pertama yang berupa literal Inggris biasa harus masuk katalog. Mengapa agen terus menambahkan teks hardcode menjelaskan kenapa ini berulang: agen mengikuti pola yang terlihat, dan pola yang terlihat adalah komponen. Kalau kamu memakai Copilot, batasan file instruksi Copilot juga berlaku di sini.

Apa dampaknya bagi katalogmu?

Katalog bertambah kunci, dan kunci adalah titik awal drift. Setiap item di atas menambah entri baru ke katalog, seperti Metadata, Error, Subscribe, dan pesan validasi, dan masing-masing butuh terjemahan di setiap bahasa yang kamu rilis. Proyek yang menerjemahkan komponennya sekali lalu menambah Server Action atau judul halaman baru adalah proyek yang sama dengan yang dibahas di mengapa file terjemahan tidak sinkron.

next-intl menyajikan terjemahan saat runtime dan kami tidak menggantikannya. globalize.now berada satu lapisan di atas: kamu menghubungkan repositori di app, codebase dikonversi sekali menjadi katalog, lalu push job menerjemahkan unit katalog baru begitu muncul, dikirim sebagai perubahan yang bisa kamu tinjau. Integrasi Next.js menjelaskan setup-nya, dan apa yang kami sentuh dan tidak kami sentuh di setup i18n yang sudah ada membahas kasus ketika next-intl sudah dipasang manual.

Mulai dari sini

Jalankan kelima grep, ubah ekspor metadata statis, tambahkan catch-all route, dan beri error.tsx provider-nya. Lalu periksa katalog untuk namespace baru di setiap bahasa. Kalau kamu merilis aplikasi buatan AI dan ingin konversi serta terjemahannya diurus, bukan dirawat sendiri, halaman vibe coder adalah gambaran umumnya, referensi developer membahas setup agen, dan harga ada di halaman tersendiri.

globalize.now mengubah teks hardcode di aplikasimu menjadi file locale yang siap diterjemahkan, lalu menjaganya tetap diperbarui setiap kali kamu rilis.

Coba globalize.now gratis