Bir Replit uygulamasını çok dilli yapmak için Git deposunu GitHub'a bağlar ve çeviri kataloglarını bu depoda commit'lenmiş dosyalar olarak tutarsın. Replit her Agent checkpoint'ini zaten bir Git commit'i olarak saklar; yani dilleri düşünmeden önce depo hazırdır. Asıl iş, depoyu GitHub'a taşımak ve katalogların aynı geçmiş üzerinden geri gelmesini sağlamaktır. globalize.now yapay zekâ destekli yerelleştirme altyapısıdır: anahtarları ve dil dosyalarını üretir, onları uygulamanın zaten kullandığı runtime kütüphanesi servis eder. Runtime yolunda dashboard yoktur; sayfa yüklendikten sonra onu çeviren bir şey de yoktur.
Agent'tan uygulamayı çevirmesini istemek neden işe yaramıyor?
Çünkü çevirinin gideceği bir yer yok. Replit Agent'tan bir dashboard istediğinde bileşene <h2>Your bookings</h2> yazar; katalogdan çekilen bir arama değil. Her başlık, buton, boş durum, toast ve doğrulama hatası, prompt verdiğin dilde bir literal olarak JSX'e düşer.
Sonra Agent'tan “uygulamayı Afrikaanscaya çevir” dediğinde iki yarım sonuçtan birini alırsın: metni değiştirilmiş ikinci bir bileşen kopyası ya da Agent'ın bakmış olduğu ekranları kapsayan, elle yazılmış bir translations nesnesi. İkisi de bir dil katmanı değildir. Sonraki özellik yine İngilizce çıkar. Aynı tekrarı Cursor koda gömülü metin eklemeye devam ediyor yazısında belgelemiştik; Replit Agent de farklı davranmaz, çünkü arkadaki mimariyi değil, önündeki prompt'u çözer.
Çözüm yapısal: metinlere anahtar ver, çevirileri dosyalara koy ve runtime'ın bu dosyalardan okumasını sağla. Bir kod tabanında “çok dilli” demek budur ve tek seferlik bir değişikliktir.
Replit Agent aslında ne üretiyor?
Sıradan bir web projesi; iyi haber de bu. Replit'in hazır uygulama türleri front end'de ShadCN UI'lı React etrafında kurulur, genellikle aynı projede bir Express sunucusuyla eşleşir ve hepsi TypeScript'tir. Eylül 2025'ten beri Agent, içe aktarılan GitHub depoları dahil getirdiğin her framework'le de çalışıyor; yani Next.js ya da Vue projesi mümkün, ama varsayılan yol hâlâ React stack'i.
Yerelleştirme açısından önemli olan tek şey stack'tir ve bu standart bir zemindir. React, Vite ve TypeScript i18n ekosisteminde en çok desteklenen kombinasyondur: i18next, Lingui ve react-intl doğrudan bunu hedefler. Agent sana bunun yerine bir Next.js uygulaması kurduysa seçim next-intl, react-i18next ve Lingui arasındadır; bu karşılaştırma ayrı bir yazının konusu.
Yalnızca front end geliştiren araçlardan farkı projenin ikinci yarısıdır. Bir Replit uygulamasında genellikle sunucu da vardır ve sunucunun da metinleri vardır. Aşağıda bunu anlatıyoruz.
Replit uygulamasında Git deposu nerede?
Zaten orada. Replit'in sürüm kontrolü altta Git'tir ve Agent checkpoint'leri bu depodaki commit'lerdir. Agent bir özelliği bitirip sana geri dönüş noktası sunduğunda aslında commit atmıştır. Replit'in kendi belgeleri de harici depolarla çalışırken uzun vadeli takip için sıradan Git commit'lerine geçmeyi önerir; burada durum tam olarak bu.
GitHub'a taşımak için:
- Proje editörünün Tools bölümünden Git aracını ekle.
- Bağlı servisler altından GitHub hesabını bağla, ardından depoyu Git panelinden bağla. Proje hiç başlatılmadıysa panel önce bunu yapmayı önerir.
- Push et. Panel tek tıkla push eder ve Shell'de çalıştırdığın her şeyle senkronize kalır; yani
git push origin mainda çalışır.
Replit GitLab ve Bitbucket'ı da destekler, akış aynıdır. Önemli olan sağlayıcı değil; deponun artık bir yerelleştirme işinin PR açabileceği bir yerde durması.
Bunu tek bir metne dokunmadan önce yap. Yerelleştirme dosya işidir ve bir diff, bunu incelemek için doğru yerdir.
Bir Replit uygulaması için “dashboard olmadan” ne demek?
Çevrilen metinlerin depoda dosya olarak durması ve uygulamanın bunları diğer tüm varlıklar gibi servis etmesi demek. Script etiketi yok, sayfa yüklenirken dış çağrı yok, ziyaretçiyle metinlerin arasında duran bir vendor hesabı yok.
Alternatif, sayfa çizildikten sonra metni değiştiren bir runtime widget'ıdır. Maliyetleri yapısaldır: ilk çizim İngilizcedir, çevrilmiş metin tarayıcıların ilk okuduğu HTML'de yer almaz, üçüncü taraf bir script production yolunda durur ve metinlerin vendor'ın deposunda tutulur, yani ayrılmak için dışa aktarmak gerekir. Bu argümanın Lovable versiyonu Bir Lovable uygulamasını dashboard olmadan yerelleştir yazısında ve Replit'e olduğu gibi uyarlanabilir.
Burada bunun daha da önemli olmasının Replit'e özgü bir nedeni var. Replit uygulamayı senin için deploy eder; Replit domain'indeki çalışan kopya, deploy anında projede ne varsa odur. Bir widget bu deploy'u dışarıdan çevirirdi. Katalogları depoda tutarsan deploy zaten her dili içerir ve Replit önizlemesi Almanca sürümü yayına almadan önce görmeni sağlar.
Bunun bir ödünü var ve söylemekte fayda var: metin değişikliği bir kaydet butonu değil, commit ve yeniden deploy demek. Replit'ten tek başına yayın yapan biri için bu önemsiz; canlı metni projeye dokunmadan düzenlemeyi bekleyen biri içinse bir kısıt.
Depo odaklı kurulum nasıl çalışır?
Depoyu globalize.now uygulamasında bağla. Dönüştürme kod tabanı üzerinde bir kez çalışır: koda gömülü metinler anahtarlı katalog birimlerine dönüşür ve bileşenler literal tutmak yerine bir runtime kütüphanesinden okumaya başlar. Bu tek seferlik bir işlemdir, sonradan yeniden çalışmaz.
Dönüştürmeden sonra push işleri, uygulama büyüdükçe yeni katalog birimlerini çevirir. Agent'a yeni bir ayarlar sayfası yaptır, push et; yeni birimler çevrilir, mevcutlar yerinde kalır. Kataloglar, runtime kütüphanesine göre JSON ya da PO olarak, her değişiklik gibi incelediğin bir PR içinde commit'lenmiş dosyalar halinde geri gelir.
Kategori karışık olduğu için iki sınır çizelim. globalize.now runtime kütüphanesinin yerine geçmez; i18next, Lingui ve next-intl işini yapmaya devam eder. DeepL ile yarışan bir çeviri motoru da değildir. Anahtarları ve dil dosyalarını üreten aradaki katmandır. İşleyişin ayrıntıları geliştirici genel bakışında.
Çeviriler Replit'e nasıl geri döner?
Aynı Git paneli üzerinden, ters yönde. Bu adım Bolt ya da Lovable'dan farklıdır, çünkü Replit aynı zamanda uygulamanın çalıştığı yerdir.
- PR'ı GitHub'da incele ve merge et.
- Replit Git panelinde Pull'u seç. Bu arada sen ya da Agent aynı dosyaları değiştirdiyse panel çakışmaları vurgular; merge'ü tamamlamadan önce bunları editörde çözersin.
- Yeniden deploy et. Kataloglar artık projenin parçası olduğu için deploy her dili içerir.
Replit'e özgü bir uyarı: Agent checkpoint'leri dosyalar dahil projenin tüm durumunu geri yükler. Çeviri branch'ini çekmeden önce oluşturulmuş bir checkpoint'e dönersen kataloglar da gider. Merge'ü bir kilometre taşı say, ardından Agent'a bir checkpoint oluşturt ve geri dönmen gerekirse eskisine değil bu checkpoint'e dön.
Hangi metinler sunucuda yaşar?
Front end'in JSX olarak hiç görmediği metinler. Express back end'li bir Replit uygulamasının ikinci bir metin yüzeyi vardır: API hata mesajları, doğrulama yanıtları, e-posta konuları, bildirim gövdeleri, CSV başlıkları ve sunucunun göndermeden önce biçimlendirdiği her şey. Front-end kataloğu bunlara ulaşmaz, widget ise hiç göremez, çünkü bunlar DOM'da asla yer almaz.
Desen istemcideki gibi, sadece sunucu tarafında uygulanır. Sunucuya runtime kütüphanesinin bir kopyasını ver, ziyaretçinin locale bilgisini istekten oku (Accept-Language header'ı ya da kullanıcı kaydındaki bir locale alanı) ve yanıtları metin sabitlerinden değil, katalogdan üret. Anahtar namespace'i ortak kalır; böylece errors.booking.overlap bir toast mesajında da 409 yanıtında da aynı anlama gelir.
Bunu atlarsan uygulama ilk hataya kadar çok dilli görünür, sonra İngilizce konuşmaya başlar.
İkinci bir dil eklemeden önce neleri kontrol etmelisin?
Dönüşümden önce bu listeyi gözden geçir. Beş dil devreye girdikten sonra düzeltmek yerine şimdi düzeltmek her madde için daha ucuz:
- Birleştirilmiş metinler.
"Welcome back, " + user.namebir çevirmen tarafından yeniden sıralanamaz. Bunun yerine interpolasyon kullan. - Çoğul biçimleri. İngilizcede iki biçim var, Lehçede üç, Arapçada altı.
count === 1üzerinde üçlü operatör kullanmak çoğu dilde yanlış sonuç verir. - Tarih, sayı ve para birimi. Hem istemcide hem sunucuda metin birleştirmek yerine
Intlkullan. - Yerleşim. Almanca ve Fince metinler İngilizceden uzun çıkar. Sabit genişlikli butonlar bozulur, Tailwind sınıfları da metin gelene kadar sorunsuz görünür.
- Sağdan sola yazım. Yol haritanda Arapça ya da İbranice varsa kararı şimdi ver. RTL desteğini sonradan eklemek en pahalı iştir.
- Katalog kayması. Kataloglar oluştuktan sonra bir dile eklenip diğerlerine eklenmeyen anahtar sessiz bir hatadır. Çeviri dosyaları neden senkronizasyondan çıkar yazısı bunun nasıl olduğunu ve push job'unun buna karşı ne yaptığını anlatıyor.
Fiyatlandırmada kullanıcı başına, dil başına veya proje başına ücret yoktur; dil sayısı bir bütçe kalemi değil, ürün kararıdır. Güncel rakamlar fiyatlandırma sayfasında. Aynı adımları diğer araçlarda görmek için vibe coder'lara genel bakış sayfasından başlayabilirsin.
Nereden başlamalı?
Replit projen zaten GitHub'a bağlıysa sıradaki adım araç seçimi değil, o depo üzerinde bir dönüşüm çalıştırmak. Henüz bağlı değilse bundan önceki adım Git paneli.
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