Intlayer प्रारंभ करें (Initialize Intlayer)

npx intlayer init

init कमांड Intlayer पैकेज इंस्टॉल करता है और आपका फ़्रेमवर्क सेट करता है (कॉन्फ़िगरेशन फ़ाइल, TypeScript, बंडलर प्लगइन, middleware/proxy, प्रोवाइडर)। Intlayer शुरू करने का यही अनुशंसित तरीका है।

बाकी सब कुछ (CI वर्कफ़्लो, AI स्किल्स, MCP सर्वर, एडिटर टूल, lint नियम, CMS, इन्फ्रास्ट्रक्चर) वैकल्पिक है: इसे --interactive चेकलिस्ट से चुनें, या इसका समर्पित सब-कमांड चलाएँ (नीचे देखें)।

उपनाम (Aliases):

• npx intlayer init

तर्क (Arguments):

• --project-root [projectRoot] - वैकल्पिक। प्रोजेक्ट रूट निर्देशिका निर्दिष्ट करें। यदि प्रदान नहीं किया जाता है, तो कमांड वर्तमान कार्य निर्देशिका से शुरू होकर प्रोजेक्ट रूट की खोज करेगा।
• --no-gitignore - वैकल्पिक। .gitignore फ़ाइल के स्वचालित अपडेट को छोड़ देता है। यदि यह फ़्लैग सेट है, तो .intlayer को .gitignore में नहीं जोड़ा जाएगा।
• --no-framework-setup - वैकल्पिक। प्रोजेक्ट फ़ाइलों को छुए बिना केवल पैकेज इंस्टॉल करता है।
• --routing <routing> - वैकल्पिक। लोकेल रूटिंग: prefix-no-default (डिफ़ॉल्ट), prefix-all, no-prefix, search-params या none।
• -i, --interactive - वैकल्पिक। डिफ़ॉल्ट सेट के बजाय एक चेकलिस्ट (पैकेज, CI, स्किल्स, MCP, VS Code, LSP, lint, CMS, इन्फ्रास्ट्रक्चर, …) से सेटअप चरण चुनें। टर्मिनल ज़रूरी है: टर्मिनल न होने पर (AI एजेंट, CI) कमांड विफल होता है और उसकी जगह चलाने के लिए सब-कमांड की सूची दिखाता है।
• --no-github-actions - वैकल्पिक। --interactive के साथ, चुने जाने पर भी GitHub Actions वर्कफ़्लो कभी नहीं बनाता।

यह क्या करता है:

init कमांड निम्नलिखित सेटअप कार्य करता है:

1. प्रोजेक्ट संरचना सत्यापित करना - सुनिश्चित करता है कि आप package.json फ़ाइल वाली वैध प्रोजेक्ट निर्देशिका में हैं।
2. पैकेज इंस्टॉल करता है - आपके स्टैक के लिए ग़ायब Intlayer पैकेज (जैसे react-intlayer, vite-intlayer) इंस्टॉल करता है और पुराने पैकेज अपग्रेड करता है।
3. .gitignore अपडेट करना - जनरेट की गई फ़ाइलों को संस्करण नियंत्रण से बाहर करने के लिए आपकी .gitignore फ़ाइल में .intlayer जोड़ता है (--no-gitignore के साथ छोड़ा जा सकता है)।
4. TypeScript कॉन्फ़िगर करना - Intlayer प्रकार परिभाषाओं (.intlayer/**/*.ts) को शामिल करने के लिए किसी भी tsconfig.json फ़ाइलों को अपडेट करता है।
5. कॉन्फ़िगरेशन फ़ाइल बनाना - डिफ़ॉल्ट सेटिंग्स के साथ intlayer.config.ts (TypeScript प्रोजेक्ट्स के लिए) या intlayer.config.mjs (JavaScript प्रोजेक्ट्स के लिए) जनरेट करता है।
6. बंडलर / फ़्रेमवर्क कॉन्फ़िग अपडेट करता है - आपके Vite, Next.js, Nuxt, Astro, … कॉन्फ़िगरेशन में Intlayer प्लगइन जोड़ता है, और फ़्रेमवर्क के समर्थन करने पर middleware/proxy और प्रोवाइडर बनाता है।

एक-एक चरण सेट करें

--interactive चेकलिस्ट के हर चरण का अपना सब-कमांड है। जब मान फ़्लैग के रूप में दिए जाते हैं तो ये कोई सवाल नहीं पूछते, इसलिए इन्हें AI एजेंट या CI जॉब से सुरक्षित रूप से चलाया जा सकता है।

