Deponda zaten next-intl, react-i18next, i18next veya Lingui kuruluysa (diskte dil klasörleri, package.json içinde bağımlılıklar, middleware veya yapılandırma dosyaları), sıfırdan başlıyormuşsun gibi davranan başka bir araca ihtiyacın yok. globalize.now, yapay zekâ destekli yerelleştirme altyapısıdır. L1 (zaten uluslararasılaştırılmış) modunda ürün, mevcut yapını bozabilecek kurulum iskelesini atlar ve senkron modunda çalışır: kaynak dilini okur, push'ta diğer dilleri karşılaştırır, eksikleri doldurup pull request açar. Bu yazıda o modun nelere dokunduğunu, nelere dokunmayı reddettiğini ve tespit yanlış çıktığında ne yapacağını anlatıyoruz.

i18n tavsiyelerinin çoğu neden sıfırdan başladığını varsayar?

i18n araçlarının pazarlama metinleri hâlâ “greenfield” senaryosunu esas alır: kurulu kütüphane yok, dil dosyası yok, metin çıkarma yapılmamış. Canlı ortamdaki kod tabanlarının çoğu bu noktada değil.

Son birkaç haftada birbirinden bağımsız üç ilk temas oturumu aynı tabloyla çıktı: ekip i18n'i bir kez denedi, yarım yamalak bir şey elde etti ve bıraktı. Çünkü sökmek ve baştan yapmak, dağınıklıkla yaşamaktan daha kötü geldi.

Bu sensen, bu yazı tam senin için yazıldı.

Yarım uluslararasılaştırılmış bir kod tabanı gerçekte nasıl görünür?

Şu örüntüler tekrar tekrar karşımıza çıkıyor (ayrıntılar anonimleştirildi):

  • Çoğu bileşenin t() kullandığı ama ilk migrasyon dalgası hiç bitmediği için eski route'ların hâlâ koda gömülü İngilizce yayınladığı bir Next.js + next-intl uygulaması.
  • Dil dosyaları var ama yalnızca İngilizce değerler içeren bir React + i18next projesi: çeviri hep gelecek çeyreğe kalmıştı.
  • en.json dosyasının dolu, es.json dosyasının ise neredeyse boş olduğu bir messages/ ağacı.
  • Routing yalnızca yarı migre edildiği için ara sıra 404 veren, layout'a bağlanmış bir dil değiştirici.

Bu projelerin hiçbirinin globalize.now'ın baştan başlamasına ihtiyacı yok. Asıl ihtiyaçları, işi bitirmesi.

L0 versus L1 setup pathA decision tree showing that when globalize.now detects existing i18n on first run, it skips four destructive setup steps and goes straight to translating missing keys.your repoDETECTIONfirst-run scan of package.json + repoNO i18n FOUNDL0 pathi18n DETECTEDL1 pathinstall libraryextract stringsgenerate locale filesinject switchertranslateinstall libraryextract stringsgenerate locale filesinject switchertranslateSKIPPEDPR on every push
Tespit, kurulum akışını dallandırır. L0 beş adımın hepsini çalıştırır; L1 dördünü atlayıp doğrudan senkronizasyona geçer.

globalize.now ilk çalıştırmada hangi sinyalleri tarar?

Tespit tek adımda değil, iki adımda gerçekleşir.

Önce globalize.now'ı depoya bağla. Uygulama içinden bağlamak, tespiti ve tek seferlik dönüşümü senin yerine çalıştırır. Bu işi agent'ının yerelde yapmasını tercih edersen Skill'leri kur. Bu, .claude/skills/ altına birkaç playbook dosyası bırakır ve deponda başka hiçbir şeyi değiştirmez:

npx skills add globalize-now/globalize-skills

Sonra agent'ına prompt ver: Claude Code, Cursor veya Codex. Agent kurulu Skill'leri okur ve deponu taramak için kullanır:

Set up localization for my project

Tespitin asıl çalıştığı yer bu ikinci adım. Agent şunlara bakar:

  • package.json bağımlılıkları: next-intl, react-i18next, i18next, @lingui/core, @lingui/react, @lingui/macro ya da herhangi bir i18next-* eklentisi.
  • Dil klasörleri: deponun kökünde messages/, bir locales/ klasörü ya da dil alt klasörleri olan src/i18n/.
  • Mevcut dil dosyaları: en.json, en.po, en.yml, en.yaml ya da kütüphanenin zaten beklediği varsayılan dil dosyası.
  • Framework'e özgü yapılandırma: i18n.config.ts, next-intl middleware'i, lingui.config.js ya da muadilleri.

Bu sinyallerden en az ikisi varsa proje L1 (zaten uluslararasılaştırılmış) sayılır ve kurulum akışı tam sıfırdan kurulum iskelesini çalıştırmak yerine farklı bir yola girer. Daha fazla ayrıntıyı mevcut i18n hakkındaki Yardım Merkezi makalesinde bulabilirsin.

L1 modu neleri değiştirmeyi reddeder?

İnsanların asıl merak ettiği kısım burası. L1 modunda globalize.now şunları yapmaz:

  • Bileşenlerde koda gömülü metinleri arayan geniş kapsamlı metin çıkarma taramasını çalıştırmaz.
  • Yeni çeviri anahtarları üretmez, commit'lediğin mevcut anahtar yapısını da yeniden düzenlemez.
  • Henüz yapılandırmadığın diller için dil dosyası oluşturmaz.
  • Dil seçici eklemez. Varsa kalır, yoksa biz eklemeyiz.
  • Routing, middleware veya framework yapılandırmanı senin yerine yeniden yazmaz.

