Menggunakan globalize.now dengan Cursor
Ekstrak teks dan buat file bahasa dari aplikasi buatan Cursor dengan satu perintah.
Cursor membuat UI yang berfungsi dengan cepat, tetapi biasanya menulis teks bahasa Inggris langsung di JSX. globalize.now mengekstrak teks hardcode itu, membuat kunci terjemahan, dan membuat file bahasa, sehingga aplikasi buatan Cursor menjadi codebase yang siap diterjemahkan. Pengaturannya cukup satu perintah, lalu sinkron di setiap Git push sesudahnya.
Prasyarat
- Proyek yang dibangun dengan Cursor
- Sebuah repositori Git
- Node.js 18+
- Library i18n JavaScript apa pun yang sudah terpasang (i18next, next-intl, dan sejenisnya), atau tidak ada sama sekali jika kamu mulai dari nol
Cara menyiapkan globalize.now dengan Cursor
Buka proyek Cursor dan pastikan Git siap
Buka repositori di Cursor dan pastikan codebase sudah di-commit dan di-push ke remote Git, supaya push berikutnya bisa memicu sinkronisasi.
Jalankan installer Skills di root proyek
Hubungkan repositori di globalize.now untuk mengonversinya langsung di aplikasi, atau pasang Skill agen Globalize lewat terminal di root repositori agar asistenmu bisa menyiapkan i18n dan memindai seluruh struktur kode.
npx skills add globalize-now/globalize-skills --allBiarkan agen menganalisis codebase
Ikuti prompt dari agen supaya ia bisa menemukan teks hardcode yang terlihat pengguna di seluruh komponen dan route.
Tinjau susunan kunci terjemahan yang diusulkan
Periksa struktur dan penamaan kunci yang disarankan sebelum refactor masuk ke branch-mu.
Konfirmasi ekstraksi dan file bahasa
Setujui perubahan agar kunci dibuat, komponen memanggil API i18n runtime alih-alih teks literal, dan file bahasa ditulis ke repo.
Commit dan push
Commit perubahan dan push ke branch default agar globalize.now bisa menjaga teks baru tetap selaras di push Git berikutnya.
Hubungkan lewat MCP (opsional)
Lebih suka mengendalikan Globalize dari Cursor? Setelah kodemu siap i18n, hubungkan MCP.
Tambahkan ke ~/.cursor/mcp.json
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}Selengkapnya: hubungkan MCP
Masalah umum
Cursor terus menambahkan teks hardcode baru
Solusi: globalize.now berjalan di setiap push Git, sehingga teks literal baru terdeteksi otomatis dan tidak menumpuk diam-diam di antara rilis.
Kunci terjemahan bentrok dengan setup i18n yang sudah ada
Solusi: globalize.now mendeteksi library i18n yang sudah ada dan mengikuti konvensinya, sehingga kunci baru memperluas katalog yang ada, bukan bertabrakan dengannya.
Pertanyaan yang sering diajukan
Apakah globalize.now bisa dipakai di semua proyek buatan Cursor?
Bisa, selama stack-nya didukung globalize.now lewat Skill agennya (framework JavaScript modern seperti Next.js, React, atau Vue). globalize.now berfokus mengekstrak teks UI hardcode dan menghasilkan kunci serta file bahasa, terlepas dari editor yang menghasilkan JSX-nya. Kamu tetap menjalankan npx skills add globalize-now/globalize-skills dari root proyek dan mengikuti prompt terpandu agar agen bisa memindai repo dan membuka diff yang siap di-merge.
Apakah saya perlu mengonfigurasi globalize.now untuk mendeteksi pola khusus Cursor?
Tidak perlu integrasi Cursor terpisah. globalize.now menganalisis repositori dengan cara yang sama, baik file ditulis secara manual maupun oleh Cursor. Skill mencari teks yang tampil di UI beserta struktur routing, lalu mengusulkan kunci yang sesuai dengan library i18n yang kamu pilih. Kamu mereview rencananya di Git seperti perubahan lainnya.
Apakah saya bisa memakai globalize.now di proyek Cursor yang sudah punya i18n sebagian?
Bisa. Tooling ini dirancang untuk melengkapi katalog yang sudah ada jika kunci dan file bahasa sudah tersedia. globalize.now mendeteksi library runtime yang kamu pakai dan mengusulkan tambahan tanpa membuang pekerjaan sebelumnya, sehingga kamu bisa memigrasikan teks hardcode secara bertahap. Terus gunakan push ke Git agar UI baru tetap tercakup.
Dengan library i18n apa saja hasil globalize.now bisa dipakai di proyek Cursor?
globalize.now tidak terikat pada library tertentu: ia menghasilkan kunci terjemahan dan file bahasa terstruktur yang cocok dengan runtime umum seperti i18next, next-intl, react-intl, Lingui, dan vue-i18n. Proyek Cursor-mu tetap memakai stack pilihanmu; globalize.now menyediakan lapisan ekstraksi dan sinkronisasi. Skill agen membantu memasang provider atau middleware yang dibutuhkan framework-mu.
Apakah globalize.now mengubah komponen yang dibuat Cursor?
globalize.now menulis ulang titik pemanggilan agar teks hardcode melewati API i18n (misalnya t() atau komponen pesan) tanpa mengubah perilaku. Kamu mereview diff di Git sebelum merge, sama seperti perubahan lain yang dibuat Cursor. Setelah merge pertama, setiap push berikutnya menyinkronkan teks baru secara otomatis tanpa langkah ekspor terpisah.
Di mana saya menjalankan globalize.now di Cursor?
Selalu jalankan npx skills add globalize-now/globalize-skills dari root repositori di terminal terintegrasi Cursor (atau shell mana pun yang mengarah ke root itu). Skill dibatasi pada proyek saat ini, memasang paket skill lokalisasi, lalu menyerahkan kendali kembali ke agenmu untuk prompt lanjutan. Dengan tetap di root, deteksi path selaras dengan cara CLI memindai struktur direktori.
Coba globalize.now dengan Cursor
Mulai dari root proyek:
npx skills add globalize-now/globalize-skills --all