Cara terbaik melokalisasi aplikasi Lovable di stack klasik Vite adalah mengekstrak teks hardcode ke katalog PO Lingui yang di-commit, bukan menempelkan widget terjemahan runtime. Aplikasi Lovable-mu adalah React SPA yang dirender di klien, jadi tidak ada render server yang bisa dimanfaatkan, dan opsi yang tahan lama adalah file terjemahan yang berada di repomu sendiri dan ikut terkirim bersama build. globalize.now adalah infrastruktur lokalisasi bertenaga AI yang menangani ekstraksi dan menjaga katalog tetap sinkron di setiap Git push, sehingga kamu cukup menyiapkannya sekali dan tidak perlu lagi mengurus file bahasa secara manual.


Aplikasi Lovable-mu memakai stack yang mana, Vite klasik atau TanStack Start?

Buka struktur file terlebih dahulu, karena Lovable menyediakan dua stack berbeda dan masing-masing butuh setup i18n yang berbeda. Jika kamu melihat src/pages/Index.tsx, src/main.tsx, dan vite.config.ts, berarti kamu memakai stack klasik Vite plus React SPA, yaitu default Lovable. Proyek TanStack Start justru punya src/routes/, src/router.tsx, src/routeTree.gen.ts, dan src/server.ts.

Stack dipilih saat proyek dibuat dan tidak bisa diganti sesudahnya, jadi keputusan ini sebenarnya sudah ditentukan untukmu. Stack klasik Vite merender sepenuhnya di browser dan tidak mengambil data di sisi server secara default. Panduan ini membahas SPA Vite klasik tersebut. Jika file-mu cocok dengan struktur TanStack Start, ikuti panduan i18n TanStack Start untuk Lovable, karena server rendering mengubah cara terjemahan dimuat.


Mengapa aplikasi Lovable berbasis Vite SPA dilewatkan tooling i18n?

Karena perhatian tooling beralih ke default terbaru Lovable, yaitu TanStack Start plus SSR, sehingga Vite SPA klasik kurang terlayani, padahal masih menjadi stack Lovable yang paling umum. Dalam beberapa bulan terakhir, tool lokalisasi yang menyasar Lovable, termasuk Lovalingo, Intlayer, dan Paraglide, semuanya mengarahkan panduannya ke TanStack Start dengan server-side rendering.

Akibatnya ada celah. SPA yang dirender di klien punya batasan nyata yang diabaikan panduan SSR: tidak ada render server untuk menyisipkan markup terjemahan, seluruh bundle dimuat di browser, dan script yang dimuat belakangan menimpa UI bahasa Inggris. Kabar baiknya, stack klasik punya jawaban yang bersih dan didukung dengan baik, yang jarang didengar para builder, karena tool yang paling ramai sibuk mengejar stack yang lain.


Apa beda katalog yang di-commit dengan widget terjemahan runtime?

Katalog yang di-commit adalah file terjemahan yang masuk ke repositori dan dibundel saat build, sedangkan widget runtime adalah script pihak ketiga yang menukar teks di browser setelah UI bahasa Inggris selesai dimuat. Perbedaan itu menentukan tiga hal penting untuk SPA Vite.

Pertama, flash dan layout shift: widget menampilkan bahasa Inggris lalu menulis ulang teksnya, sehingga pengguna melihat pergantian yang terlihat jelas dan layout bisa melompat. Katalog yang di-commit merender bahasa yang benar sejak first paint. Kedua, indexability: teks yang terkirim di dalam build adalah bagian dari source-mu, sedangkan teks widget disisipkan belakangan dan lebih sulit dibaca crawler. Ketiga, kepemilikan: katalog yang di-commit adalah file milikmu di repomu, jadi tidak ada layanan eksternal yang harus tetap hidup agar aplikasimu tetap berbahasa Jerman atau Jepang.


Bagaimana cara menambahkan i18n ke aplikasi Lovable Vite dengan Lingui?

Tambahkan Lingui sebagai lapisan i18n, bungkus teksmu, dan biarkan plugin Vite-nya mengompilasi katalog. Lingui adalah framework i18n ringan dengan plugin Vite khusus dan format katalog berbasis PO, yang persis dibutuhkan SPA yang dirender di klien.

Pertama, pasang paketnya. Lingui memisahkan CLI, plugin Vite, dan runtime React-nya:

npm install --save-dev @lingui/cli @lingui/vite-plugin @rolldown/plugin-babel
npm install @lingui/core @lingui/react