Mevcut i18n kurulumun sana ait kalır. Bu modda onu refactor etmeyiz.

L1 senkronizasyon modu tespitten sonra ne yapar?

L1, önce senkronizasyon ilkesiyle çalışır. Tespit tamamlandıktan sonra:

  1. Mevcut dil dosyalarını okuyup anahtar yapısını ve hangi dilin kaynak dil olduğunu öğreniriz.
  2. GitHub deposunu globalize.now CLI'ı veya web uygulaması üzerinden bağlarsın.
  3. main branch'ine yapılan her push'ta kaynak dil dosyasını diğer dillerle karşılaştırırız. Eksik çeviriler, yapılandırdığın terim sözlüğüne ve stil kılavuzuna uyan AI çıktısıyla doldurulur.
  4. Güncellenmiş dil dosyalarıyla bir PR açılır. İncelersin ve merge edersin. Senin yerine asla merge etmeyiz.

Döngü bu kadar. Başında beklenecek çeviri paneli yok. Elle dışa aktarma yok. Dosya biçimleriyle uğraşmak yok.

Bunu Cursor ile üretilmiş bir Next.js uygulamasına 15 dakikada i18n nasıl eklenir? yazısındaki L0 anlatımıyla karşılaştır: aynı ürün, farklı giriş yolu.

Arayüzün yalnızca bir kısmı çeviri çağrıları kullanıyorsa ne olur?

Geçiş sürecinin ortasında olağan görünüm budur: yeni ekranlar t() kullanır, eski ekranlar hâlâ koda gömülü metin sızdırır. Sync modu dışında Skills hattı, anahtarı olan metinleri kilitli sayar: henüz bağlanmamış metinlere odaklanır ve mevcut anahtarları korur. Bu geçişin yarısındayken her hafta yayın yapan ekipler, loglarımızdaki tipik “karma L1” kullanıcısıdır.

Karmaşık bir kod ağacında agent ile tam dönüşümün hikâyesi için Bir AI agent gerçek bir monorepo'yu uluslararasılaştırınca ne olur? yazısına bak.

Kurulum akışı yine de her şeyi oluşturduysa ne yapmalısın?

Tespit mantığını sıkılaştırıyoruz, yanlış yolun devreye girmemesi gerekir. Yine de npx skills add globalize-now/globalize-skills dil klasörünü yeniden yazan, istemediğin bir dil değiştirici ekleyen veya yönlendirmeyi değiştiren 100+ dosyalık bir diff ürettiyse commit etme. Sağ alttaki geri bildirim widget'ını kullan, package.json bağımlılık listeni ve dil klasörlerinin nasıl düzenlendiğine dair kısa bir not gönder. Depoyu elle L1'e yönlendirebiliriz. Kendin kullanabileceğin bir --existing-i18n CLI bayrağı yakında geliyor.

Makinende geri dönüş için git restore ., gerekirse git clean -fd yeterli. Hiçbir şey push edilmedi, canlıyı etkileyen bir şey bozulmadı, agent yalnızca yerel branch'ine dokundu. Tam anlatım globalize_skills çok fazla değişiklik yaptı: ne oldu? yazısında.

“i18n'i denedik ama yarıda kaldı” hikâyesi neden artık olağan hâl?

Bu bir slogan değil, bir kalıp. Altı haftada birbirinden bağımsız üç ilk temas oturumu, aynı cümlenin üç hali: “Evet, denedik, şimdi berbat durumda.” On binlerce kullanıcılı bir Chrome eklentisi Kore'den gelen trafik artışıyla karşılaştı ve yarım kalmış bir next-intl geçişini başlattı. Lovable ile yapılmış bir uygulama, çok dilli destek eklerken kendi build'ini bozdu ve geri alındı. Vibe coder'ın yazdığı bir React + Vite deposu i18next'i bağladı, anahtarların kabaca üçte birini doldurdu ve bıraktı.

Kütüphane arayan, tertemiz bir L0 kod tabanı elbette var, ama darboğaz o değil. Darboğaz, bunu bir kez denemiş ve artık sonuçlarını kimsenin sahiplenmek istemediği kod tabanı.

L1 modu tam bu kod tabanı için var.

Ne kadar tutar?

Starter ayda €20 ve her ay €20 kredi içerir. Bu kredi çeviriler, QA incelemeleri ve dönüşümlerle harcanır, dönem sonunda kullanılmayan kredi sona erer. Ayda €249'luk, €100 dahil krediyle gelen bir Team planı da var. Yeni kuruluşlar 14 gün sonra sona eren, tek seferlik €5 deneme kredisi alır. Projen sıfırdan başlayan bir L0 olsun, üç yıllık dil borcu taşıyan bir L1 olsun, fiyat aynı: kullanım sağlayıcı maliyeti üzerinden ücretlendirilir, ilk commit'in ne kadar dağınık olduğu üzerinden değil.

Sırada hangi yazıları ve Yardım Merkezi dokümanlarını okumalıyım?

Trafiğinin zaten beklediği dilleri yayına al. globalize.now üzerinden depoyu bağla ya da Git push otomasyonunun mevcut bir ekip iş akışına nasıl oturduğunu oku.

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