Kamu cukup menginstal satu CLI, mengirim satu prompt ke Cursor, dan proyek Next.js-mu berubah dari JSX khusus bahasa Inggris menjadi aplikasi multibahasa yang berfungsi, lengkap dengan routing [locale], kunci yang dihasilkan, dan sinkronisasi otomatis di setiap push. globalize.now adalah infrastruktur lokalisasi berbasis AI yang mengerjakan pekerjaan i18n yang dilewatkan Cursor: mengekstrak teks hardcode, membuat kunci next-intl dan file bahasa, serta menjaga terjemahan tetap sinkron di setiap Git push. Panduan di bawah mengasumsikan proyek App Router standar. Total waktu di repo uji kami: 13 menit 40 detik.
Apa yang sebenarnya rusak saat Cursor membuat UI Next.js-mu?
Cursor mengoptimalkan UI yang berfungsi, bukan arsitektur. Cursor menghasilkan kode dari instruksi bahasa alami dan memperbarui bagian kode lewat prompt, sehingga JSX ditulis seperti prototipe cepat buatan manusia: teks langsung di dalam kode, tanpa kunci, tanpa file bahasa, tanpa segmen [locale].
Halaman Next.js hasil Cursor biasanya terlihat seperti ini:
// app/page.tsx
export default function Home() {
return (
<main>
<h1>Welcome to Acme</h1>
<p>Get started in seconds.</p>
<button>Sign up</button>
</main>
)
}
Tiga teks hardcode dalam satu halaman. Aplikasi sungguhan punya ratusan teks di puluhan komponen. Pages Router dulu menyediakan konfigurasi i18n bawaan, tetapi fitur itu dihapus saat App Router menjadi default, sehingga developer harus menyiapkan sendiri middleware, segmen rute dinamis, dan library eksternal seperti next-intl. Perilaku default Cursor tidak mengerjakan satu pun dari itu untukmu.
Hasilnya adalah pola yang kami bahas di Mengapa terjemahan aplikasi Lovable-mu rusak setiap kali rilis: codebase membesar, teks hardcode menumpuk, dan “tambah bahasa Spanyol bulan depan” berubah menjadi refactor berminggu-minggu.
Bagaimana cara menyiapkan globalize.now di proyek Cursor?
Hubungkan repositori di globalize.now. Konversi pertama berjalan sekali di aplikasi: globalize.now membaca repo, mengganti teks hardcode dengan kunci, lalu membuka PR yang kamu tinjau. Setiap push setelahnya menerjemahkan semua yang baru.
Untuk menjalankan konversi pertama dari Cursor, instal Skill dari root proyek:
npx skills add globalize-now/globalize-skills
CLI mendeteksi stack-mu, memilih preset yang tepat untuk Cursor, dan menginstal aturan agen ke proyek. Di proyek Next.js 16 App Router, hasilnya seperti ini:
✓ Stack detected: Next.js 16 (App Router)
✓ Editor detected: Cursor
✓ Preset selected: globalize-guide + next-intl
✓ Installed 4 skill files to .cursor/rules/
Done in 1.2s
File Skill berada berdampingan dengan aturan Cursor yang sudah ada. File ini memberi tahu agen Cursor cara mengekstrak teks, cara membuat kunci yang konsisten dengan konvensi next-intl, dan cara menyambungkan segmen rute [locale]. Tidak ada yang keluar dari mesinmu. Kodemu tidak diunggah.
Kalau kamu memakai Claude Code atau Codex, bukan Cursor, CLI menginstal file Skill yang setara untuk tool tersebut. Alur selanjutnya sama persis.
Bagaimana agen mengekstrak teks hardcode dari codebase Cursor?
Buka panel agen Cursor dan kirim satu prompt:
Set up i18n for this project. Use English, Spanish, German, and Arabic.
Agen memuat aturan yang terinstal, memindai direktori app/ dan components/, lalu melaporkan hasilnya. Di situs pemasaran 12 halaman, laporannya biasanya seperti ini:
Detected Next.js 16 with App Router.
Found 47 hardcoded strings across 12 components.
Best fit: next-intl. RTL required for Arabic.
Plan:
- Install next-intl
- Move app/* into app/[locale]/*
- Generate i18n/request.ts and middleware.ts
- Extract 47 strings to messages/en.json
- Convert JSX to useTranslations / getTranslations calls
Proceed? (y/n)
Agen mengerjakan bagian yang disebut dokumentasi next-intl sebagai bagian paling merepotkan: middleware, segmen rute dinamis, konfigurasi request, dan konversi komponen satu per satu agar memakai hook terjemahan. Kamu meninjau rencananya, lalu mengonfirmasi. Agen menerapkan perubahan sebagai satu edit multi-file yang bisa kamu terima atau tolak di tampilan diff Cursor.
Bagaimana agen membuat kunci next-intl dan file bahasa?
Setelah kamu menyetujui rencana, agen membuat struktur standar next-intl. Repo mendapat empat hal baru:
i18n/
request.ts
routing.ts
middleware.ts
messages/
en.json
es.json
de.json
ar.json
app/
[locale]/
layout.tsx
page.tsx
...
Di dalam messages/en.json, 47 teks yang diekstrak menjadi kunci ber-namespace yang dikelompokkan per komponen atau rute:
{
"Home": {
"heading": "Welcome to Acme",
"lede": "Get started in seconds.",
"signupCta": "Sign up"
}
}
page.tsx yang asli ditulis ulang agar memakai useTranslations untuk komponen klien dan getTranslations untuk komponen server. Pemisahannya otomatis. Agen membaca komponen mana yang memiliki direktif "use client" lalu memilih hook yang tepat.
File JSON bahasa Spanyol, Jerman, dan Arab dihasilkan dengan terjemahan awal yang mengikuti glosarium yang disusun agen dari nama komponen dan prop-mu. Istilah merek tetap dalam bahasa Inggris. Penanganan RTL sudah tersambung ke layout: atribut dir diatur dari locale, dan properti logis CSS menggantikan utilitas left/right tetap di tempat yang bisa dideteksi agen.
Ini pola end-to-end yang sama dengan yang kami jalankan di monorepo produksi dalam Apa yang terjadi saat agen AI menginternasionalisasi monorepo sungguhan?. Format panduannya sama; inputnya berbeda.
Bagaimana sinkronisasi Git push bekerja setelah proses pertama?
Proses pertama hanya sekali. Sinkronisasinya selamanya.
Setelah agen selesai, hubungkan repo ke globalize.now di dasbor. Sejak saat itu:
Push to main
↓
globalize.now diffs against last synced state
↓
New hardcoded strings get extracted + keyed
↓
Translations generated for every configured locale
↓
PR opened with locale file updates
Cursor tidak perlu terbuka. Claude Code tidak perlu berjalan. Sinkronisasi terjadi di lapisan Git, jadi tetap bekerja apa pun tool yang menulis batch UI berikutnya. Saat Cursor membuat ulang sebuah komponen minggu depan dan menambah tiga tombol baru, tombol-tombol itu sudah terjemahan di PR berikutnya.
Tanpa ekspor manual. Tanpa antrean tinjauan. Tanpa bolak-balik CSV. Janji produknya sama dengan yang kami dokumentasikan di Cara melokalisasi aplikasimu dengan globalize.now: siapkan sekali, sinkronisasi otomatis di setiap push.
Bagaimana kalau kamu sudah punya setup next-intl buatan sendiri?
Agen membacanya terlebih dahulu.
Jika i18n/request.ts sudah ada, agen memakai konfigurasimu, bukan menimpanya. Jika messages/en.json sudah memiliki Pricing.heading, agen memakai ulang kunci itu alih-alih membuat yang baru. Jika konvensi namespace-mu pricing.heading (huruf kecil, dipisah titik) dan bukan Pricing.heading (PascalCase, bersarang), agen menyesuaikan diri.
Satu-satunya hal yang ditolak agen adalah menimpa file bahasa yang sudah ada secara diam-diam. Jika terjadi tabrakan kunci, agen berhenti dan bertanya. Perilaku itu sudah tertanam di aturan Skill yang diinstal oleh npx skills add globalize-now/globalize-skills, bukan sesuatu yang perlu kamu konfigurasikan.
globalize.now menanganinya. Hubungkan repositori Next.js-mu dan konversi berjalan sekali di aplikasi; Skill npx skills add globalize-now/globalize-skills mencakup pekerjaan berikutnya di editormu. Lihat cara kerjanya di globalize.now.
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