Selanjutnya, daftarkan plugin di vite.config.ts dan tambahkan lingui.config.ts yang mengarah ke folder source dan locale-mu:

// vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import { lingui } from "@lingui/vite-plugin";

export default defineConfig({
  plugins: [react(), lingui()],
});
// lingui.config.ts
import { defineConfig } from "@lingui/cli";

export default defineConfig({
  locales: ["en", "de", "fr"],
  sourceLocale: "en",
  catalogs: [
    {
      path: "src/locales/{locale}/messages",
      include: ["src"],
    },
  ],
});

Lalu bungkus teks JSX hardcode dengan macro Trans alih-alih membiarkannya sebagai string mentah:

// before
<h1>Create your account</h1>

// after
import { Trans } from "@lingui/react/macro";
<h1><Trans>Create your account</Trans></h1>

Sekarang ekstrak. CLI memindai direktori src dan menulis satu katalog PO per locale, misalnya src/locales/en/messages.po:

npx lingui extract

Isi field msgstr untuk setiap bahasa, atau serahkan langkah itu ke lapisan otomatis (lihat bagian berikutnya). Kamu tidak perlu menjalankan perintah compile terpisah, karena @lingui/vite-plugin mengompilasi katalog PO secara langsung saat development dan build.

Terakhir, tambahkan pengganti bahasa dengan mengaktifkan locale saat runtime:

import { i18n } from "@lingui/core";
i18n.activate("de");

Itulah seluruh alurnya untuk stack klasik Vite: pasang, bungkus, ekstrak, terjemahkan, ganti bahasa. Semuanya, kecuali terjemahannya sendiri, berada di repomu.


Bagaimana globalize.now mengotomatiskan ini di setiap push?

globalize.now menghilangkan langkah ekstrak dan isi manual dengan memantau repomu dan mengerjakannya di setiap Git push. globalize.now menemukan teks hardcode baru di codebase Lovable-mu, membuat kunci dan entri PO yang dibutuhkan Lingui, menghasilkan terjemahan, lalu meng-commit katalog yang diperbarui, sehingga folder src/locales selalu mutakhir tanpa kamu menjalankan perintah apa pun.

Hubungkan repositori di globalize.now sekali, dan pemantauan langsung berjalan. Untuk menyiapkannya dari editor, pasang Skill-nya:

npx skills add globalize-now/globalize-skills

Khusus di dalam Lovable, tambahkan Skill lovable-i18n di workspace-mu, lalu minta Lovable menyiapkan i18n. Runtime tetap Lingui, jadi cara aplikasimu merender tidak berubah. Yang berubah: kamu tidak perlu lagi mengurus file bahasa secara manual. Ini model yang sama, yaitu siapkan sekali, sinkron di setiap push, yang mendasari alur kerja vibe coder dan setup developer kami.

Harganya mudah dipahami untuk builder solo: paket Starter seharga €20 per bulan dan sudah termasuk kredit €20, tanpa biaya per seat dan per bahasa. Workspace baru mendapat kredit uji coba €5 satu kali, berlaku 14 hari, cukup untuk menerjemahkan aplikasi kecil dari awal sampai akhir.


Perlukah memakai widget runtime saja? Pelajaran dari Lovalingo

Tidak, jika kamu ingin terjemahanmu bertahan lebih lama dari satu vendor mana pun. Widget terjemahan runtime memang praktis pada awalnya, tetapi membuat aplikasimu bergantung pada server pihak lain yang harus tetap online, dan ketergantungan itu punya risiko kegagalan yang nyata.

Lovalingo, widget runtime yang populer di kalangan builder Lovable, mengumumkan akan tutup pada 31 Agustus 2026, tanpa menerima pendaftaran baru dan tanpa pengganti yang disebutkan. Panduan migrasinya sendiri meminta pengguna beralih ke internasionalisasi yang dimiliki proyek, yang persis pendekatan katalog yang di-commit di panduan ini. Saat vendor widget tutup, terjemahan yang disisipkan berhenti dan UI kembali ke bahasa Inggris. File di repomu tidak begitu. Jika kamu sudah memakai widget, panduan migrasi penutupan Lovalingo kami menjelaskan langkah pindahnya, dan masalah terjemahan rusak di setiap push yang lebih luas menjelaskan mengapa katalog yang di-commit lebih unggul untuk aplikasi buatan AI.

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