better-i18n.com
डेवलपर दस्तावेज़सहायता केंद्ररिलीज़ नोट्स

मैं अपना पहला प्रोजेक्ट कैसे बनाऊँ?

Aug 21, 2026 को अपडेट किया गयाAli Osman Delişmen

एक प्रोजेक्ट किसी एक ऐप या साइट की की-ज़, भाषाएँ और सेटिंग्स रखता है। इसे बनाने में एक मिनट लगता है; जो दो चीज़ें सही होनी चाहिए वे हैं स्रोत भाषा और यह कि आपकी कुंजी कहाँ रखी जाती है।

इसे बनाएँ

  1. app.better-i18n.com पर साइन इन करें
  2. New Project
  3. नाम दें — यही नाम प्रोजेक्ट का slug बनता है, इसलिए छोटा रखें
  4. स्रोत भाषा चुनें: वह भाषा जिसमें आपका कोड लिखा है
  5. जिन भाषाओं में अनुवाद चाहिए, उन्हें जोड़ें
  6. Create

अपना प्रोजेक्ट बनाएँ — नाम दर्ज करें और स्रोत भाषा चुनें

सोच-समझकर लेने लायक एकमात्र निर्णय स्रोत भाषा है। हर अनुवाद उसी से बनता है और हर की का मूल टेक्स्ट उसी में रहता है। आप इसे बाद में Settings → CDN से बदल सकते हैं, पर बाकी सब कुछ इसी के सापेक्ष तय होता है — इसलिए उसी भाषा से शुरू करें जिसमें आप वास्तव में लिखते हैं।

लक्ष्य भाषाएँ बदलना आसान है — Languages पेज से जब चाहें जोड़ें या हटाएँ।

आपका प्रोजेक्ट पहचानकर्ता

हर प्रोजेक्ट org/project के रूप में संबोधित होता है — acme/dashboard। आप इसे SDK कॉन्फ़िग, CLI कॉन्फ़िग और हर API कॉल में लिखेंगे।

API कुंजी बनाएँ #

Settings → API Keys → Create Key.

Create API Key — अपनी कुंजी को नाम दें और Create Key पर क्लिक करें

ऐसा नाम दें जो छह महीने बाद भी पहचान में आए ("CI", "local dev"), और एक अवधि चुनें: 3 महीने, 6 महीने, 1 साल, या कभी नहीं। सूची दिखाती है कि हर कुंजी कितनी बची है, और समाप्ति में एक महीना रह जाने पर चेतावनी देती है — CI में चुपचाप मर जाने वाली कुंजी एक खराब दोपहर बन जाती है।

कुंजी केवल एक बार दिखती है। दिखते ही कॉपी कर लें; इसे दोबारा पढ़ा नहीं जा सकता, केवल बदला जा सकता है।

कौन-सी कुंजी कहाँ

पढ़नालिखनाब्राउज़र में सुरक्षित
CDN / डिलीवरी कुंजी✓—✓
API कुंजी✓✓नहीं

CDN कुंजी केवल प्रकाशित अनुवाद लाती है, जो वैसे भी सार्वजनिक डेटा है और आपके आगंतुक उसे डाउनलोड करते ही हैं। API कुंजी आपका प्रोजेक्ट बदल सकती है, इसलिए उसकी जगह सर्वर एनवायरनमेंट वेरिएबल या CI सीक्रेट है — कभी क्लाइंट-साइड कोड में नहीं, और कभी कमिट की गई फ़ाइल में नहीं।

अगर कोई गुप्त कुंजी सार्वजनिक जगह पहुँच जाए: API Keys पेज से उसे रद्द करें और नई बनाएँ। रद्द करना तुरंत प्रभावी होता है।

अपने ऐप को इससे जोड़ें

Bash
# .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=...
TypeScript
// सटीक कॉल आपके फ़्रेमवर्क पर निर्भर करता है — SDK गाइड देखें
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

आगे क्या