AI एजेंट या CI जॉब से

AI एजेंट के शेल में टर्मिनल नहीं होता, इसलिए किसी सवाल का जवाब नहीं दिया जा सकता। डिफ़ॉल्ट कमांड चलाएँ, फिर अपनी ज़रूरत के सब-कमांड:

npx intlayer init
npx intlayer init skills --platform Claude
npx intlayer init mcp --platform Claude --transport stdio

टर्मिनल के बिना:

• init skills आपके स्टैक से मेल खाने वाली स्किल्स इंस्टॉल करता है, जब तक --skills सेट न हो (जैसे --skills Usage Content React)।
• init skills और init mcp पहचाने गए AI प्लेटफ़ॉर्म (Claude Code, Cursor, VS Code, Windsurf, …) का उपयोग करते हैं, जब तक --platform सेट न हो, और कोई प्लेटफ़ॉर्म न मिलने पर प्लेटफ़ॉर्म की सूची के साथ विफल होते हैं।
• init mcp stdio ट्रांसपोर्ट का उपयोग करता है, जब तक --transport सेट न हो।
• init infra के लिए --mode ज़रूरी है, और init extension केवल स्टोर लिंक दिखाता है, जब तक --browser सेट न हो।

MCP सर्वर हमेशा प्रोजेक्ट के अंदर कॉन्फ़िगर होता है (Claude Code के लिए .mcp.json में)।

उदाहरण:

बुनियादी प्रारंभ:

npx intlayer init

यह वर्तमान निर्देशिका में Intlayer को प्रारंभ करता है, प्रोजेक्ट रूट को स्वचालित रूप से खोजता है।

कस्टम प्रोजेक्ट रूट के साथ प्रारंभ:

npx intlayer init --project-root ./my-project

यह निर्दिष्ट निर्देशिका में Intlayer को प्रारंभ करता है।

.gitignore अपडेट किए बिना प्रारंभ:

npx intlayer init --no-gitignore

यह सभी कॉन्फ़िगरेशन फ़ाइलें सेट करेगा लेकिन आपके .gitignore को संशोधित नहीं करेगा।

इन्फ्रास्ट्रक्चर सेट करें (डेस्कटॉप ऐप या सेल्फ-होस्टिंग):

npx intlayer init infra

होस्ट किए गए इंस्टॉलर (https://intlayer.org/install.sh, या Windows पर install.ps1) को डाउनलोड और रन करता है, जो पूछता है कि आप Intlayer को कैसे चलाना चाहते हैं:

• डेस्कटॉप ऐप - Intlayer Cloud से जुड़े आपके कंप्यूटर पर नेटिव डैशबोर्ड इंस्टॉल करता है।
• ऑल-इन-वन Docker - एक ही कंटेनर में डैशबोर्ड + API + MongoDB + Redis + MinIO।
• Docker Compose - स्केलेबल सेल्फ-होस्टिंग के लिए प्रति सेवा एक कंटेनर।

--mode के साथ मेनू छोड़ें:

npx intlayer init infra --mode compose

वही चरण npx intlayer init --interactive द्वारा भी पेश किया जाता है। इंस्टॉलर सेटिंग्स के लिए init infra संदर्भ देखें, और प्रत्येक मोड क्या सेट करता है इसके लिए सेल्फ-होस्टिंग गाइड देखें।

आउटपुट उदाहरण:

npx intlayer init
Checking Intlayer configuration...
✓ Added .intlayer to .gitignore
✓ Updated tsconfig.json to include intlayer types
✓ Created intlayer.config.ts
✓ Injected import into vite.config.ts
✓ Intlayer init setup complete.

टिप्पणियाँ:

• कमांड इडेम्पोटेंट (idempotent) है-आप इसे सुरक्षित रूप से कई बार चला सकते हैं। पहले से कॉन्फ़िगर किए गए चरणों को छोड़ दिया जाएगा।
• यदि कॉन्फ़िगरेशन फ़ाइल पहले से मौजूद है, तो इसे अधिलेखित (overwrite) नहीं किया जाएगा।
• बिना include सरणी वाले TypeScript कॉन्फ़िगरेशन (उदा: संदर्भों के साथ समाधान-शैली कॉन्फ़िगरेशन) छोड़ दिए जाते हैं।
• यदि प्रोजेक्ट रूट में package.json नहीं मिलता है, तो कमांड त्रुटि के साथ बंद हो जाएगा।