Minta Cursor atau Claude Code menambahkan i18n ke aplikasi Next.js hari ini, dan kemungkinan besar hasilnya berupa middleware.ts, setRequestLocale di setiap layout, dan useTranslations yang dipanggil dari halaman async. Setup itu benar untuk Next.js 15, tetapi sudah satu generasi usang di Next.js 16. globalize.now adalah infrastruktur lokalisasi berbasis AI, jadi lapisan inilah yang kami pantau: wiring routing berubah, katalog yang disajikannya tidak. Berikut apa saja yang berubah, cara mengetahui kode hasil generate-mu berasal dari era yang mana, dan tiga perbaikan yang cukup memakan satu sore, bukan penulisan ulang.
Tidak ada satu pun yang merupakan breaking change. Justru itulah sebabnya mudah terlewat.
Apa yang berubah di Next.js 16 untuk i18n?
File yang menegosiasikan locale-mu berganti nama. Dokumentasi Next.js menyatakan konvensi file middleware sudah deprecated dan diganti namanya menjadi proxy sejak v16.0.0, dengan alasan soal istilah: “middleware” terus disalahartikan sebagai middleware Express, jadi fitur ini diganti namanya agar menggambarkan batas jaringan yang sebenarnya.
Dua catatan perilaku menyertai penggantian nama di v16. Proxy memakai runtime Node.js secara default, dan opsi konfigurasi runtime per file tidak lagi tersedia di sana: jika kamu menyetelnya, Next.js akan melempar error. Proxy juga tidak didukung pada static export, yang penting jika negosiasi locale adalah satu-satunya alasan kamu belum mengekspor.
Khusus untuk routing locale, panduan setup next-intl kini menampilkan file itu sebagai src/proxy.ts dan menyatakan dengan jelas bahwa sebelumnya bernama middleware.ts hingga Next.js 16. Import di dalamnya tidak berubah:
// 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|.*\\..*).*)'
};
Perhatikan ketidaksimetrisannya, karena sering membuat orang tersandung: file-nya kini proxy.ts, sedangkan path import-nya masih next-intl/middleware. Mengganti nama import adalah koreksi berlebihan yang umum.
Mengapa kode i18n buatan AI sering tertinggal satu versi?
Karena agen coding memprediksi pola yang paling banyak terwakili, dan pola yang paling banyak terwakili adalah yang sudah bertahun-tahun menumpuk. Setiap posting blog, jawaban Stack Overflow, dan contoh GitHub tentang routing locale App Router yang ditulis sebelum akhir 2026 menyebut middleware.ts. Model yang menimbang korpus itu terhadap dokumentasi v16 yang baru beberapa minggu akan memilih bentuk lama dengan penuh keyakinan, tanpa peringatan bahwa ada penggantian nama.
Ini mekanisme yang sama di balik masalah yang pernah kami tulis, yaitu Cursor terus menambahkan teks hardcode setelah setup i18n: agen mereproduksi codebase yang secara statistik lazim, bukan codebase-mu. Itu juga alasan mengapa file instruksi hanya memperbaiki sebagian masalah di GitHub Copilot: aturan yang dibaca antarmuka chat belum tentu dibaca oleh inline completion.
Dampak praktisnya sempit tetapi nyata. Setup buatan AI-mu berjalan, jadi tidak ada yang gagal dengan keras. Lalu kamu menemui bug, mencarinya, dan semua jawaban terbaru menjelaskan file yang tidak kamu punya.
Bagaimana cara mengetahui setup buatan AI-ku berasal dari era yang mana?
Empat grep. Jalankan dari root proyek dan kamu akan tahu dalam sekitar satu menit.
# 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
Hasil pada nomor 1 dan 2 berarti scaffolding pra-16. Hasil pada nomor 3 adalah error runtime yang menunggu request pertama yang merender komponen itu. Tidak ada hasil pada nomor 4 berarti konfigurasi request-mu masih membaca locale dengan cara lama.
Apakah aku harus mengganti nama middleware.ts menjadi proxy.ts?
Tidak mendesak, dan jangan lakukan secara manual. Next.js menyediakan codemod yang mengganti nama file sekaligus fungsi yang diekspor:
npx @next/codemod@canary middleware-to-proxy .
Penggantian nama ini berupa deprecation, bukan penghapusan, jadi middleware.ts yang sudah ada tetap berfungsi. Alasan tetap menjalankannya adalah biaya pemeliharaan: begitu nama file cocok dengan dokumentasi terbaru, setiap hasil pencarian di masa depan berlaku untuk repo-mu. Biarkan usang dan kamu membayar pajak kecil di setiap sesi debugging, selamanya.
Apakah setRequestLocale sudah deprecated di next-intl?
API ini ditandai legacy, klaim yang lebih lunak daripada deprecated dan perlu dibaca dengan cermat. Dokumentasi next-intl menggambarkan setRequestLocale sebagai API yang ada sampai next/root-params diperkenalkan, menyatakan API itu tetap didukung demi kompatibilitas mundur, dan merekomendasikan next/root-params sebagai gantinya.
Bentuk yang lebih baru membaca locale yang cocok di dalam konfigurasi request-mu, bukan menyalurkannya secara manual lewat setiap layout dan halaman:
// 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 tersedia secara default di Next.js 16.3 ke atas; di versi lebih lama harus diaktifkan lewat experimental.rootParams. Ikuti setup dengan cara ini dan static rendering didapat tanpa usaha tambahan, selama kamu tetap mengekspor generateStaticParams untuk segmen [locale].
Pendekatan lama mengharuskan pemanggilan setRequestLocale di setiap halaman dan layout yang ingin dirender statis, sebelum pemanggilan next-intl lainnya, karena Next.js merender layout dan halaman secara terpisah. Itu aturan yang dilupakan agen AI pada file kelima yang ditulisnya. Menghapus persyaratan itu menghapus satu kelas bug.
Mengapa useTranslations crash di Server Component async-ku?
Karena hook tidak bisa dipanggil dari komponen async, dan useTranslations adalah hook. Ini batasan React Server Components, bukan keanehan next-intl, dan jawaban next-intl adalah seperangkat fungsi paralel yang bisa di-await:
// 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, dan getLocale mengikuti pola yang sama. Contoh kedua perlu diperhatikan: komponen non-async tanpa fitur interaktif berarti komponen shared, dan next-intl memilih implementasi yang tepat tergantung apakah komponen dirender di server atau di klien. Jadi useTranslations di Server Component bukan kesalahan: yang salah adalah memanggilnya dari komponen async.
Mengapa aku mendapat error konteks NextIntlClientProvider?
Catatan pemecahan masalah next-intl menyebut dua penyebab, dan keduanya butuh perbaikan yang berlawanan. Pertama, komponen memang berjalan di klien tanpa provider di atasnya: bungkus komponen itu dan teruskan messages yang dibutuhkan. Kedua, komponen terseret masuk ke module graph klien padahal kamu mengharapkan server rendering: teruskan komponen itu lewat children dari Server Component, jangan mengimpornya di dalam komponen klien.
Kasus kedua adalah yang sering dialami aplikasi buatan AI, karena agen menerapkan 'use client' secara berlebihan agar interaktivitas berjalan, dan direktif ini menular ke seluruh import graph. Pola yang disarankan: terjemahkan di server, lalu kirim string yang sudah jadi melintasi batas server-klien:
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>;
}
Jika ada komponen yang benar-benar membutuhkan pesan di klien, kamu bisa membatasi provider hanya pada subtree itu, alih-alih mengirim semua pesan ke browser: messages={null} pada provider root tidak mengirim pesan sama sekali.
Apa yang tidak berubah dari semua ini?
File locale-mu. Setiap perbaikan di atas hanya menyentuh routing dan rendering. JSON yang dimuat aplikasimu tidak tersentuh sama sekali. Inilah poin yang perlu kamu bawa pulang: wiring bisa selesai dalam satu sore dan hanya berubah setahun sekali, sedangkan katalog terjemahan membusuk setiap minggu seiring UI baru dirilis.
Itulah pemisahan yang kami bangun. next-intl dan library sejenisnya menyajikan terjemahan saat runtime: kami tidak bersaing dengan mereka, dan jika kamu masih memilih di antaranya, next-intl vs react-i18next vs Lingui menguraikan kelebihan dan kekurangannya. globalize.now berada satu lapisan di atasnya, menghasilkan kunci dan file bahasa yang dibaca runtime tersebut, sehingga integrasi Next.js berjalan sama saja, baik negosiasi bahasamu ada di middleware.ts maupun proxy.ts.
Konversi dilakukan satu kali dan berjalan di aplikasi: kamu menghubungkan repositori, globalize.now mengonversi codebase satu kali lalu membuka pull request berisi katalog. Setelah itu, job push menerjemahkan unit katalog baru begitu muncul. Pola kegagalan ini dijelaskan di mengapa file terjemahan terus tidak sinkron, dan itu alasan celah tersebut sebaiknya ditutup sebelum bahasa ketigamu, bukan sesudahnya.
Jika proyekmu sudah punya setup next-intl yang ditulis manual, kami sudah menulis secara rinci apa yang kami sentuh dan apa yang tidak. Jika belum, panduan Cursor jalan masuk tersingkat, dengan catatan: file yang dihasilkan memakai nama sesuai konvensi lama, jadi jalankan codemod sesudahnya.
Mulai dari sini
Jalankan keempat grep. Kalau dua yang pertama menemukan hasil, jalankan codemod, pindahkan konfigurasi request ke next/root-params, dan kamu sudah up to date. Lalu periksa file locale, karena bagian itulah yang masih akan melenceng bulan depan. Kalau kamu merilis aplikasi buatan AI dan ingin katalognya diurus, bukan dirawat sendiri, halaman vibe coder adalah gambaran umumnya, 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