İlk projemi nasıl oluştururum?

Proje, tüm çevirilerinizin kapsayıcısıdır. Her uygulama veya web sitesi kendi projesini alır.

1. Adım: Kaydolun veya oturum açın

app.better-i18n.com adresine gidin ve hesabınızla oturum açın. Hesabınız yoksa ücretsiz kaydolabilirsiniz.

2. Adım: Yeni bir proje oluşturun

1. Panodan **"Yeni Proje"**ye tıklayın
2. Bir proje adı girin (örn. "Web Sitem")
3. Kaynak dili seçin — bu, kodunuzu yazdığınız dildir (genellikle İngilizce)
4. Hedef dilleri ekleyin — çeviri yapmak istediğiniz diller
5. Oluştur'a tıklayın

3. Adım: Proje tanımlayıcınızı not edin

Her projenin org/project biçiminde benzersiz bir tanımlayıcısı vardır; örneğin acme/dashboard. Bunu proje ayarlarınızda bulabilirsiniz. Şunlar için ihtiyaç duyacaksınız:

• SDK yapılandırması (project: "acme/dashboard")
• CLI kurulumu (better-i18n.config.ts)
• API çağrıları

4. Adım: API anahtarınızı alın

Ayarlar → API Anahtarları bölümüne gidin ve yeni bir anahtar oluşturun. İki tür anahtara ihtiyacınız olacak:

Anahtar türü	Amaç	Nerede kullanılır
Genel anahtar	Salt okunur, CDN erişimi	Frontend SDK'lar, istemci tarafı kod
Gizli anahtar	Tam erişim	CLI, CI/CD, sunucu tarafı

Güvenlik ipucu: Gizli anahtarınızı asla istemci tarafı kodda ifşa etmeyin. Genel anahtarlar tarayıcılar için güvenlidir.

5. Adım: SDK'nızı yapılandırın

Proje kimliğinizi ve genel anahtarınızı framework SDK'nıza ekleyin:

// Örnek: Next.js
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

# Örnek: .env dosyası
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=pk_...

Sırada ne var?

• İlk çeviri anahtarlarınızı ekleyin
• CLI'yi kurun
• Çevirileri yayınlayın