Jika repomu sudah memakai next-intl, react-i18next, i18next, atau Lingui (ada folder bahasa di disk, dependensi di package.json, file middleware atau konfigurasi), kamu tidak butuh tool lain yang menganggapmu mulai dari nol. globalize.now adalah infrastruktur lokalisasi berbasis AI. Dalam mode L1 (sudah terinternasionalisasi), globalize.now melewati scaffold setup yang destruktif dan tetap di mode sinkronisasi: membaca bahasa sumbermu, membandingkan bahasa lain saat push, lalu membuka PR berisi terjemahan yang kurang. Artikel ini membahas apa yang disentuh mode tersebut, apa yang tidak disentuhnya, dan apa yang harus dilakukan saat deteksi keliru.
Mengapa kebanyakan saran i18n mengasumsikan kamu mulai dari nol?
Materi pemasaran tool i18n masih menyoroti kasus “greenfield”: tanpa library terpasang, tanpa file bahasa, tanpa ekstraksi. Kebanyakan codebase produksi tidak berada di kondisi itu.
Dalam beberapa minggu terakhir, tiga sesi kontak pertama yang tidak saling terkait menunjukkan pola yang sama: tim pernah mencoba i18n sekali, hasilnya setengah jadi, lalu berhenti, karena membongkar dan mengulang dari awal terasa lebih berat daripada membiarkan kekacauan itu.
Jika itu kamu, kamulah pembaca yang dituju tulisan ini.
Seperti apa sebenarnya codebase yang i18n-nya setengah jadi?
Pola-pola ini muncul berulang kali (detail dianonimkan):
- Aplikasi Next.js + next-intl yang sebagian besar komponennya memakai
t(), tetapi route lama masih memuat teks bahasa Inggris hardcode karena gelombang migrasi pertama tidak pernah selesai. - Proyek React + i18next yang file bahasanya ada tetapi hanya berisi nilai bahasa Inggris: menerjemahkan selalu dijadwalkan “kuartal depan”.
- Struktur
messages/di manaen.jsonterisi penuh danes.jsonnyaris kosong. - Language switcher yang terpasang di layout tetapi kadang menghasilkan 404 karena migrasi routing baru setengah jalan.
Tidak satu pun proyek ini butuh globalize.now untuk memulai dari awal. Mereka butuh globalize.now untuk menuntaskan pekerjaannya.
Sinyal apa yang dipindai globalize.now saat pertama kali berjalan?
Deteksi berlangsung dalam dua langkah, bukan satu.
Pertama, arahkan globalize.now ke repo. Menghubungkannya di aplikasi akan menjalankan deteksi dan konversi satu kali untukmu. Jika kamu lebih suka agenmu yang melakukannya secara lokal, pasang Skill-nya. Ini menaruh beberapa file playbook ke .claude/skills/ dan tidak mengubah apa pun lagi di repomu:
npx skills add globalize-now/globalize-skills
Lalu beri prompt ke agenmu: Claude Code, Cursor, atau Codex. Agen membaca Skill yang terpasang dan memakainya untuk memindai repomu:
Set up localization for my project
Langkah kedua itulah tempat deteksi sebenarnya berjalan. Agen mencari:
- Dependensi
package.json:next-intl,react-i18next,i18next,@lingui/core,@lingui/react,@lingui/macro, atau plugini18next-*apa pun. - Folder bahasa:
messages/di root repo, folderlocales/, atausrc/i18n/dengan subfolder bahasa. - File bahasa yang sudah ada:
en.json,en.po,en.yml,en.yaml, atau file bahasa default yang sudah diharapkan library-mu. - Konfigurasi khusus framework:
i18n.config.ts, middleware next-intl,lingui.config.js, atau padanannya.
Jika setidaknya dua dari sinyal itu ada, proyek dianggap L1 (sudah terinternasionalisasi) dan alur setup bercabang, bukan menjalankan scaffold greenfield penuh. Detail lengkapnya ada di artikel Help Center tentang i18n yang sudah ada.
Apa yang tidak akan diubah oleh mode L1?
Bagian ini yang paling penting. Dalam mode L1, globalize.now tidak:
- Menjalankan ekstraksi teks menyeluruh yang memindai komponen untuk mencari literal hardcode.
- Membuat kunci terjemahan baru atau mengubah struktur kunci yang sudah kamu commit.
- Membuat scaffold file bahasa untuk bahasa yang belum kamu konfigurasi.
- Menyisipkan pengalih bahasa. Kalau kamu sudah punya, tetap dipertahankan. Kalau belum, kami tidak menambahkannya.
- Menulis ulang konfigurasi routing, middleware, atau framework.
Setup i18n yang sudah ada tetap milikmu. Dalam mode ini, kami tidak merefaktornya.
Apa yang dilakukan mode sinkronisasi L1 setelah deteksi?
L1 mengutamakan sinkronisasi. Setelah deteksi selesai:
- Kami membaca file bahasa yang sudah ada untuk memahami struktur kunci saat ini dan bahasa mana yang menjadi sumber acuan.
- Kamu menghubungkan repositori GitHub lewat CLI atau aplikasi web globalize.now.
- Setiap kali kamu push ke branch utama, kami membandingkan file bahasa sumber dengan bahasa lainnya. Terjemahan yang kosong diisi dengan output AI yang mengikuti glosarium dan panduan gaya yang kamu atur.
- Sebuah PR masuk dengan file bahasa yang sudah diperbarui. Kamu yang me-review dan me-merge. Kami tidak pernah me-merge untukmu.
Begitulah alurnya. Tanpa dasbor terjemahan yang harus dipantau. Tanpa ekspor manual. Tanpa repot mengurus format file.
Bandingkan dengan panduan L0 di Bagaimana cara menambahkan i18n ke aplikasi Next.js buatan Cursor dalam 15 menit?: produknya sama, jalur masuknya berbeda.
Bagaimana kalau hanya sebagian UI yang memakai fungsi terjemahan?
Ini kondisi umum di tengah migrasi: layar baru memakai t(), layar lama masih menyisakan literal. Di luar mode sinkronisasi, pipeline skills menganggap teks yang sudah punya kunci sebagai terkunci: fokusnya pada literal yang belum terhubung, dan kunci yang ada tetap dipertahankan. Tim yang rilis setiap minggu sambil menjalani migrasi setengah jalan seperti ini adalah pengguna “L1 campuran” yang paling sering kami temui di log.
Untuk kisah konversi penuh oleh agen pada struktur kode yang rumit, baca Apa yang terjadi saat agen AI menginternasionalisasi monorepo sungguhan?.
Apa yang harus dilakukan jika alur setup tetap membuat scaffold untuk semuanya?
Kami sedang memperketat logika deteksi agar cabang yang salah tidak terpicu. Namun jika npx skills add globalize-now/globalize-skills sudah menghasilkan diff 100+ file yang menulis ulang folder bahasamu, menyisipkan pengalih bahasa yang tidak kamu minta, atau mengubah struktur routing, jangan di-commit. Gunakan widget feedback (kanan bawah) dengan daftar dependensi package.json-mu dan catatan singkat tentang tata letak folder bahasamu; kami bisa mengarahkan repo ke L1 secara manual. Flag CLI --existing-i18n mandiri akan segera hadir.
Pemulihan di mesinmu cukup dengan git restore . ditambah git clean -fd jika perlu. Tidak ada yang di-push; tidak ada yang rusak di production; agen hanya menyentuh branch lokalmu. Penjelasan lengkapnya ada di globalize_skills membuat terlalu banyak perubahan: apa yang terjadi?.
Mengapa “kami sudah coba i18n tapi mandek” kini jadi cerita yang paling umum?
Ini bukan slogan: ini pola. Tiga sesi pertama yang independen dalam enam minggu, tiga versi dari “ya, kami pernah mencobanya; sekarang berantakan.” Sebuah ekstensi Chrome dengan puluhan ribu pengguna mengalami lonjakan trafik dari Korea dan memicu migrasi next-intl yang setengah jadi. Aplikasi buatan Lovable merusak build-nya sendiri saat menambahkan dukungan multibahasa lalu di-revert. Repo React + Vite hasil vibe coding menyambungkan i18next, mengisi sekitar sepertiga kunci, lalu berhenti.
Codebase L0 yang bersih dan sedang mencari library memang ada, tetapi itu bukan hambatan utamanya. Hambatannya adalah codebase yang pernah mencoba hal ini dan kini tidak ada yang mau menanggung akibatnya.
Mode L1 dibuat untuk codebase seperti itu.
Berapa biayanya?
Paket Starter seharga €20 per bulan dan sudah termasuk kredit €20 setiap bulan. Kredit ini terpakai untuk terjemahan, review QA, dan konversi, dan kredit yang tidak terpakai di akhir periode hangus. Ada juga paket Team seharga €249 per bulan dengan kredit €100. Organisasi baru mendapat kredit uji coba satu kali sebesar €5 yang kedaluwarsa setelah 14 hari. Entah kamu L0 dengan proyek greenfield, atau L1 dengan utang locale tiga tahun, harganya sama: penggunaan ditagih berdasarkan biaya provider, bukan seberapa berantakan commit pertamamu.
Posting dan dokumen Help Center mana yang sebaiknya dibaca berikutnya?
- Panduan setup L0 untuk aplikasi Next.js buatan Cursor
- Studi kasus monorepo: apa yang sebenarnya disentuh agen
- Mengapa TMS klasik kesulitan dengan stack modern berbasis Git
- Help Center: Aku sudah punya i18n, apa yang dikerjakan globalize.now?
- Help Center: globalize_skills mengubah terlalu banyak
Rilis bahasa yang sudah diharapkan pengunjungmu. Hubungkan repo di globalize.now, atau baca bagaimana otomatisasi Git push cocok dengan alur kerja tim yang sudah ada.
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