TypeScript के साथ मोनोरिपॉजिटरी: व्यवहार में कोड का संगठन

TypeScript के साथ मोनोरिपॉजिटरी: व्यवहार में कोड का संगठन

आधुनिक फ्रंटएंड और बैकएंड डेवलपमेंट तेजी से कई परस्पर जुड़ी परियोजनाओं के प्रबंधन की समस्या का सामना कर रही है। जब पैकेज, लाइब्रेरी और एप्लिकेशन की संख्या बढ़ती है, तो अलग-अलग रिपॉजिटरी (multi-repo) वाला पारंपरिक दृष्टिकोण विकास को धीमा करना शुरू कर देता है: कोड का दोहराव, संस्करणों को सिंक करने में कठिनाइयाँ और लंबी समीक्षा चक्र। समाधान मोनोरिपॉजिटरी (monorepo) है, विशेष रूप से TypeScript के साथ। इस लेख में, हम TypeScript पर मोनोरिपॉजिटरी में कोड को व्यवस्थित करने के व्यावहारिक पहलुओं पर चर्चा करेंगे: उपकरणों के चयन से लेकर संरचना और सेटअप के विशिष्ट उदाहरणों तक।

मोनोरिपॉजिटरी क्या है और TypeScript प्रोजेक्ट्स को इसकी आवश्यकता क्यों है?

मोनोरिपॉजिटरी एक दृष्टिकोण है जिसमें कई प्रोजेक्ट्स (पैकेज, लाइब्रेरी, सेवाएँ) का कोड एक ही Git रिपॉजिटरी में संग्रहीत किया जाता है। TypeScript के लिए यह विशेष रूप से प्रासंगिक है, क्योंकि सख्त टाइपिंग वाली भाषा सिस्टम के विभिन्न भागों के बीच सामान्य प्रकारों और इंटरफेस को आसानी से पुन: उपयोग करने की अनुमति देती है।

TypeScript के साथ मोनोरिपॉजिटरी के मुख्य लाभ:

• निर्भरता का एकीकृत संस्करण — उस स्थिति को समाप्त करता है जहाँ विभिन्न प्रोजेक्ट एक ही लाइब्रेरी के विभिन्न संस्करणों का उपयोग करते हैं।
• कोड का पुन: उपयोग — सामान्य प्रकार, उपयोगिताएँ और कॉन्फ़िगरेशन सभी पैकेजों के लिए आसानी से उपलब्ध हैं।
• परमाणु कमिट — कई पैकेजों को प्रभावित करने वाले परिवर्तनों को एक साथ कमिट किया जा सकता है।
• CI/CD का सरलीकरण — सभी भागों के निर्माण और परीक्षण के लिए एक ही पाइपलाइन।

हालाँकि, मोनोरिपॉजिटरी को कोड संगठन में अनुशासन की आवश्यकता होती है। उचित संरचना के बिना, यह एक "डंपिंग ग्राउंड" में बदल जाता है। TypeScript सख्त टाइपिंग और मॉड्यूलर सिस्टम के कारण व्यवस्था लाने में मदद करता है।

मोनोरिपॉजिटरी प्रबंधन के लिए उपकरण का चयन

बाजार में मोनोरिपॉजिटरी के साथ काम करने के लिए कई लोकप्रिय उपकरण हैं। TypeScript के लिए दो सबसे सामान्य पर विचार करें: Nx और Turborepo।

Nx — मोनोरिपॉजिटरी, कोड जनरेशन और उन्नत कैशिंग के समर्थन वाला एक शक्तिशाली सिस्टम। यह कई पैकेजों वाली बड़ी परियोजनाओं के लिए उपयुक्त है।

Turborepo — Vercel का एक हल्का और तेज़ उपकरण, जो सादगी पर केंद्रित है। यह मध्यम आकार की परियोजनाओं और टीमों के लिए आदर्श है जो न्यूनतम कॉन्फ़िगरेशन चाहते हैं।

Turborepo के साथ बुनियादी सेटअप का उदाहरण:

// turbo.json{  "$schema": "https://turbo.build/schema.json",  "pipeline": {    "build": {      "dependsOn": ["^build"],      "outputs": ["dist/**"]    },    "test": {      "dependsOn": ["build"]    },    "lint": {}  }}

TypeScript के लिए, project references के समर्थन के साथ tsconfig.json सेट करना अनिवार्य है। यह कंपाइलर को पैकेजों के बीच निर्भरता को समझने की अनुमति देता है।

// tsconfig.base.json{  "compilerOptions": {    "target": "ES2020",    "module": "ESNext",    "moduleResolution": "bundler",    "strict": true,    "composite": true,    "declaration": true,    "declarationMap": true,    "sourceMap": true,    "outDir": "./dist",    "rootDir": "./src"  }}

मोनोरिपॉजिटरी संरचना का व्यावहारिक संगठन

मुख्य सिद्धांत कोड को तार्किक परतों में विभाजित करना है। वेब एप्लिकेशन और बैकएंड के साथ TypeScript मोनोरिपॉजिटरी के लिए एक विशिष्ट संरचना पर विचार करें:

monorepo/├── apps/│   ├── web/          # फ्रंटएंड एप्लिकेशन (React, Vue, आदि)│   └── api/          # बैकएंड सेवा (Express, NestJS)├── packages/│   ├── shared/       # सामान्य प्रकार और इंटरफेस│   ├── utils/        # उपयोगिता फ़ंक्शन│   ├── ui/           # UI घटक (यदि उपयोग किया जाता है)│   └── config/       # सामान्य कॉन्फ़िगरेशन (eslint, tsconfig)├── tools/            # CI/CD के लिए स्क्रिप्ट और उपकरण├── turbo.json├── package.json└── tsconfig.