CLI कैसे सेट अप करूँ और अपना प्रोजेक्ट कैसे स्कैन करूँ?

Better i18n CLI एक डेवलपर टूल है जो ट्रांसलेशन keys के लिए आपके कोडबेस को स्कैन करता है और उन्हें डैशबोर्ड से सिंक में रखता है।

इंस्टॉलेशन

# bun के साथ (अनुशंसित)
bun add -g @better-i18n/cli

# npm के साथ
npm install -g @better-i18n/cli

# pnpm के साथ
pnpm add -g @better-i18n/cli

इंस्टॉलेशन सत्यापित करें:

better-i18n --version

प्रमाणीकरण

अपने Better i18n अकाउंट से लॉग इन करें:

better-i18n login

यह प्रमाणीकरण के लिए एक ब्राउज़र विंडो खोलता है। आपके credentials स्थानीय रूप से और सुरक्षित रूप से संग्रहीत होते हैं।

प्रोजेक्ट कॉन्फ़िगरेशन

अपनी प्रोजेक्ट root में एक कॉन्फ़िग फ़ाइल बनाएँ:

better-i18n init

यह better-i18n.config.ts जेनरेट करता है:

import { defineConfig } from '@better-i18n/cli';

export default defineConfig({
  project: 'acme/dashboard',
  sourceLocale: 'en',
  // ट्रांसलेशन keys के लिए स्कैन करने वाली डायरेक्टरी
  include: ['src/**/*.{ts,tsx,js,jsx}'],
  // बाहर करने वाली डायरेक्टरी
  exclude: ['node_modules', 'dist', '.next'],
});

अपना कोडबेस स्कैन करें

सभी ट्रांसलेशन keys खोजने के लिए स्कैनर चलाएँ:

better-i18n scan

स्कैनर पहचानता है:

• t('key') — स्टैंडर्ड ट्रांसलेशन फ़ंक्शन कॉल
• t('namespace:key') — नेमस्पेस्ड keys
• useTranslations('namespace') — नेमस्पेस इम्पोर्ट
• टेम्पलेट literals: t(`key.${dynamic}`) (डायनेमिक key के रूप में रिपोर्ट)

स्कैन आउटपुट

Scanning src/**/*.{ts,tsx}...

 Found 142 translation keys in 38 files
   • common: 24 keys
   • auth: 18 keys
   • dashboard: 45 keys
   • settings: 32 keys
   • (default): 23 keys

 ⚠ 3 dynamic keys detected (review manually)

डैशबोर्ड से सिंक करें

स्कैन की गई keys को Better i18n पर पुश करें:

better-i18n sync

यह:

1. स्थानीय keys की डैशबोर्ड से तुलना करता है
2. नई keys बनाता है जो अभी तक मौजूद नहीं हैं
3. डैशबोर्ड में हैं लेकिन कोड में नहीं उन keys की रिपोर्ट करता है (संभावित dead keys)

सिंक स्थिति जाँचें

सत्यापित करें कि सब कुछ सिंक में है:

better-i18n check

✓ 142 keys in sync
⚠ 3 keys in code but not in dashboard (run sync to fix)
⚠ 5 keys in dashboard but not in code (potential dead keys)

Doctor चलाएँ

सामान्य समस्याओं का निदान करें:

better-i18n doctor

यह आपकी कॉन्फ़िगरेशन, प्रमाणीकरण, API कनेक्टिविटी और प्रोजेक्ट सेटअप जाँचता है।

CI/CD एकीकरण

मर्ज से पहले missing translations पकड़ने के लिए अपने CI pipeline में better-i18n check जोड़ें:

# GitHub Actions उदाहरण
- name: Check translations
  run: better-i18n check --strict

--strict flag किसी भी key के सिंक न होने पर code 1 के साथ exit करता है।

अगले कदम

• Next.js SDK सेट अप करें
• अपनी पहली ट्रांसलेशन keys जोड़ें