Menggunakan globalize.now dengan Next.js

Siapkan internasionalisasi di aplikasi Next.js dalam waktu kurang dari lima menit.

Next.js punya dukungan i18n kelas satu lewat library seperti next-intl dan next-i18next, tetapi library itu mengharapkan codebase yang sudah punya kunci terjemahan. globalize.now adalah langkah sebelumnya: ia mengambil aplikasi Next.js yang penuh teks bahasa Inggris hardcode, lalu menghasilkan kunci, file bahasa, dan komponen hasil refaktor yang bisa dilayani next-intl (atau library runtime lain).

Prasyarat

  • Proyek Next.js (App Router atau Pages Router)
  • Sebuah repositori Git
  • Node.js 18+
  • Library runtime i18n pilihanmu (disarankan next-intl)

Cara menyiapkan globalize.now dengan Next.js

  1. Pasang library runtime

    Tambahkan next-intl atau library pilihanmu agar aplikasi bisa memuat pesan per bahasa saat runtime.

    npm install next-intl
  2. Konfigurasi routing dasar next-intl

    Pasang middleware, provider, dan segmen route sesuai dokumentasi next-intl, atau lewati langkah ini jika sudah selesai.

  3. Jalankan installer skill Globalize

    Dari root proyek Next.js, pasang skill agar agen bisa menyesuaikan diri dengan setup routing-mu.

    npx skills add globalize-now/globalize-skills --all
  4. Konfirmasi deteksi next-intl

    Biarkan agen memverifikasi bahwa provider dan path pesan sesuai dengan konvensi yang diharapkan globalize.now untuk Next.js.

  5. Periksa struktur file bahasa yang diusulkan

    Periksa direktori messages dan nama file yang disarankan agar sesuai dengan pola pesan per bahasa yang kamu pilih.

  6. Refaktor teks hardcode menjadi pemanggilan terjemahan

    Setujui perubahan yang mengganti teks bahasa Inggris tertanam dengan t() atau helper setara yang terhubung ke provider-mu.

  7. Push ke Git

    Merge branch lalu push agar globalize.now bisa menjaga terjemahan tetap sinkron pada Git push berikutnya.

Masalah umum

next-intl mengharapkan struktur pesan tertentu

Solusi: globalize.now mendeteksi konvensi next-intl secara otomatis dan menulis JSON yang cocok dengan folder bahasa yang kamu konfigurasi, sehingga pembentukan ulang manual berkurang.

Saya sudah punya beberapa teks yang diterjemahkan. Apakah globalize.now menimpanya?

Solusi: Kunci yang sudah ada dipertahankan sebisa mungkin, dan teks baru ditambahkan secara bertahap sehingga penerjemah tidak kehilangan pekerjaan sebelumnya.

Pertanyaan yang sering diajukan

Apakah globalize.now bisa dipakai dengan next-intl dan next-i18next?

Ya. globalize.now berfokus pada struktur repositori (kunci, katalog JSON, dan titik pemanggilan di komponen), sementara next-intl atau next-i18next tetap memuat pesan saat runtime. Pilih runtime yang cocok dengan model routing yang kamu pakai; globalize.now menyesuaikan outputnya. Kamu tetap menjalankan npx skills add globalize-now/globalize-skills sekali saat bootstrap proyek, kecuali kamu sengaja ingin memperbarui Skill.

Apakah globalize.now mendukung App Router dan Pages Router?

Ya. Skill agen mendeteksi gaya router yang kamu pakai, lalu menyesuaikan ekstraksi dengan file layout, route handler, dan provider yang tepat. globalize.now tidak menggantikan routing Next.js; ia memastikan teks yang mengalir lewat route tersebut sudah memakai kunci terjemahan. Setelah setup, server component dan client component di App Router sama-sama merujuk ke file locale yang dibutuhkan runtime kamu.

Bisakah saya memakai globalize.now di aplikasi Next.js yang sudah punya i18n sebagian?

Bisa. Arahkan agen ke repo, lalu ia memperluas bundel pesan yang ada dan mengisi bagian yang masih berupa teks hardcode. Kasus ini umum ketika baru halaman marketing yang diterjemahkan. globalize.now menggabungkan kunci baru tanpa membuang terjemahan lama, jadi tim bisa bermigrasi layar demi layar.

Apakah globalize.now memperlakukan server component dan client component secara berbeda?

globalize.now mengubah teks hardcode menjadi helper yang dipakai stack-mu di setiap batas server/client, sesuai aturan Next.js tentang di mana hook dan provider boleh berjalan. Output JSON tetap dipakai bersama oleh bundel server dan client, jadi katalog tidak perlu diduplikasi. Untuk menandai client component saat interaktivitas dibutuhkan, tetap ikuti dokumentasi Next.js.

Bagaimana globalize.now terintegrasi dengan static generation di Next.js?

File bahasa disimpan di Git, sehingga `next build` tetap membundel JSON yang sama dengan yang sudah diimpor rute SSG atau SSR-mu lewat next-intl. globalize.now tidak mengubah pipeline static generation, hanya memastikan teks berasal dari file data, bukan teks hardcode. Saat ada teks baru, push berikutnya ke Git memperbarui terjemahan sebelum deploy selanjutnya.

Apakah saya harus menginstal next-intl sebelum menjalankan npx skills add globalize-now/globalize-skills?

Menginstal next-intl lebih dulu ideal jika kamu sudah tahu itu runtime-mu, karena agen bisa langsung memasang provider. Kalau belum memilih library, kamu tetap bisa menjalankan npx skills add globalize-now/globalize-skills (Skill akan membantu merekomendasikan stack), tetapi kamu mungkin perlu mengulang setup setelah dependensi terpasang. Kedua jalur berakhir sama: kunci tersimpan di Git dan sinkron saat push.

Coba globalize.now dengan Next.js

Mulai dari root proyek:

npx skills add globalize-now/globalize-skills --all

Kembali ke beranda untuk konteks produk dan harga

Integrasi lainnya

Mulai gratis