Tek bir CLI kurarsın, Cursor'a tek bir prompt gönderirsin ve Next.js projen yalnızca İngilizce JSX'ten; [locale] yönlendirmesi, üretilmiş anahtarlar ve her push'ta otomatik senkronizasyonla çalışan çok dilli bir uygulamaya dönüşür. globalize.now, Cursor'un atladığı i18n işini yapan yapay zekâ destekli yerelleştirme altyapısıdır: koda gömülü metinleri çıkarır, next-intl anahtarlarını ve dil dosyalarını üretir, çevirileri her Git push'ta senkronize tutar. Aşağıdaki adım adım anlatım standart bir App Router projesi varsayar. Test deposundaki toplam süre: 13 dakika 40 saniye.
Cursor Next.js arayüzünü yazdığında tam olarak ne bozuk kalıyor?
Cursor mimariyi değil, çalışan arayüzü hedefler. Doğal dil talimatlarından kod üretir, kodun bazı bölümlerini prompt'larla günceller. Yani JSX, bir insanın hızlı bir prototip yazacağı gibi yazılır: metin satır içinde, anahtar yok, dil dosyası yok, [locale] segmenti yok.
Cursor'un ürettiği tipik bir Next.js sayfası şöyle görünür:
// app/page.tsx
export default function Home() {
return (
<main>
<h1>Welcome to Acme</h1>
<p>Get started in seconds.</p>
<button>Sign up</button>
</main>
)
}
Tek sayfada üç koda gömülü metin. Gerçek bir uygulamada onlarca bileşende yüzlercesi var. Pages Router eskiden yerleşik bir i18n yapılandırmasıyla gelirdi ama App Router varsayılan olunca bu kaldırıldı. Geriye middleware'i, dinamik route segment'lerini ve next-intl gibi harici bir kütüphaneyi kendin bağlamak kaldı. Cursor'un varsayılan davranışında bunların hiçbirini senin yerine yapan bir şey yok.
Sonuç, Lovable uygulamanın çevirileri neden her deploy'da bozuluyor yazımızda anlattığımız kalıp: kod tabanı büyür, koda gömülü metinler birikir ve “Spanyolcayı gelecek ay ekleriz” birkaç haftalık bir refactor'a dönüşür.
Cursor projesinde globalize.now'ı nasıl kurarım?
Deponu globalize.now'a bağla. İlk dönüştürme uygulamada bir kez çalışır: depoyu okur, koda gömülü metinleri anahtarlarla değiştirir ve incelemen için bir PR açar. Sonraki her push'ta yeni olan ne varsa çevrilir.
Bu ilk geçişi Cursor üzerinden yürütmek istersen skill'leri proje kök dizininden kur:
npx skills add globalize-now/globalize-skills
CLI stack'ini algılar, Cursor için doğru preset'i seçer ve agent kurallarını projene kurar. Next.js 16 App Router projesinde çıktı şöyle görünür:
✓ Stack detected: Next.js 16 (App Router)
✓ Editor detected: Cursor
✓ Preset selected: globalize-guide + next-intl
✓ Installed 4 skill files to .cursor/rules/
Done in 1.2s
Skill dosyaları mevcut Cursor kurallarının yanında durur. Cursor agent'ına metinlerin nasıl çıkarılacağını, next-intl kurallarıyla tutarlı anahtarların nasıl üretileceğini ve [locale] route segment'inin nasıl bağlanacağını anlatır. Hiçbir şey makinenden çıkmaz. Kodun yüklenmez.
Cursor yerine Claude Code veya Codex kullanıyorsan CLI o araçlar için eşdeğer Skill dosyalarını kurar. Sonrasındaki akış aynıdır.
Agent, Cursor kod tabanındaki koda gömülü metinleri nasıl çıkarır?
Cursor'un agent panelini aç ve tek bir prompt gönder:
Set up i18n for this project. Use English, Spanish, German, and Arabic.
Agent kurulu kuralları yükler, app/ ve components/ dizinlerini tarar ve rapor verir. 12 sayfalık bir pazarlama sitesinde rapor genellikle şöyle görünür:
Detected Next.js 16 with App Router.
Found 47 hardcoded strings across 12 components.
Best fit: next-intl. RTL required for Arabic.
Plan:
- Install next-intl
- Move app/* into app/[locale]/*
- Generate i18n/request.ts and middleware.ts
- Extract 47 strings to messages/en.json
- Convert JSX to useTranslations / getTranslations calls
Proceed? (y/n)
Agent, next-intl dokümantasyonunun zor kısım dediği işi yapar: middleware, dinamik route segment'leri, request yapılandırması ve bileşen bileşen çeviri hook'larına geçiş. Planı incelersin, onaylarsın. Agent değişiklikleri Cursor'un diff görünümünde kabul edebileceğin ya da reddedebileceğin tek bir çok dosyalı düzenleme olarak uygular.
next-intl anahtarlarını ve dil dosyalarını nasıl üretir?
Planı onayladıktan sonra agent standart next-intl yapısını üretir. Depoya dört yeni şey eklenir:
i18n/
request.ts
routing.ts
middleware.ts
messages/
en.json
es.json
de.json
ar.json
app/
[locale]/
layout.tsx
page.tsx
...
messages/en.json içinde, çıkarılan 47 metin bileşene veya route'a göre gruplanmış, ad alanlı anahtarlara dönüşür:
{
"Home": {
"heading": "Welcome to Acme",
"lede": "Get started in seconds.",
"signupCta": "Sign up"
}
}
Orijinal page.tsx, client bileşenlerde useTranslations, server bileşenlerde getTranslations kullanacak şekilde yeniden yazılır. Ayrım otomatiktir. Agent hangi bileşenlerde "use client" direktifi olduğunu okur ve doğru hook'u seçer.
İspanyolca, Almanca ve Arapça JSON dosyaları, agent'ın bileşen ve prop adlarından oluşturduğu terim sözlüğüne uyan ilk geçiş çevirileriyle üretilir. Marka terimleri İngilizce kalır. RTL desteği layout'a bağlanır: dir özniteliği dilden belirlenir, agent'ın tespit edebildiği yerlerde sabit sol/sağ yardımcı sınıfların yerini CSS mantıksal özellikleri alır.
Bu, bir production monorepo'da çalıştırdığımız uçtan uca kalıbın aynısıdır; ayrıntılar için Bir yapay zekâ agent'ı gerçek bir monorepo'yu uluslararasılaştırınca ne olur? yazımıza bak. Anlatım biçimi aynı, girdiler farklı.
İlk çalıştırmadan sonra Git push senkronizasyonu nasıl işler?
İlk çalıştırma tek seferliktir. Senkronizasyon sürekli.
Agent işini bitirince depoyu panelden globalize.now'a bağlarsın. Bundan sonra:
Push to main
↓
globalize.now diffs against last synced state
↓
New hardcoded strings get extracted + keyed
↓
Translations generated for every configured locale
↓
PR opened with locale file updates
Cursor'un açık olması gerekmez. Claude Code'un çalışıyor olması gerekmez. Senkronizasyon Git katmanında gerçekleşir, bu yüzden bir sonraki arayüz parçasını hangi araç yazarsa yazsın çalışır. Cursor gelecek hafta bir bileşeni yeniden üretip üç yeni buton eklediğinde, o butonlar bir sonraki PR'a çevrilmiş olarak gelir.
Elle dışa aktarma yok. İnceleme kuyruğu yok. CSV gidiş dönüşü yok. Ürün vaadi, globalize.now ile uygulamanı nasıl uluslararasılaştırırsın yazımızda belgelediğimizle aynı: bir kez kur, her push'ta otomatik senkronize et.
Elle yazılmış bir next-intl kurulumun zaten varsa ne olur?
Agent önce onu okur.
i18n/request.ts varsa agent yapılandırmanı ezmez, onu benimser. messages/en.json zaten Pricing.heading içeriyorsa agent yeni anahtar üretmek yerine onu yeniden kullanır. Ad alanı kuralın Pricing.heading (PascalCase, iç içe) yerine pricing.heading (küçük harf, noktalı) ise agent ona uyar.
Agent'ın yapmayı reddettiği tek şey mevcut bir dil dosyasının üzerine sessizce yazmaktır. Anahtar çakışması olursa durur ve sorar. Bu davranış npx skills add globalize-now/globalize-skills ile kurulan Skill kurallarına gömülüdür, senin ayarlaman gerekmez.
globalize.now bunu halleder. Next.js deponu bağla, dönüştürme uygulamada bir kez çalışsın; editöründe sonrasında yapılacak işi npx skills add globalize-now/globalize-skills Skill'leri karşılar. Nasıl çalıştığını globalize.now üzerinde gör.
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