Klasik Vite stack'inde yazılmış bir Lovable uygulamasını yerelleştirmenin en iyi yolu, üstüne bir runtime çeviri widget'ı eklemek değil, koda gömülü metinleri commit'lenmiş Lingui PO kataloglarına çıkarmaktır. Lovable uygulaman istemcide render edilen bir React SPA'dır; bağlanabileceğin bir sunucu render'ı yoktur. Kalıcı çözüm, kendi deponda duran ve build'inle birlikte gelen çeviri dosyalarıdır. globalize.now, çıkarma işini yapan ve bu katalogları her Git push'ta senkron tutan yapay zekâ destekli yerelleştirme altyapısıdır. Bir kez kurarsın, dil dosyalarını bir daha elle yönetmezsin.
Lovable uygulaman hangi stack'te: klasik Vite mi, TanStack Start mı?
Önce dosya ağacını aç; çünkü Lovable iki farklı stack sunuyor ve her biri farklı bir i18n kurulumu ister. src/pages/Index.tsx, src/main.tsx ve vite.config.ts dosyalarını görüyorsan Lovable'ın varsayılanı olan klasik Vite + React SPA stack'indesin. TanStack Start projelerinde ise src/routes/, src/router.tsx, src/routeTree.gen.ts ve src/server.ts bulunur.
Stack proje oluşturulurken seçilir ve sonradan değiştirilemez; yani bu karar senin yerine zaten verilmiş. Klasik Vite stack'i tamamen tarayıcıda render edilir ve varsayılan olarak sunucu tarafında veri çekmez. Bu kılavuz o klasik Vite SPA'yı ele alıyor. Dosyaların TanStack Start yapısına uyuyorsa, sunucu render'ı çevirilerin yüklenme biçimini değiştirdiği için bunun yerine Lovable için TanStack Start i18n kılavuzunu izle.
Vite SPA Lovable uygulamaları i18n araçlarınca neden atlanıyor?
Çünkü araçların ilgisi Lovable'ın daha yeni TanStack Start + SSR varsayılanına kaydı ve klasik Vite SPA, hâlâ en yaygın Lovable stack'i olmasına rağmen ortada kaldı. Son aylarda Lovable'ı hedefleyen yerelleştirme araçlarının, yani Lovalingo, Intlayer ve Paraglide'ın hepsi kılavuzlarını sunucu tarafı render'lı TanStack Start'a çevirdi.
Bu da bir boşluk bırakıyor. İstemcide render edilen bir SPA'nın SSR kılavuzlarının göz ardı ettiği gerçek kısıtları var: çevrilmiş markup'ı enjekte edecek bir sunucu render'ı yok, bundle'ın tamamı tarayıcıda yükleniyor ve geç yüklenen her script İngilizce bir arayüzün üstüne yazıyor. İyi haber şu: klasik stack'in temiz ve iyi desteklenen bir çözümü var, ama çoğu geliştirici bunu hiç duymuyor; çünkü en gürültülü araçlar öbür stack'in peşinde koşuyor.
Commit'lenmiş kataloglarla runtime çeviri widget'ı arasındaki fark nedir?
Commit'lenmiş kataloglar deponda duran ve build sırasında pakete eklenen çeviri dosyalarıdır. Runtime widget'ı ise İngilizce arayüz yüklendikten sonra tarayıcıda metni değiştiren üçüncü taraf bir script'tir. Bu fark, bir Vite SPA için önemli üç şeyi belirler.
Birincisi, anlık İngilizce görünümü ve layout kayması: widget önce İngilizce'yi gösterip sonra yeniden yazar; kullanıcı gözle görülür bir geçiş yaşar ve layout zıplayabilir. Commit'lenmiş kataloglar doğru dili ilk çizimde render eder. İkincisi, indekslenebilirlik: build'inin içinde gelen metinler kaynak kodunun parçasıdır, widget metni ise geç enjekte edilir ve botların okuması daha zordur. Üçüncüsü, sahiplik: commit'lenmiş kataloglar kendi deponda duran kendi dosyalarındır; uygulamanın Almanca ya da Japonca konuşmaya devam etmesi için dışarıda hiçbir şeyin ayakta kalması gerekmez.
Lingui ile Lovable Vite uygulamasına i18n nasıl eklenir?
Lingui'yi i18n katmanın olarak ekle, metinlerini sar ve katalogları Vite eklentisinin derlemesine bırak. Lingui, özel bir Vite eklentisi ve PO tabanlı katalog formatı olan hafif bir i18n framework'üdür; istemcide render edilen bir SPA'nın tam ihtiyacı olan da bu.
Önce paketleri kur. Lingui, CLI'ını, Vite eklentisini ve React runtime'ını ayrı paketlere böler:
npm install --save-dev @lingui/cli @lingui/vite-plugin @rolldown/plugin-babel
npm install @lingui/core @lingui/react
Sonra eklentiyi vite.config.ts içine kaydet ve kaynak ile locales klasörünü gösteren bir lingui.config.ts ekle:
// 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"],
},
],
});
Ardından koda gömülü JSX metinlerini çıplak string olarak bırakmak yerine Trans makrosuyla sar:
// before
<h1>Create your account</h1>
// after
import { Trans } from "@lingui/react/macro";
<h1><Trans>Create your account</Trans></h1>
Şimdi çıkarma zamanı. CLI src dizinini tarar ve her dil için bir PO kataloğu yazar; örneğin src/locales/en/messages.po:
npx lingui extract
Her dil için msgstr alanlarını doldur ya da bu adımı otomatik bir katmana devret (sonraki bölüme bak). Ayrı bir derleme komutu çalıştırmazsın; çünkü @lingui/vite-plugin PO kataloglarını geliştirme ve build sırasında anında derler.
Son olarak runtime'da bir dil etkinleştirerek dil değiştirici ekle:
import { i18n } from "@lingui/core";
i18n.activate("de");
Klasik Vite stack'inin döngüsü bu kadar: kur, sar, çıkar, çevir, değiştir. Çevirilerin kendisi dışında her şey deponda durur.
globalize.now bunu her push'ta nasıl otomatikleştirir?
globalize.now deponu izleyip elle yapılan çıkarma ve doldurma adımlarını senin yerine her Git push'ta yapar. Lovable kod tabanında yeni koda gömülü metinleri bulur, Lingui'nin beklediği anahtarları ve PO girdilerini üretir, çevirileri oluşturur ve güncellenen katalogları geri commit'ler. Böylece komut çalıştırmadan src/locales klasörün hep güncel kalır.
Depoyu globalize.now'da bir kez bağla, izlemeye başlar. Kurulumu editöründen yapmak istersen skill'leri kur:
npx skills add globalize-now/globalize-skills
Özellikle Lovable içinde, çalışma alanına lovable-i18n becerisini ekle, ardından Lovable'dan i18n kurulumunu yapmasını iste. Çalışma zamanı yine Lingui olarak kalır; uygulamanın nasıl render edildiği hiç değişmez. Değişen tek şey, dil dosyalarının peşinde koşmayı bırakmandır. Vibe coder iş akışımız ve geliştirici kurulumumuz de aynı modele dayanır: bir kez kur, her push'ta senkronla.
Tek başına geliştiren biri için fiyatlandırma net: Starter plan ayda €20'dur ve €20 kredi içerir; kullanıcı başına ve dil başına ücret yoktur. Yeni çalışma alanlarına 14 gün geçerli, tek seferlik €5 deneme kredisi verilir; bu, küçük bir uygulamayı baştan sona çevirmeye yeter.
Bunun yerine runtime widget'ı kullanmalı mısın? Lovalingo'nun dersi
Çevirilerinin tek bir vendor'dan uzun yaşamasını istiyorsan hayır. Runtime çeviri widget'ı başta pratiktir, ama uygulamanı başkasının sunucusunun ayakta kalmasına bağımlı yapar ve bu bağımlılığın gerçek bir arıza senaryosu vardır.
Lovable kullanıcıları arasında yaygın bir runtime widget'ı olan Lovalingo, 31 Ağustos 2026'da kapanacağını duyurdu; yeni kayıt alınmıyor ve halef olarak anılan bir ürün de yok. Kendi taşıma yönergesi kullanıcılara projenin kendisine ait uluslararasılaştırmaya geçmelerini söylüyor; bu, tam olarak bu kılavuzdaki commit'lenmiş katalog yaklaşımı. Bir widget'ın vendor'ı kapandığında enjekte edilen çeviriler durur ve arayüz İngilizce'ye döner. Deponun içindeki dosyalar ise yerinde kalır. Şu anda bir widget kullanıyorsan Lovalingo kapanışı taşıma kılavuzumuz geçişi adım adım anlatıyor; her push'ta çevirilerin bozulması sorunu ise commit'lenmiş katalogların yapay zekâyla üretilen uygulamalarda neden kazandığını açıklıyor.
globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.
globalize.now'ı ücretsiz dene