SaaS Ürününüzü Her Dilde Sunun
SaaS ürününüzün kullanıcılarınızın dilini konuşması gerekiyor — kelimenin tam anlamıyla. UI dizeleri, onboarding akışları, e-posta şablonları, yardım belgeleri, hata mesajları. Her metin parçası çeviri gerektirir ve ürününüz geliştikçe hepsi senkronize kalmalıdır.
better-i18n, SaaS ekiplerine geliştirici öncelikli bir lokalizasyon iş akışı sunar: kod tabanınız için CLI araçları, iş akışınız için GitHub entegrasyonu, kullanıcılarınız için CDN dağıtımı ve frontend'iniz için framework SDK'ları.
CLI: Kod Tabanınızı Tarayın, Çevirilerinizi Senkronize Edin
@better-i18n/cli geliştirici iş akışının temelidir:
scan— Kod tabanınızdaki sabit kodlanmış dizeleri tespit etmek için AST analizi kullanır. Yerel olarak veya CI'da çalıştırarak, dağıtım öncesinde çevrilmemiş dizeleri yakalayın.sync— Yerel çeviri anahtarlarınızı bulutla karşılaştırır ve farklılıkları uzlaştırır. Yerel dosyalarınızı ve platformu senkronize tutar.
Her iki komut da CI entegrasyonu için flag'leri destekler:
--cietkileşimsiz CI/CD ortamları için--stagedyalnızca staged dosyaları kontrol etmek için (pre-commit hook'ları için ideal)--format jsonmakine tarafından okunabilir çıktı için
Bu, CI pipeline'ınıza better-i18n scan --ci ekleyerek sabit kodlanmış dizeler getiren build'leri başarısız kılabileceğiniz anlamına gelir.
GitHub Entegrasyonu
Çeviriler hazır olduğunda, better-i18n çevrilmiş JSON dosyalarıyla pull request oluşturur. Ekibiniz diğer kod değişiklikleri gibi çevirileri inceler ve birleştirir:
- PR'lar güncellenmiş JSON çeviri dosyalarını içerir
- Downstream otomasyon için yayınlama olaylarında webhook'lar tetiklenir
- Çeviriler kodunuzla birlikte sürüm kontrolünde kalır
Bu, çevirileri mevcut inceleme iş akışınızda tutar — kontrol edecek veya onaylayacak ayrı bir araç gerekmez.
CDN: Deploy Olmadan Hızlı Dağıtım
Yayınlanan çeviriler Cloudflare'ın edge ağından cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json adresinde sunulur. Bu size şunları sağlar:
- En yakın edge düğümünden küresel düşük gecikmeli dağıtım
- Yeniden deploy gerekmez — bir çeviri düzeltmesi yayınlayın ve anında canlıdır
- Namespace düzeyinde ayrıntı — yalnızca mevcut görünümünüzün ihtiyaç duyduğu çevirileri yükleyin
SaaS ürünleri için bu, release döngünüzden geçmeden yanlış bir çeviriyi düzeltebileceğiniz veya yeni bir dil ekleyebileceğiniz anlamına gelir.
Framework SDK'ları
Birinci taraf SDK'lar frontend'inizle entegrasyonu yönetir:
@better-i18n/next— Server ve client component desteğiyle Next.js@better-i18n/use-intl— Vite ve TanStack Router uygulamaları@better-i18n/expo— Mobil uygulamalar için çevrimdışı önbellek ile Expo ve React Native
SDK'lar CDN'den çevirileri çeker, böylece uygulamanız her zaman en son yayınlanan içeriği sunar.
MCP: Editörünüzde Yapay Zeka Destekli Çeviri
MCP entegrasyonu yapay zeka kodlama asistanlarıyla çalışan 2 sunucu ve 28 araç sağlar — Claude, Cursor, Windsurf ve Zed. Hem uzak hem de yerel sunucu seçenekleri mevcuttur.
MCP ile geliştiricileriniz:
- Editörlerinden ayrılmadan çeviri anahtarları oluşturabilir ve güncelleyebilir
- Yeni anahtarlar için yapay zeka çevirilerini tetikleyebilir
- Çeviri kapsamını satır içinde inceleyebilir
Bu, bağlam değiştirmeyi azaltır ve çeviri yönetimini geliştiricinin doğal iş akışında tutar.
Sözlük ile Yapay Zeka Çevirisi
better-i18n'in yapay zeka çevirisi ürününüzün terminolojisine saygı gösteren çeviriler üretir:
- Sözlükte ürün adlarını, özellik adlarını ve teknik terimleri tanımlayın
- Kontrol panelinden kalite ihtiyaçlarınıza uygun yapay zeka modelini seçin
- Sözlük terimleri tüm yapay zeka tarafından üretilen çevirilerde uygulanır
Belirli terminolojiye sahip SaaS ürünleri (plan adları, özellik adları, teknik kavramlar) için bu, tüm dillerde tutarlılık sağlar.
Namespace'lerle Düzenleyin
Çevirilerinizi ürününüze uygun şekilde yapılandırın:
ui/commonpaylaşılan UI bileşenleri içinui/dashboarddashboard'a özgü dizeler içinemails/transactionale-posta şablonları içindocs/helpyardım merkezi içeriği içinerrorshata mesajları için
Her namespace bağımsız olarak yüklenir, böylece dashboard sayfanızın yardım merkezi çevirilerini indirmesi gerekmez.
Dashboard ve RBAC
Dashboard şunları sağlar:
- Tüm diller ve namespace'ler genelinde kapsam takibi
- Arama ve toplu işlemlerle anahtar yönetimi
- Her değişiklik için denetim günlükleri
- GitHub OAuth ile proje bazında rollerle RBAC
Ürün ekibinize kapsam kontrolü için okuma erişimi, geliştiricilerinize anahtar yönetimi için editör erişimi verin ve admin erişimini ekip liderlerine sınırlayın.
Sunmadıklarımız
Sınırlamalar hakkında dürüst olarak:
- Yalnızca JSON — YAML, PO, ARB, XLIFF veya diğer çeviri formatlarını desteklemiyoruz. Stack'iniz JSON dışı formatlar gerektiriyorsa, dönüştürmeniz gerekir.
- Yalnızca GitHub — Şu anda GitLab, Bitbucket veya diğer Git sağlayıcı entegrasyonları yoktur.
- Çeviri Belleği yok — Tutarlılık sözlük uygulaması ve yapay zeka çevirisinden gelir, TM veritabanından değil.
- Bağlam içi düzenleme yok — Uygulamanız için görsel önizleme veya canlı düzenleme katmanı yoktur.
- Bağlam ekran görüntüleri yok — Anahtarlar görsel bağlam yerine ad ve namespace ile yönetilir.
- OTA güncelleme sistemi yok — CDN talep üzerine çevirileri sunar, ancak push tabanlı güncelleme mekanizması veya istemci tarafı önbellek geçersizleştirme yoktur.
better-i18n, kodda çalışan ekipler için inşa edilmiştir. CLI, GitHub entegrasyonu ve framework SDK'ları çekirdek iş akışıdır — dashboard geliştirici deneyimini tamamlar ama yerine geçmez.
Hemen Başlayın
SaaS ekibiniz mevcut geliştirme sürecinize uyan bir lokalizasyon iş akışı istiyorsa — CI'da CLI, inceleme için PR'lar, dağıtım için CDN — better-i18n bunun için inşa edilmiştir.
Hesabınızı oluşturun ve dakikalar içinde ilk scan'inizi çalıştırın.